技能介绍

问题出在哪里

WorkBuddy 的技能面板会直接渲染 SKILL.md 全文，包括 frontmatter 的 description 字段和正文 body。当技能文档采用“AI 执行导向”写法时，正文里常塞满代码块、正则铁律、RFM 评分模型、部署脚本和版本注记。这些内容对模型执行有帮助，但暴露在面板上就变成噪声：用户看到长文、断链、旧版本提示和无关脚本细节，反而找不到“这个技能能干什么”。

只瘦身 description 不够，因为面板渲染的是整个 SKILL.md。必须同时重构正文，把实现细节外移到 references/。

它如何工作

该技能围绕检测、规划、重构、验证四步展开：

检测噪声：运行 audit_panel_noise.py，按阈值识别长 description、超长正文、代码块、版本注记、方法论段、乱码、内嵌 CHANGELOG、行内日期、游离版本号、相对链接、展示版本与 frontmatter 不一致、规则库堆叠等问题。
规划外移：列出可外移到 references/implementation-details.md 的段，保留面板友好内容，例如用途、分类表、与其他技能关系、自测方式。
自动重构：使用 --fix 把噪声代码块和方法论段外移，写盘前生成 SKILL.md.bak；可选 --fix-desc 瘦身 description。手动收尾时按 references/template.md 重写正文。
验证回归：复跑审计确认命中减少，确认五源版本一致性不变，并跑技能自带自测确认功能未回归。

额外能力包括未引用死重产物检测（--fix-orphan dry-run 预览，执行删除前备份）和分享前隐私门禁（递归扫描敏感实名，命中即 FAIL）。

边界与注意点

不改业务逻辑：scripts/ 代码一行不动，--fix 也只挪文档。
外移内容必须完整，AI 执行时仍能照读 references/。
版本号归工厂/five_source_check 管理，G16 只中和面板展示串，不写 frontmatter/metadata 的 version 字段。
清理说明要避免“自引用陷阱”：CHANGELOG 里举例 (vX.Y.Z 新增) 也会被下一轮检测命中，应改用中性表述。
分享前需同步清洗 CHANGELOG、references、scripts 等公开面，避免代码清干净后说明又泄密。

该技能只治理文档结构与面板可读性，适合发布前对 WorkBuddy 技能做噪声审计和重构，不适合当作功能运行时的依赖。