技能医生

要解决什么问题

Agent 技能靠 SKILL.md 和 references/ 驱动行为，但手写文档很容易出现：触发词过少或边界不清、步骤里全是「分析/理解」这类不可执行动词、正文里泄露触发条件、不可逆操作没有确认节点、同一规则在多个文件里重复展开。改一版又不知道该不该 bump 版本号。技能医生面向「创建 / 修改 / 审查技能文档」这类任务，在日常用技能做业务（例如「帮我用某技能做 PPT」）时不触发。

怎么工作

执行顺序是先查对不对，再查省不省：

1. 技能设计审查：触发精确度（场景锚定、≥3 同义触发词、边界排除、description 公式）、步骤可见性（合格动词或「通过/以/来+手段」）、上下文预算（L1/L2/L3 结构与字数）、安全确认点、以及脚本化评估四维打分。
2. 文档结构审计：长段落转 bullet、小表格转列表、同级格式统一。
3. 交叉引用替代展开：满足三条件时用「详见某 SKILL.md」代替重复正文。
4. 文档精炼瘦身：删冗余前缀、合并重复定义、清历史注释；精炼后建议做一次用户级任务验证。
5. 版本状态管理：按 a/b/c 级规则提议版本号，须等用户确认后再注册，changelog 走固定格式。

审查前可先跑 scripts/check.sh 做 15 项机械检查；从零建技能时可按需加载 references/skill-creation-guide.md。

边界与注意点

• 让步：反幻觉验证场景不因 token 优化跳过；用户明确要求保留的格式标记为「用户指定格式」不强制改。
• 不适用：仅讨论想法、尚未成稿；用户明确说不用审查；非技能文档的一般写作优化。
• 知识型技能：分析框架类技能在「步骤可见性」上对分析/理解/思考等动词应放宽，以机械检查为主，可见性审查作参考标注。