> 安全边界：本技能为静态质量检查工具，非 OS 级沙箱隔离环境。对被检技能的自测脚本仅做超时终止与 WARN 提示，不替代操作系统级沙箱，不对技能目录之外的文件执行删除/挂起等写操作。
> 族内入口清单（技能质量管理族 · 体检段）
> 本技能是本段唯一入口。职责：对单个技能做质量检查与评分：防幻觉合规、目录规范、评分报告。
> 段内从属技能（不单独触发，由本技能按需调度）：
> - zfl-skill-health-check — 深度体检（四维事实一致性：代码/架构/测试/文档）
> - zfl-skill-trigger-audit — 触发机制审计（frontmatter 触发字段分类与卫生）
> - zfl-skill-panel-cleanup — 面板噪声清理（description 过胖、正文混入代码块）
约束与错误处理
- 本技能仅做静态质量检查与评分，不修改被检技能源文件；所有写操作限于输出目录（报告/看板），不触及技能目录内源文件（安全边界见上）。
- 错误处理：依赖缺失（如 zfl-skill-factory 的 portability_scan / kb_completeness_check）时降级为 WARN 并跳过对应检查项，不中断整体扫描；单技能异常不影响全库扫描继续。
- 超大 SKILL.md（>3000 行）不加分但也不判失败，仅记录 very-long 提示。
参考文档
- 版本与取号一致性判定对齐 zfl-skill-factory 的
version_io单一真源（v 前缀须可选，取首个标题行）。 - 历史逐条变更原文见
CHANGELOG_DETAIL.md（由 changelog_condense.py 归档，勿手工编辑）。 - 跨技能共用范式参考 zfl-common 共享库。
示例
对单个技能执行体检：
python scripts/quality_checker.py --skill-dir path/to/zfl-example-skill --output report.json
输出 JSON 含 score / quality_flags / dims 三维评分与旗标明细。
也可专项校验「SKILL.md 示例节命令用户复制能不能跑通」（吸取跨技能引用必须实跑的教训，PM 验收豆包批次迭代的产出落地）：R1 脚本存在 / R2 参数接受(--help 命中或源码文本回退，兼容手工 argv 解析) / R3 --help 可运行三档；--selftest 正负夹具自证(须抓出已知错参数防恒真)。
python scripts/example_runnable_check.py --skills-dir . --selftest
python scripts/example_runnable_check.py --skills-dir <skills_root> --prefix zfl-
输出与格式
- 评分：7 维加权（约束 / 参考 / 示例 / 输出格式 / 长度 / 触发 / 边界）汇总为 0~100 分。
- 报告：JSON（逐技能 score、flags、dims）+ 可选 Markdown 目录索引。
- 看板：按分数桶（0-9 / 10-19 / … / 100）汇总的
_qc_dashboard.html。
不适用场景
- 本技能不适用：① 运行时强制依赖缺失且无自愈路径的极端环境（降级为 WARN 跳过）；② 对被检技能目录之外的文件执行删除 / 挂起等写操作（仅做超时终止与提示）；③ 替代操作系统级沙箱隔离（见安全边界声明）。
自检与成功标准
- 成功标准：单技能体检以「0 个 P0/P1 flag 且评分达门禁阈值」判通过；全库扫描以「全部技能 0 个 P0 flag」判通过。
- 输出前自检：各子脚本支持
--selftest自检（如 generation_gate_coverage.py）；quality_checker 自身由 p0 / p12 / p14 / p15 回归套件在输出前自检覆盖，确保判据不被静默退化。
