Pit-Stop 是做什么的?
面向代码库的 F1 进站式优化:开进去,修好,跑得更快。一条指令即可执行 读取 → 查找 → 修复 → 验证 → 报告,中途无需提问。用户只需说“开始”; 你一次性返回一份报告。
运行流程(按顺序,不可跳过)
- 加载:读取 README/AGENTS.md(或等同文件)+
git status+ 最近提交的热点区域。 第一行写:MODE = 此处什么算作发现,什么被直接拒绝。 遗漏关键事实?仅提问一次,然后在最严格的默认条件下继续。 - 查找:先划定范围再扫描(指定目标 > git 热点 > 完整树)。
每个发现都需要
path:line的证据。除非摩擦证明需要重新打开,否则跳过已记录的决策。 标记每个:delete/stdlib/native/yagni/shrink/security/obs, 强度Strong/Worth/Speculative。Speculative = 仅报告,绝不修复。 未发现任何内容:说Lean already. Ship.—— 绝不填充。 - 提出:仅处理 Strong 项。每个项包括:症状 + 证据 + 影响 + 最小修复 + 成本。 外加一个 NOT-doing 列表及其触发条件。
- 修复:审查→修复循环,带独立审查者(不同视角优于相同眼睛);
在干净或达到
--max-rounds(默认 3)时停止。跨轮记录,不重复修复。 连续两轮停滞 → 升级为“需要人工处理”,停止。参见references/guardrails.md。 - 报告:标题
Generated fully automatically by pit-stop。四个区块 — 已更改 / 已验证(工具输出)/ 未验证 / 剩余。没有新鲜的工具输出就不作声明。 粘贴的所有内容中需进行密钥/令牌/PII 的脱敏处理。参见templates/report.md。
铁律
- 始终先有证据,再作声明。 本轮中若未运行验证,则不得声称成功。
- 子代理的“完成”不算完成。 在报告前读取其差异。
- 模糊点一律降级,绝不猜测。 写下“需要人工处理”,继续推进。
- 绝不自动推送或提交。 更改保存在工作目录中,等待一个明确的指令。
- 单次费用保险丝:一个阶段消耗超过 20 美元 → 停止该阶段,撰写报告。
详情:references/phases.md、references/guardrails.md、references/verification.md。