> 族内折叠指针(技能质量管理族 · 体检段)
> 本技能已归入 zfl-skill-quality-checker(本段唯一入口)。日常使用请从主技能进入。
> 目录与脚本资产保留,供主技能及其他技能直接调用,请勿重复实现本技能已有能力。
约束与错误处理
- 本技能是单技能深审:只对一个技能读代码、跑测试、出报告,不做全库批量打分(全库打分归 zfl-skill-quality-checker),也不直接改技能内容(改动归 zfl-skill-creator / edit-gate)。
- 体检结论必须基于真实代码与真实测试输出,不凭 SKILL.md 自述打分;读不到源码或跑不动测试时显式标注「该维无法核验」,不给假分。
- 错误处理:目标技能目录不存在时直接报错退出;四角色任一角色因缺测试/缺 scripts 无法完成时降级并在报告写明,不静默跳过。
参考文档
references/four_role_checklist.md:四角色(代码/架构/测试/文档)体检判据清单 SSOTreferences/sample_report.md:体检报告输出格式样例(四维评分 + P0/P1/P2 问题清单)- 互补工具:zfl-skill-quality-checker(全库 7 维自动结构打分,本技能不替代)
示例(单技能四角色深度体检)
用户:「给 zfl-skill-x 做个体检,看看代码和文档对不对得上」→ 本技能按四角色框架对单个技能做事实一致性深审(区别于 quality-checker 的全库自动打分):
1. 代码角色:通读 scripts/ 真实源码,核对 SKILL.md 声明的 scripts 是否都存在、是否真被调用,揪出死配置/未接线 flag。
2. 架构角色:理依赖与调用关系,判断是否有第二份活体实现、薄壳入口是否真的只转发不复制逻辑。
3. 测试角色:跑真实测试用例(tests/ 或自冒烟),核对「自检成功标准」是否被真实验证,而非假测试。
4. 文档角色:逐段比对 SKILL.md 声明(description/触发场景/约束)与代码实际行为,标出入不一致处。
5. 出报告:四维评分 + P0/P1/P2 问题清单 + 整改建议,格式对齐 references/sample_report.md;全库自动结构分仍交 zfl-skill-quality-checker。
实际命令形态(<skills_root> 为技能根目录占位符):
# 1) 先读四角色检查清单(本技能体检的判据 SSOT)
type <skills_root>/zfl-skill-health-check/references/four_role_checklist.md
# 2) 对照样例报告格式出报告
type <skills_root>/zfl-skill-health-check/references/sample_report.md
# 3) 补跑全库自动打分作交叉参考(四维深审之外的结构分,互补不替代)
python <skills_root>/zfl-skill-quality-checker/scripts/quality_checker.py --skill-dir "<skills_root>/zfl-skill-x" --fail-on P0