SkillHub 发布与评分优化
将本地 Skill 发布到 SkillHub 并优化至满分。
全中文硬性要求（永久指令）
用户的所有 Skill 必须使用中文：
- SKILL.md 正文全中文；displayName 必须中文
- description 中英双语（英文供海外 AI 匹配触发词）
- scripts/ 注释和提示全中文
- 例外：代码、命令、文件路径、技术术语
发布工作流
# 1. 干跑预检
skillhub publish <skill目录> --dry-run
# 2. 正式发布
skillhub publish <skill目录> \
--version 1.x.0 \
--changelog "v1.x.0: 变更摘要"
必填 Frontmatter
name、slug（全局唯一，小写+连字符）、displayName（中文）、description（中英双语+TRIGGER关键词，≤1024字符）、version、author。
限频重试
发布频率受限时（报566或"发布频率过高"）：间隔15s→间隔30s→间隔60s。dry-run 不受限。
5 维度评测标准
| 维度 | 子项 | 满分要点 |
|---|---|---|
| 适应性 | 能力边界 | 明确「能做什么」+「不能做什么」 |
| 触发方式 | 精确触发关键词 + 不触发说明 | |
| 规范性 | FAQ/反模式 | 5条 FAQ + 3条反模式 |
| 文档质量 | 多场景完整示例，输入输出对照 | |
| 文件结构 | SKILL.md + scripts/ + references/ 模块化 | |
| 有效性 | 准确性/完整性 | 规则严谨，覆盖所有声称的能力 |
| 可用性 | 输入后直接输出，无需反复确认 | |
| 可靠性 | 错误处理 | 四级降级（空/短/长/格式错） |
| 输入校验 | 定义有效输入标准和降级提示 | |
| 可信度 | 国内可用 | 全中文、零海外 API 依赖 |
| 安全扫描 | 通过 SkillHub 安全扫描 |
AI-Native 设计原则
Skill 给 AI 读，不给人类读。AI 需要接口契约：
✅ AI 会调用
- 触发精确：description 含明确触发关键词
- IO 明确：脚本参数/返回格式一目了然
- 单职：一个 Skill 只做一件事
- 补 AI 之短：做 AI 原生做不到的事（格式转换/并发检测/JS渲染抓取）
❌ 反模式
- 教程式描述（"你可以这样…"）
- 触发模糊（没有关键词映射）
- 万能工具（列十件事，AI 觉得"我直接做也行"）
- 解决人的痛点而非 AI 的痛点
常见错误
缺少 slug→ frontmatter 加slug:字段缺少 displayName→ frontmatter 加displayName:（中文）slug 冲突→ 换一个全局唯一的 slug- status=None → 正常，等 2-3 分钟索引
- 566 服务端错误 → 特定 slug 持续 566 是 SkillHub 后端问题（web-scraper、format-transformer 已验证）。多次间隔重试无效时，等数小时再试。dry-run 通过≠发布能通过。
- 发布频率过高 → 间隔策略：首次 15s → 重试 30s → 再次 60s。批量发布时每组 ≤3 个，组间间隔 ≥30s。
- description 缺 TRIGGER/INPUT/OUTPUT → 评测扣分。description 末尾必须追加
TRIGGER: <触发词> INPUT: <输入格式> OUTPUT: <输出格式>。 - knowledge/ 或 references/ 目录缺失 → 文件结构分扣分。至少一个 knowledge/ 或 references/ 子目录含参考文档。
> 真实评测数据见 references/evaluation-data.md — 含 devil's-advocate 各维度得分和修复对照。
