Brooks-Sweep 是 Brooks-Lint 中的全量扫描(Full Sweep)模式,用于对代码库进行跨质量维度的统一分析,并直接应用修复。
用途 该模式面向需要一次性全面体检并修复代码质量的场景,覆盖四个质量维度:代码腐化(code decay)、架构(architecture)、技术债务(tech debt)和测试质量(test quality)。
主要能力
- 统一扫描:在四个质量维度上运行统一分析。
- 直接修复:在分析后直接对代码应用修复。
- 迭代验证:对修改过的文件及其调用方进行迭代,直到出现干净的一轮或达到上限。
- 报告输出:汇总残留与无法解决的问题,输出 Full Sweep Report,报告中的模式行标记为 Full Sweep。
使用方式 按顺序阅读以下资料:
- ../_shared/common.md —— Iron Law、Project Config、Report Template、Health Score
- ../_shared/source-coverage.md —— book coverage、exceptions、tradeoffs
- ../_shared/decay-risks.md —— production risk symptoms
- ../_shared/test-decay-risks.md —— test risk symptoms
- sweep-guide.md(本目录)—— 统一扫描与修复流程
流程步骤:
- 范围:若用户未指定项目或目录,先应用 Auto Scope Detection(见 ../_shared/common.md)。
- 展示预检同意通知,等待一次性批准(指南 Step 0)。
- 枚举范围并初始化流水线状态(指南 Step 1)。
- 按顺序运行四个维度——review、test、debt、audit——每个维度执行扫描、分类、修复和验证(指南 Steps 2–5)。
- 对修改过的文件及其调用方进行迭代,直到出现干净的一轮或达到上限(指南 Step 6)。
- 汇总残留与无法解决的问题,输出 Full Sweep Report(指南 Steps 7–8)。
适用场景 适用于希望对代码库进行全维度质量扫描并自动修复的项目或目录。若用户未指定范围,工具会先进行自动范围检测。
限制
- 需要先展示预检同意通知并获得一次性批准后才能继续。
- 迭代修复存在上限,达到上限后停止。
- 部分问题可能无法解决,会在报告中作为残留项汇总。
- 具体收费、价格、平台支持等信息暂未提供。