cms-push-skill（cms 推送技巧）

当前版本: v1.6.1

cms-push-skill

只负责一件事：把已经准备好的 Skill 推送到平台。

这里说的“平台”，默认就是我们内部技能管理平台。

能力总览

路由

• 发布到我们内部平台：python3 cms-push-skill/scripts/skill-management/publish_skill.py ./my-skill --code my-skill --name "My Skill" --internal
• 更新我们内部平台上的 Skill：python3 cms-push-skill/scripts/skill-management/publish_skill.py ./my-skill --code my-skill --update --version 1.1.0 --internal
• 外部发布：python3 cms-push-skill/scripts/skill-management/publish_skill.py ./my-skill --code my-skill --name "My Skill" --external
• 注册：python3 cms-push-skill/scripts/skill-management/register_skill.py --code my-skill --name "My Skill"
• 更新：python3 cms-push-skill/scripts/skill-management/update_skill.py --code my-skill --name "New Name"
• 下架：python3 cms-push-skill/scripts/skill-management/delete_skill.py --id <skill-id> --reason "原因"

如果用户要提交问题、查看问题列表、关闭问题，统一转到 references/issue-report/README.md 对应的 cms-report-issue；如果用户还没创建 Skill，可先使用 cms-create-skill。

内部平台发布指引

如果你当前要把 Skill 发布到我们内部平台，最短路径是：

# 先准备鉴权
npx clawhub@latest install cms-auth-skills --force

# 首次发布到内部平台
python3 cms-push-skill/scripts/skill-management/publish_skill.py \
  ./my-skill --code my-skill --name "My Skill" --internal

# 更新内部平台上的 Skill
python3 cms-push-skill/scripts/skill-management/publish_skill.py \
  ./my-skill --code my-skill --update --version 1.1.0 --internal

如果你当前不是在做发布，而是遇到了线上问题、要反馈问题，不在本 Skill 内处理，直接转到 cms-report-issue。

问题反馈接力

如果你当前正在 cms-push-skill 里发布或更新 Skill，后来要反馈问题，最短路径是：

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

# 提交问题
python3 cms-report-issue/scripts/issue_report/report_issue.py \
  --skill-code my-skill --version 1.1.0 --error "..."

# 查看问题列表
python3 cms-report-issue/scripts/issue_report/list_issues.py --skill-code my-skill

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

同步选项

publish_skill.py 支持同步到 ClawHub 和 GitHub：

• --sync-clawhub：同步到 ClawHub。
• --sync-github：同步到 GitHub。
• --no-sync-clawhub：不同步到 ClawHub。
• --no-sync-github：不同步到 GitHub。

内部 Skill 默认两者都推，外部 Skill 不支持推送到 ClawHub。

规则

1. 所有推送动作统一使用 scripts/skill-management/ 下的脚本。
2. 推送前先通过 cms-auth-skills 准备好 access-token。
3. 内部 Skill 走七牛上传 + 平台注册。
4. 外部 Skill 跳过七牛上传，直接使用 ClawHub 下载地址。
5. 本 Skill 只维护推送链路；问题闭环统一交给 cms-report-issue。
6. 所有说明文档统一使用 Markdown，不维护旧接口文档目录。

能力树

cms-push-skill/
├── SKILL.md
├── references/
│   ├── issue-report/
│   │   └── README.md
│   └── skill-management/
│       └── README.md
└── scripts/
    └── skill-management/
        ├── delete_skill.py
        ├── pack_skill.py
        ├── publish_skill.py
        ├── register_skill.py
        ├── update_skill.py
        └── upload_to_qiniu.py