CMS Skill 创建工具

当前版本: v1.21.3

身份声明：cms-create-skill 现在只负责两件事：发现已有 Skill、按协议创建新 Skill。发布、更新、下架统一转交 cms-push-skill；问题反馈统一转交 cms-report-issue。

两段能力

命名区分

• - 发现 Skill：先看平台已有的 Skill，避免重复创建。
• 创建 Skill：按协议从零生成内部 Skill 包。

协作边界

• - 如果用户要发布到我们内部平台、更新、下架、同步 Skill，不在本 Skill 内执行，统一转交 cms-push-skill。
• 如果用户要提交问题、查看问题列表、关闭问题，不在本 Skill 内执行，统一转交 cms-report-issue。
• 本 Skill 只负责把 Skill 创建好，并明确下一步应该交给哪个依赖 Skill。

内部 / 外部定义

内部 Skill

• - 定义：按照 docs/ 下编号协议文档生成的 Skill 包。
• 典型动作：创建、结构校对、交付给发布工具。
• 典型表达：

外部 Skill

• - 定义：不是按我方协议原生生成、但已存在于 ClawHub 的 Skill。
• 典型动作：不由本 Skill 创建；如果要同步到平台，转交 cms-push-skill。
• 典型表达：

能力宪章

核心原则

1. 1. 禁止问用户 token、登录、鉴权细节；鉴权统一依赖 cms-auth-skills。
2. 只有声明需要鉴权的动作才获取 access-token。
3. 5 步创建流程必须按顺序执行，不跳步。
4. 每一步都要和用户确认，不自作主张。
5. 生成的 Skill 必须严格遵循 docs/ 下编号协议文档。
6. 目标 Skill 的 SKILL.md YAML 头必须声明 dependencies: - cms-auth-skills。
7. 目标 Skill 不再生成本地 auth/common，统一依赖 cms-auth-skills。
8. 当用户进入发布链路时，只声明下一步转交 cms-push-skill，不在本 Skill 中继续维护重复发布实现。
9. 当用户进入问题反馈链路时，只声明下一步转交 cms-report-issue，不在本 Skill 中继续维护重复问题实现。
10. 本 Skill 自身只维护 Markdown 说明和创建相关 Python 脚本，不再维护旧接口文档目录。

鉴权规则

• - 需要鉴权的动作：无
• 不需要鉴权的动作：get_skills.py、5 步创建流程、INLINECODE16
• 鉴权准备方式：统一通过 cms-auth-skills 获取 INLINECODE18

授权依赖

• - 创建阶段默认不做写操作，但生成的目标 Skill 仍需依赖 cms-auth-skills。
• 当后续进入发布或问题关闭阶段，由对应依赖 Skill 自己处理鉴权动作。

能力概览

发现 Skill

创建 Skill

协作依赖

意图路由表

发现 Skill

创建 Skill

发布 / 问题协作

工作流 A：发现 Skill

发现是起点，先看看平台上有什么，再决定是否创建新的。

CODEBLOCK0

工作流 B：创建 Skill（5 步流程）

完整操作手册：docs/007_XGJK_SKILL_CREATION_WORKFLOW.md
创建规范：docs/ 下编号协议文档（核心总则见 001，详细规则见 002-008）
验证清单：INLINECODE57

协议文档编号说明

INLINECODE58 下的协议文档统一使用三位编号，编号既是排序规则，也是推荐阅读顺序：

1. 1. INLINECODE59
2. INLINECODE60
3. INLINECODE61
4. INLINECODE62
5. INLINECODE63
6. INLINECODE64
7. INLINECODE65
8. INLINECODE66

命名规则统一为：INLINECODE67

CODEBLOCK1

工作流 C：发布协作

这里说的“发布到我们内部平台”，就是把 Skill 注册到当前技能管理平台。

当创建完成后，如果用户明确要发布或同步，不在本 Skill 内继续执行，直接转交 cms-push-skill：

CODEBLOCK2

然后按场景进入对应命令：

CODEBLOCK3

如果你当前就在 cms-create-skill 里，不要继续找本 Skill 自己的发布脚本，下一步直接切到 cms-push-skill。

工作流 D：问题反馈协作

如果用户要提交问题或处理问题，统一转交 cms-report-issue：

CODEBLOCK4

然后按场景进入对应命令：

CODEBLOCK5

如果你当前就在 cms-create-skill 里，不要继续找本 Skill 自己的问题脚本，下一步直接切到 cms-report-issue。

约束

1. 1. 5 步创建流程必须完整执行。
2. 每一步都要多轮确认。
3. 生成结果必须严格遵循协议文档。
4. 所有说明统一写在 Markdown 文档里。
5. 发布和问题反馈只做依赖声明，不在本 Skill 内重复维护实现。

能力树

CODEBLOCK6

备注

• - 平台“规范协议”页中，“创建 Skills 的规范”分组以 README.md 作为索引；cms-create-skill/docs/ 保留编号协议文档本体。
• 发布能力统一收敛到 cms-push-skill，问题反馈能力统一收敛到 cms-report-issue。
• 本 Skill 自身的说明目录已经统一为 docs/ + references/ + scripts/。