Community寫作與編輯github.com

Finn763/pit-stop

F1 維修站風格的程式碼庫加速器:一條指令就能完成讀取、搜尋、修正、驗證、報告

pit-stop 是什麼?

Pit-Stop 是一個專為開發者與 AI 代理器設計的高效程式碼庫維護工具。使用者只下達一次指令,便能自動執行「讀取 → 搜尋 → 修正 → 驗證 → 報告」的完整循環,過程中不會有任何中斷提問,最後提交一份清晰的報告。此工具支援 Claude Code、Cursor 等代理器平台,並特別注重證據驅動的決策——任何修正都必須搭配對應的驗證輸出,避免未經驗證的成功宣稱。其內部規則要求強制分階段執行(載入、搜尋、提案、修正、報告),且設有嚴格的護欄:例如自動禁止推送與提交、獨立審查者機制,以及單一階段超過 20 美元的費用熔斷。Pit-Stop 還透過標籤系統(如 Strong/Worth/Speculative)對發現進行分級,僅對強度為「Strong」的項目進行修改,其餘只寫入報告。若在修正階段連續兩輪無進展,則會自動升級為「需要人類介入」,確保自動化流程不會無限停滯。總之,Pit-Stop 是讓程式碼庫像 F1 賽車進站一般快速維護的利器。

相容平台~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. 報告:標題「由 pit-stop 全自動產生」。四個區塊—— 已變更 / 已驗證(工具輸出)/ 未驗證 / 剩餘。沒有新鮮工具輸出的宣稱一律不成立。 所有貼上的內容皆需執行密碼/令牌/PII 編輯。詳見 templates/report.md。

鐵律

  • 永遠要先有證據,才下結論。 本輪未執行驗證 = 不可宣稱成功。
  • 子代理的「完成」不等於完成。 在報告前先讀取其 diff。
  • 模糊處須降級,絕不猜測。 寫「需要人類」,繼續前進。
  • 推送/提交永不自動。 變更停留在工作目錄中,待一個明確的指令。
  • 單一花費保險絲:單一階段花費超過 20 美元 → 停止該階段,撰寫報告。

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

相關技能