- name
- cms-push-skill
- description
- 用于"发布 Skill / 上架 Skill / 推送 Skill / 更新已发布的 Skill / 下架 Skill / 把本地 Skill 上传到平台 / 同步到 ClawHub 或 GitHub"。一键完成 打包 → 七牛上传 → 平台注册/更新/下架。需要先通过 cms-auth-skills 取得 token。问题反馈请用 cms-report-issue
- skillcode
- cms-push-skill
- dependencies
当前版本: v1.6.1
cms-push-skill
只负责一件事：把已经准备好的 Skill 推送到平台。
这里说的“平台”，默认就是我们内部技能管理平台。
能力总览
| # | 能力 | 脚本 | 需要登录 |
|---|---|---|---|
| 1 | 注册新 Skill | scripts/skill-management/register_skill.py | 是 |
| 2 | 更新已有 Skill | scripts/skill-management/update_skill.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/upload_to_qiniu.py | 是 |
路由
- 发布到我们内部平台：
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。
规则
- 所有推送动作统一使用
scripts/skill-management/下的脚本。 - 推送前先通过
cms-auth-skills准备好access-token。 - 内部 Skill 走七牛上传 + 平台注册。
- 外部 Skill 跳过七牛上传，直接使用 ClawHub 下载地址。
- 本 Skill 只维护推送链路；问题闭环统一交给
cms-report-issue。 - 所有说明文档统一使用 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