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。 - 報告:標題「由 pit-stop 全自動產生」。四個區塊——
已變更 / 已驗證(工具輸出)/ 未驗證 / 剩餘。沒有新鮮工具輸出的宣稱一律不成立。
所有貼上的內容皆需執行密碼/令牌/PII 編輯。詳見
templates/report.md。
鐵律
- 永遠要先有證據,才下結論。 本輪未執行驗證 = 不可宣稱成功。
- 子代理的「完成」不等於完成。 在報告前先讀取其 diff。
- 模糊處須降級,絕不猜測。 寫「需要人類」,繼續前進。
- 推送/提交永不自動。 變更停留在工作目錄中,待一個明確的指令。
- 單一花費保險絲:單一階段花費超過 20 美元 → 停止該階段,撰寫報告。
詳情:references/phases.md、references/guardrails.md、references/verification.md。