Skip to content

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