用途:把质量当作可量化的指标和债务变化来跟踪,而不是一个模糊的单一分数。先冻结新的质量退化,再用生成的指标展示当前质量与收敛方向。
适用时机:用户要求设计、评估或维护 QUALITY_SCORE.md、质量报告、质量快照、债务削减或红线;仓库需要 lint 与测试之外的结构性指标;团队需要周期性园艺式清理,而非一次性大重构。
所需输入:当前质量痛点(大文件、分散事件、直接 API 调用、重复入口点、缺失测试等);要扫描的源路径与排除路径;CI 或定时运行策略。
执行顺序:先查找现有质量文档、生成报告、lint 检查与基线;再选择少量可跟踪指标与阈值,不要造虚假的聚合分数;最后输出质量报告形态、门禁策略与收敛节奏。
步骤:搜索 QUALITY_SCORE.md、质量脚本、基线与 CI 园艺工作流;选择四到八项指标,每项均可自动采集;若无质量报告,按 references/build-when-missing.md 引导最小分数/报告/基线集;区分阻断门禁与信息性报告;历史问题用阈值或基线,新退化应直接失败;生成面向人的 Markdown 与面向脚本和趋势的 JSON;设计园艺节奏,一次降低一个阈值或关闭一个允许列表项。
检查要点:每项指标可重复且反映真实结构风险;阈值冻结新退化而非要求立即全面清理;每个发现包含路径、指标、当前值、阈值与建议动作;明确哪些指标使构建失败、哪些仅报告;不要用一个好看的总分掩盖关键风险。限制与非目标:资料未提供具体指标定义、阈值数值或工具实现细节;不得编造聚合评分、收费、平台或效果。