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 协议 |