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"
  • "这个 Skill 按内部规范生成"

外部 Skill

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

能力宪章

核心原则

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 步创建流程、fetch_api_doc.py
• 鉴权准备方式：统一通过 cms-auth-skills 获取 access-token

授权依赖

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

能力概览

发现 Skill

创建 Skill

协作依赖

意图路由表

发现 Skill

创建 Skill

发布 / 问题协作

工作流 A：发现 Skill

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

# 浏览全部 Skill
python3 cms-create-skill/scripts/skill-management/get_skills.py

# 按关键词搜索
python3 cms-create-skill/scripts/skill-management/get_skills.py --search "机器人"

# 查看详情
python3 cms-create-skill/scripts/skill-management/get_skills.py --detail "im-robot"

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

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

协议文档编号说明

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

1. 001_XGJK_SKILL_PROTOCOL.md
2. 002_XGJK_SKILL_NAMING_AND_DESCRIPTION_SPEC.md
3. 003_XGJK_SKILL_STRUCTURE_SPEC.md
4. 004_XGJK_SKILL_INDEX_WRITING_SPEC.md
5. 005_XGJK_SKILL_PYTHON_SCRIPT_SPEC.md
6. 006_XGJK_SKILL_AUTH_AND_SECURITY_SPEC.md
7. 007_XGJK_SKILL_CREATION_WORKFLOW.md
8. 008_XGJK_SKILL_VALIDATION_CHECKLIST.md

命名规则统一为：NNN_XGJK_SKILL_\x3CTOPIC>.md

Step 1  意图理解与需求确认
Step 2  按协议逐步生成
Step 3  三轮反思检查
Step 4  最终确认
Step 5  完成输出总结

工作流 C：发布协作

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

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

# 先安装发布 Skill
npx clawhub@latest install cms-push-skill --force

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

# 内部 Skill：首次发布
python3 cms-push-skill/scripts/skill-management/publish_skill.py \
  ./im-robot --code im-robot --name "IM 机器人" --internal

# 内部 Skill：更新
python3 cms-push-skill/scripts/skill-management/publish_skill.py \
  ./im-robot --code im-robot --update --version 1.0.0 --internal

# 外部 Skill：同步到平台
python3 cms-push-skill/scripts/skill-management/publish_skill.py \
  ./im-robot --code im-robot --name "IM 机器人" --external

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

工作流 D：问题反馈协作

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

# 先安装问题反馈 Skill
npx clawhub@latest install cms-report-issue --force

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

# 提交问题
python3 cms-report-issue/scripts/issue_report/report_issue.py \
  --skill-code im-robot --version 1.0.0 --error "接口超时"

# 查看问题
python3 cms-report-issue/scripts/issue_report/list_issues.py --skill-code im-robot

# 标记为已解决
python3 cms-report-issue/scripts/issue_report/update_issue.py \
  --issue-id abc123 --status resolved --resolution "已修复重试逻辑"

# 关闭问题
python3 cms-report-issue/scripts/issue_report/update_issue.py \
  --issue-id abc123 --status closed

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

约束

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

能力树

cms-create-skill/
├── SKILL.md
├── docs/
│   ├── 001_XGJK_SKILL_PROTOCOL.md
│   ├── 002_XGJK_SKILL_NAMING_AND_DESCRIPTION_SPEC.md
│   ├── 003_XGJK_SKILL_STRUCTURE_SPEC.md
│   ├── 004_XGJK_SKILL_INDEX_WRITING_SPEC.md
│   ├── 005_XGJK_SKILL_PYTHON_SCRIPT_SPEC.md
│   ├── 006_XGJK_SKILL_AUTH_AND_SECURITY_SPEC.md
│   ├── 007_XGJK_SKILL_CREATION_WORKFLOW.md
│   └── 008_XGJK_SKILL_VALIDATION_CHECKLIST.md
├── references/
│   ├── issue-report/
│   │   └── README.md
│   └── skill-management/
│       └── README.md
└── scripts/
    ├── fetch_api_doc.py
    └── skill-management/
        ├── README.md
        └── get_skills.py

备注

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