技能优化器

解决什么工程问题

在维护 Agent 技能包（Skills）时，随着业务迭代，仓库往往会积累三类结构性病灶：

• 悬空引用：文档中引用的脚本路径已失效，或存在硬编码的绝对路径，导致跨技能调度时报错。
• 重复引擎：多个技能各自实现了同一套底层逻辑（如搜索、落库），造成维护冗余和潜在的执行冲突。
• 架构分叉：文档描述的方案与实际落地的脚本不一致，导致模型执行时出现预期外的偏差。

人工排查这些分散在文档、脚本和方案中的问题成本高且极易遗漏。

核心机制：三维审核与重蒸馏

本技能将“体检”与“治疗”解耦，遵循先审后改、可逆优先的原则，将优化流程固化为标准工作流。

三维诊断（Audit）

1. 路径干净：运行 scripts/audit_paths.py 静态扫描全部路径。自动分类并修复 SELF_MISS（内部路径错误）、ROOT_MISS（跨技能路径失效）和 ABS（硬编码绝对路径），同时智能过滤 glob 或占位符等误报。
2. 流程通畅：核查交叉能力的唯一归属权（Single Owner）。杜绝多个技能重复实现同一引擎，要求跨技能调用必须显式使用 ../技能名/ 前缀。
3. 架构对齐：比对文档、脚本、方案三方对同一能力的描述。以最新落地的脚本/方案为准，消除新旧设计并存的分叉。

重蒸馏封装（Re-distill）

诊断汇总后，仅在用户或编排器确认后才执行修复落盘：

• 规范路径引用，清理临时文件与空目录。
• 在 SKILL.md 中追加版本号与 changelog。
• 输出结构化的审核报告供最终决策。

适用边界与红线

• 定位：它不是“技能进化协议”，无法引入外部更优解，仅负责修复现有技能包内部的健康度问题。
• 安全：任何覆盖操作前必须执行 cp -r 备份至 _bak_YYYYMMDD。
• 禁忌：严禁篡改被审核技能的身份定义文件（如 SOUL.md），不越权决策落库。