SKILL 协议(TFRobotServer v1)
TFRobotServer 的 SKILL 协议参考 Anthropic Agent Skills 开放标准 与 Claude Code Skills 文档 设计,并针对多 Pod K8s 部署、Sandbox 沙箱执行(CubeSandbox 主 / E2B 备)、密钥托管等差异进行受控扩展。
对应 Epic:TFRS-179。
权威规范
| 文档 | 范围 |
|---|---|
| A5-protocol-v1.md ⭐ | SKILL 内容契约(frontmatter / 目录 / runtime / 占位符 / skills 工具 / 安全模型)—— Module A/B/C 实施基准 |
| D-marketplace-v1.md ⭐ | Marketplace Git 分发标准(与 Claude Code Plugin Marketplaces 兼容)—— marketplace.json / plugin.json JSON Schema、source 类型枚举、Curator 模式 |
新读者从这两份开始。
实施参考(运行时行为,非规范契约)
| 文档 | 范围 |
|---|---|
| D-loading-behavior.md | Plugin manifest × strict mode 组合矩阵、缺失兜底、冲突检测 —— 基于 Claude Code 源码观察,给 Module D 实施工程师与 SKILL 作者参考 |
模块对应
| 模块 | Story | 范围 | 规范文档 |
|---|---|---|---|
| A — 文档格式协议 | TFRS-180 | SKILL.md 内容约定 | A5(含 A1\~A4 设计史) |
| B — 存储与同步 | TFRS-181 | Git ↔ MinIO ↔ Postgres / skills 工具 / 资源访问安全 |
A5 §10, §13.1 |
| C — 执行引擎 | TFRS-182 | Sandbox 双集群 / 模板 / 注入链路 | A5 §6, §9, §13.2 |
| D — Marketplace 分发 | TFRS-201 | Git 仓库分发标准(兼容 Claude Code)+ 多 plugin 多 SKILL 包装 | D-marketplace-v1.md |
子任务产出(设计史)
A1\~A4 是模块 A 协议规范的分步设计文档;如与 A5 表述冲突,以 A5 为准。保留作为决策 rationale 与设计史。
| 子任务 | Jira | 状态 | 产出 |
|---|---|---|---|
| A1 frontmatter 字段表 | TFRS-183 | 已完成 | A1-frontmatter-fields.md |
A2 .skillenv 环境变量声明 |
TFRS-184 | 已完成 | A2-skillenv.md |
A3 runtime 枚举(双引擎并存 / 引擎前缀语法 / BYO Dockerfile) |
TFRS-185 | 已完成 | A3-runtime-enum.md |
A4 目录结构与占位符(TFROBOT_* 私有命名空间,3 个占位符 + skills 工具) |
TFRS-186 | 已完成 | A4-directory-placeholders.md |
| A5 v1 规范整合 | TFRS-187 | 进行中 | A5-protocol-v1.md |
| D1 Marketplace 规范定稿 | (待创建) | 进行中 | D-marketplace-v1.md |