SuperAPI AI 工具集

brooks-sweep

编程与开发

查看项目

更新于 10-15 14:31

技能介绍

Brooks-Sweep 是 Brooks-Lint 中的全量扫描(Full Sweep)模式,用于对代码库进行跨质量维度的统一分析,并直接应用修复。

用途 该模式面向需要一次性全面体检并修复代码质量的场景,覆盖四个质量维度:代码腐化(code decay)、架构(architecture)、技术债务(tech debt)和测试质量(test quality)。

主要能力

  • 统一扫描:在四个质量维度上运行统一分析。
  • 直接修复:在分析后直接对代码应用修复。
  • 迭代验证:对修改过的文件及其调用方进行迭代,直到出现干净的一轮或达到上限。
  • 报告输出:汇总残留与无法解决的问题,输出 Full Sweep Report,报告中的模式行标记为 Full Sweep。

使用方式 按顺序阅读以下资料:

  1. ../_shared/common.md —— Iron Law、Project Config、Report Template、Health Score
  2. ../_shared/source-coverage.md —— book coverage、exceptions、tradeoffs
  3. ../_shared/decay-risks.md —— production risk symptoms
  4. ../_shared/test-decay-risks.md —— test risk symptoms
  5. 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)。

适用场景 适用于希望对代码库进行全维度质量扫描并自动修复的项目或目录。若用户未指定范围,工具会先进行自动范围检测。

限制

  • 需要先展示预检同意通知并获得一次性批准后才能继续。
  • 迭代修复存在上限,达到上限后停止。
  • 部分问题可能无法解决,会在报告中作为残留项汇总。
  • 具体收费、价格、平台支持等信息暂未提供。