Skill 质量检测器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b2e05375/optimize-skill。
技能介绍
要解决什么问题
自己写的 Claude Skill 往往「能跑但不稳」:description 只写功能、不写什么时候触发;步骤含糊,模型每次执行路径不一样;缺参数时要么瞎猜要么沉默。Skill 多了以后,也很难系统性地对照同一套标准做评审。
这个技能把「能不能用」和「怎么改」拆成固定流程:先在你本机扫出候选 Skill,再按清单打分出报告,只有你确认后才动文件。
怎么工作
三步流程:选择目标 → 检查出报告 → 用户确认后修改。
- 选择目标:扫描
~/.claude/skills/*/SKILL.md与项目内.claude/skills/*/SKILL.md,列出名称和一句话描述,让你点选(已指定则跳过)。 - 检查并出报告:读取目标目录全部内容(
SKILL.md、references/、scripts/),对照 8 项检查清单逐项判定为 ✅ 有 / ⚠️ 部分有 / ❌ 没有。
- 必须有(1–3):触发条件、可执行步骤、输出可预期 — 决定总评是 🟢 合格、🟡 基本可用还是 🔴 不可用。
- 建议有(4–6):边界约束、输入→输出示例、缺失处理。
- 加分项(7–8):SKILL.md ≤500 行且少冗余、大段参考放进 references/。
- 修改:你勾选要改哪些项后,逐项展示修改前后对比,改完会重新检查一遍。
说「进阶优化」或「深度评审」时,会在基础报告后追加:自由度设计、渐进式披露、可组合性、Bootstrap State、安全意识等进阶建议,并尽量给出可落地的改法(例如「在 description 末尾加 Use when: …」)。
边界与注意点
- 只读取和修改目标 Skill 目录下的文件;不会新建 README、CHANGELOG 等旁路文档。
- 修改前必须等你确认;若 1–3 项已全部 ✅,会说明「已经很好」并只给微调建议,不强行大改。
- 补全内容时不编造新功能,只在原有意图上收紧表述;改完后仍要求
SKILL.md不超过 500 行。
使用场景
- 团队把多个 Skill 放在 `.claude/skills/` 后,需要按同一套清单核对触发条件与执行步骤是否可照做
- 写完或改版 `SKILL.md` 准备提交前,想先得到合格/不可用结论,避免上线后模型乱触发
- 本机 `~/.claude/skills` 里 Skill 太多,想列出名称与摘要后选中某一个做八项检查
- 基础项已合格,仍希望对照自由度设计、渐进披露等维度做深度评审并拿到具体改法
适合人员
- 负责维护团队内部 Claude Skill 库、需要统一「何时触发、输出什么」标准的平台或 Agent 工程师
- 在 SkillHub 或内网发布 Skill 前,希望对照八项清单自检并可选自动改文的作者
- 接手他人留下的 Skill 目录,要先判断是可用还是必须修触发与步骤再交给同事使用
- 制定 Agent 技能规范的技术负责人,需要可重复的评审流程与修改前后对比