> 族内折叠指针（技能质量管理族 · 体检段）
> 本技能已归入 zfl-skill-quality-checker（本段唯一入口）。日常使用请从主技能进入。
> 目录与脚本资产保留，供主技能及其他技能直接调用，请勿重复实现本技能已有能力。
约束与错误处理
- 本技能仅处理其声明范围内的任务，不越界执行未授权操作。
- 错误处理：输入不合法时返回明确错误说明，不静默跳过；依赖缺失时降级提示并给出替代路径。
隐私实名门禁与业务必需豁免
- 词表（用户级
~/.workbuddy/lessons/privacy_blocklist.txt）分段：# [HARD]真人名永不豁免；
# [SOFT]业务实体/项目名可声明豁免；未标记段按 HARD。 - 全库取证表明：81 处命中里绝大多数是替换即破功能的位置（封面单位锚点常量、
冻结回归案例库、OCR 纠错字典键名、脱敏技能自引用夹具）。门禁只报「须清洗」而
不给合法出路＝逼人裸改或无视告警。故提供官方豁免信道： - 技能级
.privacy-allowlist，每行相对路径glob :: SOFT :: 理由。
只写路径不写词（写词＝把真名写进随包文件）；HARD 类别声明被拒并 stderr 告警；
豁免项照常计数并显示「已声明豁免 N 处」，绝不静默。 - 判据取舍：可安全清洗的文档性文本（来源注记、模板示例值）应真清洗为占位符，
不应用豁免掩盖；豁免只给「替换即破功能」的位置。
不适用场景
- 不适用于需要实时交互或外部 API 调用的场景。
- 不适用于超出本技能声明范围的任务类型。
输出与格式
- 输出格式：结构化文本，包含明确的章节划分与关键结论。
- 输出结构：按任务类型返回对应格式，确保可读性与可追溯性。
示例（单技能噪声审计 → dry-run 预览 → fix 外置）
场景：某技能面板渲染出大段部署脚本与技术方法论，需把 AI 执行细节外移到 references/、正文瘦身为面板友好版。
1. 只读审计：对目标技能跑审计，列出 description 过胖、正文代码块/版本注记/方法论段等命中项，不改盘。
2. 预览外置：加 --dry-run 看 --fix 将把哪些段外移，确认围栏闭合、不误伤 frontmatter。
3. 执行外置：去掉 --dry-run 真正写盘，代码块/方法论段搬到 references/，正文只留概述/分类表/关系/自测。
4. （可选）瘦身 description：加 --fix-desc 一并把过胖的 description 压到面板可读长度。
5. 全库复扫：对整个 skills 根目录 --scan-all --json-out <路径> 出基线，核对该技能噪声项清零。优先用 --json-out 直写文件（UTF-8，不经 shell 重定向）；--json 走 stdout，在 Windows 下经 PowerShell > 会被转码成 UTF-16LE、产物不可解析（1.14.1 已加 --json-out 修复此缺陷）。
实际命令形态（<skills_root> 为技能根目录占位符）：
# 1) 只读审计单个技能（列出噪声命中项，不改盘）
python <skills_root>/zfl-skill-panel-cleanup/scripts/audit_panel_noise.py <目标技能目录>
# 2) 预览 fix 将外置哪些段（dry-run，不写盘）
python <skills_root>/zfl-skill-panel-cleanup/scripts/audit_panel_noise.py <目标技能目录> --fix --dry-run
# 3) 全库批量扫描出 JSON 基线（核对整改后该技能噪声清零）
# 推荐 --json-out 直写 UTF-8 文件；--json 走 stdout，Windows 下经 PowerShell 重定向会损坏产物
python <skills_root>/zfl-skill-panel-cleanup/scripts/audit_panel_noise.py <skills_root> --scan-all --json-out <输出文件路径>
