Skill 优化专家

要解决什么问题

基于 SKILL.md 的 Agent Skill 往往越写越长：frontmatter 缺字段、触发词含糊、同一段指令重复三遍、术语前后不一致，甚至 references/ 路径已经漂移。发布前或收到反馈后，你很难系统性地对照一套质量基准，更不敢直接改文件——怕静默覆盖、怕改坏业务逻辑。

Skill Auditor 是一个元技能：把「别的 Skill」当作分析对象，框架无关（WorkBuddy、OpenClaw 等通用），在本机完成审查、评测、测试与可选优化，不上传 Skill 内容。

它怎么工作

整条流水线按 Phase 0–5 推进，中间产物落在目标 Skill 目录下的 .skill-audit/：

• 审计 + 语义：audit_skill.py 查结构、提示词质量、效率（死引用、重复块）；semantic_analyzer.py 查近义重复、术语混用、冲突指令。
• TRACE 评测：按 SkillHub 五维（Trust / Reliability / Adaptability / Convention / Effectiveness）加权打分，每项带证据，便于先修最弱维度。
• 测试：skill_tester.py 默认跑静态完整性（引用路径、frontmatter、锚点）；边界/准确性用例可生成；真正交给模型跑需可选 --model-config，可完全跳过。
• 优化与报告：optimize_apply.py 默认 dry-run，只应用可逆、低风险改写；确认后才落盘并保留 .bak。build_report.py 汇编为 REPORT.md。

一条命令跑全流程：python3 scripts/run_all.py（审计→语义→TRACE→测试→报告）。规则与策略可通过 config.json 扩展，无需改代码。

边界与注意点

• 会做：审查/评测/测试/安全优化任何标准 SKILL.md Skill；非标准布局会降级（例如只审正文并标注缺失目录）。
• 不做：改写目标 Skill 的领域业务逻辑、处理二进制资源、保证某分数或「一定通过」、访问私有仓库或外网。
• 超大文档（如正文超过约 3 万词）语义分析会「重点段深扫 + 全文浅扫」，覆盖区间会写在报告里。
• 自然语言即可触发（「审」「修」「比」）；路径或是否要落盘不清楚时，会先澄清再动手。