SkillHub 原创上架手册
面向「高频上架原创 Skill」的协作者：把已验证的成功路径固化，避免 Agent 每次重踩 slug 过长、路径反斜杠、未看板核对、重复上传。
何时使用
- 「做个 Skill 并上架」
- 「Slug 不可用」「上传后看板没有」
- 连续上架多个 Skill
底层硬规则
- 已上架禁止再传（dashboard 或本地已发布清单已有 → 拒绝重传）。
- 只上新原创，不整段抄其他 Skill。
- 成功标准：仅以 dashboard「我的 Skills」出现显示名为准。
- 两次上传之间随机等待 2～5 分钟。
- 首次发布 变更说明留空。
交付结构
<skill-dir>/
SKILL.md # 必填，含 YAML：name/slug/description（中文为主）
README.md # 必填中文说明
reference.md # 可选
templates/ # 可选
zip 条目必须用 /，形如 my-skill/SKILL.md。
Slug（强制）
- 格式：
[a-z]{2,4}+YYYY+[0-9]{3,4}，总长 ≤16 - 例：
oqh20268596 - 禁止：长英文缩写+完整日期、demo/test、连字符
- 上架前
check-slug→available:true；表单用 React onChange 写入
网页上架检查清单
SkillHub Ship
- [ ] 查已发布清单，确认未上架
- [ ] 写好 SKILL.md / README，打 zip（/）
- [ ] 随机等待 2～5 分钟（非首个时）
- [ ] 打开发布页 → 本地上传 → setFiles(zip)
- [ ] 见到「已选择」含 SKILL.md
- [ ] 使用此描述 → 填 slug/显示名/描述/1.0.0，变更说明空
- [ ] 取消大赛勾选 → 提交审核
- [ ] dashboard 搜显示名成功 → 写入已发布清单
常见失败
| 现象 | 处理 |
|---|---|
| Slug 不可用 | 换短 slug；React 同步赋值后再提交 |
| 文件路径不安全 | zip 内改用 / |
| setFiles 找不到 input | 先点「本地上传」；勿在无文件时乱点清空 |
| 接口成功但看板无 | 翻页查找；仍无则未成功 |
Agent 原则
- 先创作本地包，再上架；上架失败可换 slug 重试 1 次，不可改已成功项再传。
- 中文描述写清「何时用」。
- 向用户汇报：显示名、slug、看板是否确认。
附加
- README.md · reference.md · templates/checklist.md
