跳转至

SKILL 协议(TFRobot)

TFRobot 的 SKILL 协议参考 Anthropic Agent Skills 开放标准 与 Claude Code Skills 文档 设计,聚焦 SKILL 内容契约 + LLM 与 SKILL 的交互。SKILL 的执行后端(沙箱 / 引擎 / 容器 / 凭证基础设施)归 Computer 侧 A2C-SMCP 协议表达,本协议不规定。

与 A2C-SMCP 的边界:SKILL 的编写规范(内容契约:frontmatter / 目录 / 占位符)以本站为权威——A2C-SMCP skill.md 明确反向引用本站作为内容契约权威;SKILL 的加载 / 使用 / 执行语义(staging 物化、name 合成、client:get_skill 沙箱、错误码)以 A2C-SMCP 为权威。写一个 SKILL 看本站;SKILL 怎么被 Computer 加载与执行看 A2C-SMCP。

权威规范

文档 范围
SKILL 协议 ⭐ SKILL 内容契约(frontmatter / 目录 / .skillenv / 占位符 / skills 工具 / 安全模型)+ Robot 多来源汇聚视角

新读者从这份开始。场景化流程见 使用指南(写一个 SKILL / 配 MCP / 发 Plugin / 三平台适配);SKILL 包的 Git 仓库分发约定(marketplace.json / plugin.json)属于姊妹章节 Marketplace 分发;SKILL 在 Computer 侧的执行后端则归 A2C-SMCP 实施方文档。

SKILL 归属与来源(一句话视角)

SKILL 归属于 Robot,切换 Robot 即切换 SKILL 集合。Robot 的 SKILL 集合由多来源汇聚:

  • 云端 Robot 配置——从云端对象存储的约定目录拉取(默认根 skills/,TFRobot 平台采用 MinIO 实现)。仅文档驱动,不执行脚本。
  • 已连接的 Computer——通过 A2C-SMCP 暴露本地可用 SKILL,可执行 scripts/。
  • Marketplace 仓库——Git 仓库分发,详见 Marketplace 规范。

不同来源带来不同的执行能力,但落到加载方手中的都是等价的 SKILL 文件夹——内容契约完全一致。

设计史(附录)

A1\~A4 是协议规范的分步设计文档;如与协议表述冲突,以协议为准。保留作为决策 rationale 与设计史,统一收录于 设计史索引。

子任务 状态 产出
A1 frontmatter 字段表 已完成 frontmatter 字段表
A2 .skillenv 环境变量声明 已完成 .skillenv 设计
A3 runtime 枚举 已完成(撤回) runtime 枚举
A4 目录结构与占位符 已完成 目录与占位符
A5 规范整合 已完成(定稿) SKILL 协议