技能医生
快速入门
对AI技能文档进行出厂级质量审查——自动检查15项指标 + 按5子能力SOP优化。创建/修改技能时触发，日常对话不触发。
何时生效
- 用户要求创建新技能
- 用户要求修改/优化/审查现有技能
- 用户说"帮我看看这个技能写得怎么样"
何时不生效
- 技能使用场景（如"帮我用ima-ppt做一个演示文稿"）
- 非技能文档的一般性写作优化
- 日常问答
触发条件与调用方式
触发词
「创建技能」「修改技能」「审查技能」「技能质量检查」「优化技能文档」「帮我看看这个技能写得怎么样」「skill review」
调用方式
Agent 在处理技能创建/修改任务时自动加载。先跑 scripts/check.sh 机械检查，再执行5子能力SOP逐项审查优化。
> 从零开始创建新技能？先加载 references/skill-creation-guide.md ——五阶段可执行checklist + 避坑清单。
执行主流程
审查执行顺序（先查"对不对"再查"省不省"）
① 技能设计审查
- 触发精确度：场景锚定？≥3同义触发词？边界排除？反例检查？description 满足极简公式（功能定义+触发场景）？正文是否泄露触发条件？→ 详见检查10/15
- 步骤可见性：动词合格（搜索/读取/生成/输出/写入/检查）？不合格有「通过/以/来+具体手段」补充？≥3连续不合格→高风险模糊区
- 上下文预算：L1结构（核心在SKILL.md，详情在references/）？L2字数（建议≤3000中文字≈1800 tokens，Particula 2026甜点区上界；最大不超过5000字≈3000 tokens）？L3去冗余：扫描零信息量前缀/同概念多文件重复/Markdown注释/旧版残留
- 安全确认点：4类不可逆操作（文件修改/外部发送/破坏性操作/高影响决策）前有「确认后」「等用户回复」节点？问：做错了能撤销吗？
- 脚本化评估（技能效率审查）：四维打勾 → 4/4🔴应脚本化 3/4🟡考虑 ≤2/4不触发
- 操作性质：步骤是否仅涉及读取/写入/计算/匹配/格式转换等机械操作？（不含语义理解/判断/推理）
- 输入固定性：输入是否总是同一类型/格式？（如文件路径、日期字符串、API响应JSON）
- 输出确定性：相同输入是否总产生相同输出？（无随机性/无依赖外部状态变化）
- 重复执行：该步骤是否每次对话都需要执行？（非一次性/非低频操作）
- 文件结构检查：references/guide.md 存在？三模块（输出示例/FAQ/反模式）至少存在标题？references/changelog.md 独立？SKILL.md 仅保留当前版本+引用？
② 文档结构审计
- 扫描连续>3行段落→转bullet（每句≤15词）
- 表格≤3列→转bullet；≥4列保留
- 同级格式统一；并列结构用bullet不用逗号分号；每段结论先行
③ 交叉引用替代展开
- 3条件全满足→替换为「详见{技能名}SKILL.md」：①目标SKILL.md有完整展开 ②规则为技能行为类 ③目标有稳定访问路径
- 3类不替代：仅标题无展开/记忆独有经验/用户偏好
④ 文档精炼瘦身
- 冗余前缀删除：「好的/我来/首先/需要注意的是/换句话说/总之/那么」
- 重复定义合并：同概念多文件→统一一处，其余交叉引用
- 历史注释清理：Markdown注释/TODO/旧版描述/废弃路径
- 精炼后执行一次用户级任务验证并比对输出质量
⑤ 版本状态管理
- 版本号：a级(文件级结构变更)+1.0.0 | b级(新增模块/重构)+0.1.0 | c级(增量维护)+0.0.1
- 不稳定期（前10版内）所有变更默认c级
- 必须等用户确认版本号后再注册，禁止AI自行决定
- changelog格式：vX.X.X: {概述}。{详情} | {数据} | {依赖}
> 各子能力正反例、反模式、FAQ、外部研究结论见 references/guide.md（按需加载）。
配套工具
scripts/check.sh — 15项机械性检查自动报告（字数统计/字段完整性/冗余扫描/安全确认点/交叉引用完整性/脚本目录一致性等）。Agent 执行审查前建议先跑一遍。
> description 编写方法论 → references/description-guide.md（创建/优化技能时按需加载）
边界与异常处理
让步场景
- 反幻觉强制验证场景：反幻觉优先，不因 Token 优化跳过验证
- 用户明确要求保留特定格式：不强制转换，标记为「用户指定格式」
不适用场景
- 技能尚未创建（仅讨论想法阶段）
- 用户明确说"不用审查"
- 非技能文档的写作优化
知识型技能特别说明
对于知识型/思维模型类技能（如分析框架、投资哲学、方法论知识库），步骤可见性审查中的「不合格动词」判断需放宽——这类技能的核心价值在于「分析框架」「理解方式」「思考路径」本身，分析/理解/思考/评估 等动词在此语境下属于合理表述。审查时以机械检查为主，步骤可见性审查仅作参考标注。
版本信息
屠夫1868 · 公众号：资产101、基业长红
完整版本历史见 references/changelog.md。
