当前版本: v1.6.1

cms-push-skill

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

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

能力总览

#	能力	脚本	需要登录
1	注册新 Skill	scripts/skill-management/registerskill.py	是
2

更新已有 Skill | scripts/skill-management/updateskill.py | 是 | | 3 | 下架 Skill | scripts/skill-management/delete_skill.py | 是 | | 4 | 一站式发布 | scripts/skill-management/publish_skill.py | 是 | | 5 | 打包 Skill 目录为 ZIP | scripts/skill-management/pack_skill.py | 否 | | 6 | 上传文件到七牛 | scripts/skill-management/uploadtoqiniu.py | 是 |

路由

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

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

内部平台发布指引

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

bash

先准备鉴权

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，后来要反馈问题，最短路径是：

bash

安装问题反馈 Skill

npx clawhub@latest install cms-report-issue --force

提交问题

python3 cms-report-issue/scripts/issuereport/reportissue.py \ --skill-code my-skill --version 1.1.0 --error ...

查看问题列表

python3 cms-report-issue/scripts/issuereport/listissues.py --skill-code my-skill

标记已解决

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

能力树

text
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
└── uploadtoqiniu.py