Community写作与编辑github.com

Pit-Stop

F1 进站式代码库优化:一条指令完成读取、查找、修复、验证、报告

Pit-Stop 是什么?

Pit-Stop 是一个非常高效的 AI 代理技能,专为代码库的快速检查和修复而设计。它模拟了 F1 赛车的进站流程,允许用户通过单个指令自动执行读取代码库、查找问题、提出修复、验证修改并生成报告的全过程,且中途无需人工干预。该技能支持所有主流 AI 开发平台(如 Claude Code, Cursor, Codex 等),因为它是一个纯提示词驱动的技能定义。其核心价值在于强制遵循严格的证据链和迭代验证,确保修复可靠且不会引入新问题,同时通过费用上限和自动降级机制(“需要人工处理”)来保证安全性。对于希望自动化代码审查和清理工作流的开发者来说,Pit-Stop 是一种既严谨又省时的工具。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Finn763/pit-stop

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Pit-Stop 是做什么的?

面向代码库的 F1 进站式优化:开进去,修好,跑得更快。一条指令即可执行 读取 → 查找 → 修复 → 验证 → 报告,中途无需提问。用户只需说“开始”; 你一次性返回一份报告。

运行流程(按顺序,不可跳过)

  1. 加载:读取 README/AGENTS.md(或等同文件)+ git status + 最近提交的热点区域。 第一行写:MODE = 此处什么算作发现,什么被直接拒绝。 遗漏关键事实?仅提问一次,然后在最严格的默认条件下继续。
  2. 查找:先划定范围再扫描(指定目标 > git 热点 > 完整树)。 每个发现都需要 path:line 的证据。除非摩擦证明需要重新打开,否则跳过已记录的决策。 标记每个:delete/stdlib/native/yagni/shrink/security/obs, 强度 Strong/Worth/Speculative。Speculative = 仅报告,绝不修复。 未发现任何内容:说 Lean already. Ship. —— 绝不填充。
  3. 提出:仅处理 Strong 项。每个项包括:症状 + 证据 + 影响 + 最小修复 + 成本。 外加一个 NOT-doing 列表及其触发条件。
  4. 修复:审查→修复循环,带独立审查者(不同视角优于相同眼睛); 在干净或达到 --max-rounds(默认 3)时停止。跨轮记录,不重复修复。 连续两轮停滞 → 升级为“需要人工处理”,停止。参见 references/guardrails.md。
  5. 报告:标题 Generated fully automatically by pit-stop。四个区块 — 已更改 / 已验证(工具输出)/ 未验证 / 剩余。没有新鲜的工具输出就不作声明。 粘贴的所有内容中需进行密钥/令牌/PII 的脱敏处理。参见 templates/report.md。

铁律

  • 始终先有证据,再作声明。 本轮中若未运行验证,则不得声称成功。
  • 子代理的“完成”不算完成。 在报告前读取其差异。
  • 模糊点一律降级,绝不猜测。 写下“需要人工处理”,继续推进。
  • 绝不自动推送或提交。 更改保存在工作目录中,等待一个明确的指令。
  • 单次费用保险丝:一个阶段消耗超过 20 美元 → 停止该阶段,撰写报告。

详情:references/phases.md、references/guardrails.md、references/verification.md。

相关技能