技能优化（三维审核 + 重蒸馏）
概述
本技能把「对一套技能包做三轮深度审核、消除病灶、重蒸馏封装」的完整流程固化下来，让它从一次性的手工操作变成可复跑的标准工作流。
它不是「技能进化协议」（搜索外部更优解→评估→对比→蒸馏→合并）的替代，而是它最常用的一档子能力——当结论是「这套技能包本身大体 OK，只是有悬空路径／重复引擎／架构分叉」时，用本技能就地修干净，比走完整进化流程轻得多。（与 WorkBuddy 程序猿 code-monkey 的编排关系，见文末「可选集成」注记。）
核心哲学：先审后改、审改分离、可逆优先。三维审核是"诊断"，重蒸馏封装是"治疗"，二者顺序不可颠倒。
触发场景
- 用户说「给核心技能包做个体检」「三维审核一遍我的技能」「路径干净吗／有没有悬空引用」
- 用户说「重蒸馏封装一下」「消除架构分叉」「技能优化一下」
- 周期性（自动化）：配合
automation_update定时跑scripts/audit_paths.py，把"路径悬空"作为技能包健康红灯交用户审阅 - 任何"这个技能包干不干净、会不会跑歪"的诉求
- 确认门禁：三维诊断完先汇总「问题 + 方案」清单，经用户/编排器确认后才重蒸馏封装；不擅自落刀（详见
references/three-round-audit.md步骤四）
三维审核方法论（总览）
详细步骤、判定标准与真实案例见 references/three-round-audit.md。总览如下：
| 维度 | 名称 | 关键动作 | 退出标准 |
|---|---|---|---|
| 一 | 路径干净 | 跑 scripts/audit_paths.py 扫全部路径引用，分类 SELF_MISS / ROOT_MISS / ABS，逐一修复 |
真实悬空引用 = 0（仅 glob/占位符/反例误报可保留） |
| 二 | 流程通畅无冗余 | 交叉能力所有权核查（去AI味/红线预筛/配图/搜索/落库/编排），确认单点归属 + 调用关系 | 无重复引擎；跨技能调用用显式 ../技能名/ 前缀 |
| 三 | 架构无分叉 | 比对文档↔脚本↔方案三方对同一能力的描述，消除新旧双模型矛盾 | 同一能力全链路只有一套设计，三方一致 |
维度一 · 路径干净（无悬空引用／硬编码错误）
- 跑
scripts/audit_paths.py（--skills指定要审的技能，--report落报告）。 - 对每类命中：
- SELF_MISS：技能内相对路径，技能内与 skills-root 都不存在 → 多半是路径写错（如modules/longform-fantasy/实为modules/improve/）或写成自有实为外部依赖（应改../外部技能/路径）。
- ROOT_MISS：../跨技能路径，从 skills-root 解析后不存在 → 外部技能名/路径写错，修正。
- ABS：绝对路径不存在 → 多为硬编码 Windows 路径，改相对路径（对齐"禁止硬编码绝对路径"铁律）。 - 识别误报：glob（
scripts/*.js）、文档占位（room-xxx/SKILL.md、0X-室）、反例截断（c:/Users/.../x.js）不是缺陷，审计脚本已自动过滤，保留即可。 - 修完复跑审计，确认真实命中归零。
维度二 · 流程通畅无冗余（单点归属）
- 列出技能包的"交叉能力"（多个技能都可能做的能力，如去AI味、红线预筛、配图、搜索、知识库落库、跨室编排）。
- 对每个交叉能力，确认唯一 owner + 调用关系：owner 实现，其他技能调用，不重复实现引擎。
- 发现重复引擎 → 标记冗余点；若是"按层级拆分的合理副本"（如完整提示词引擎 vs 发布向子集），记录但不强制合并。
- 跨技能引用一律用显式
../技能名/...或技能名/...前缀，杜绝"写成自有、实为外部"的歧义。
维度三 · 架构无分叉（文档↔脚本↔方案一致）
- 抓取技能包里"同一能力"在文档（SKILL.md/references）、脚本（.py/.js）、外部方案文档三处的描述。
- 比对是否存在两套互相矛盾的设计（最典型：旧模型散落文档、新模型已在脚本/方案落地，但文档没跟上 → 执行分叉）。
- 以"最新落地的方案/脚本"为事实来源，把文档全部对齐过去；必要时同步改脚本默认参数（如模型名、上下文窗口）以匹配设计意图。
- 修复后三方描述一致，无分叉。
重蒸馏封装（治疗阶段）
三维诊断完成后，统一落盘：
- 路径规范化：跨技能资源显式
../技能名/前缀；去除硬编码绝对路径；缺失脚本依赖删除引用或改路由到可用工具。 - 代码简洁：删临时文件、示例代码残留；空
scripts//references/目录不保留。 - 版本留痕：被修技能 SKILL.md 记版本号 + 一行 changelog（本次改了什么）。
- 写审核报告：仿
references/three-round-audit.md的"结论速览 + 每维修复清单 + 待确认项"结构，落盘到项目目录。 - 回交：修复包与报告交编排器/最终决策者定夺是否落库；落库前确认已备份原版（
_bak_YYYYMMDD）。
工具与脚本
scripts/audit_paths.py：通用路径审计（三维审核·维度一的可复跑工具）。零依赖，不绑定任何工作台，仅做文件扫描。
运行：
bash PY=python3 # 或你本机的 Python 解释器路径 # WorkBuddy 默认：扫 ~/.workbuddy/skills 下 SKILL.md "$PY" scripts/audit_paths.py --skills skill-a,skill-b --report ./audit.md # 其他工作台：--root 指向你的技能仓库，--spec 指向该工作台的规格文件名 "$PY" scripts/audit_paths.py --root /path/to/repo --spec AGENTS.md --skills pkg-x # 全量扫描（如 Claude Code 仓库，规格文件为 CLAUDE.md）： "$PY" scripts/audit_paths.py --root /path/to/repo --spec CLAUDE.md
参数：--root（技能仓库根目录，默认~/.workbuddy/skills）、--spec（规格文件名，默认SKILL.md；Claude Code=CLAUDE.md、通用=AGENTS.md）、--skills（逗号分隔包名，空=全量）、--report（报告输出路径）、--quiet（静默）。退出码：有真实悬空引用返回 1，否则 0（便于自动化判定）。
红线（必须遵守）
- 可逆优先：任何覆盖/移动前先
cp -r备份到_bak_YYYYMMDD；出错可回滚。 - 不破坏被审核者：只修路径/流程/架构病灶，不改写被审核技能的身份定义文件（如 SOUL.md / IDENTITY.md / USER.md）；不抢被审核技能的身份。
- 先审后改：未跑三维审核、未定位真实病灶前，不盲目改脚本或文档。
- 知识产权：蒸馏/复用第三方技能遵守其许可，保留署名，仅自用不分发销售。
可选集成：WorkBuddy 程序猿（code-monkey）（注：WorkBuddy 专属，非技能运行依赖）
本技能在 WorkBuddy 生态中归口于程序猿（code-monkey）进化协议，作为其「健康体检子技能」被编排调用。这一段仅描述 WorkBuddy 内的协作方式；技能本体（脚本 + 三维方法论）完全独立，可在任何以 markdown 规格文件定义 agent 技能的工作台使用。
- 分工边界：程序猿管「引入外部更优解、跨技能去重合并、版本升级」；本技能管「现有技能包内部的路径/流程/架构健康度」。
- 串联方式：程序猿阶段 7（实测调试）与阶段 8（精简迭代）直接调用
scripts/audit_paths.py做路径维度静态体检，再走三维审核全文。 - 协作角色：程序猿为编排器（决定动谁），阿墨为主人格（最终落库决策者）；本技能产出（修复包 + 报告）回交二者定夺，不擅自改写被审核技能的身份定义。
Any unneeded directories can be deleted. Not every skill requires all three types of resources.
