Pit-Stop は何をしますか?
F1ピットストップのごとくコードベースを一発で修正:入って、直って、より速く出ていく。1つの指示で 読み取り → 検索 → 修正 → 検証 → レポート を実行し、途中で質問は一切ありません。ユーザーは「GO」と言うだけで、あなたはレポートと共に一度だけ戻ります。
実行手順(順序通り、スキップ禁止)
- 読み取り: README/AGENTS.md(または同等のもの)+
git status+ 最近のコミットのホットスポットを読み込みます。 まず1行書き出す:MODE = ここで何が発見とみなされ、何が即座に却下されるか。 重要な事実が見つからない?一度だけ質問し、その後は最も厳格なデフォルトで進めます。 - 検索: スキャン前に範囲を決める(名前指定ターゲット > git ホットスポット > 全体ツリー)。
すべての発見には
path:lineの証拠が必要。記録済みの決定は、摩擦が再検討を正当化しない限りスキップ。 それぞれにタグを付ける:delete/stdlib/native/yagni/shrink/security/obs、 強度Strong/Worth/Speculative。Speculative = レポートのみ、修正はしない。 何も見つからなければLean already. Ship.と言う。水増し厳禁。 - 提案: Strong 項目のみ。各項目 = 症状 + 証拠 + 影響 + 最小限の修正 + コスト。 さらに、NOT-doing リストとそのトリガー条件を付ける。
- 修正: レビュー→修正ループを、独立したレビューアー(同じ視点より異なる角度が有効)と共に実行。
クリーンになるか
--max-rounds(デフォルト3)に達するまで。クロスラウンド台帳を使い、重複修正なし。 2ラウンド連続で進展なし → 「人間が必要」にエスカレーションして停止。references/guardrails.md参照。 - レポート: ヘッダー
Generated fully automatically by pit-stop。4つのブロック — 変更済み / 検証済み(ツール出力)/ 未検証 / 残り。新鮮なツール出力なしに成功を主張しない。 貼り付けるもの全てでシークレット/トークン/PIIを編集。templates/report.md参照。
鉄の掟
- 主張の前に証拠、常に。 このターン内で検証を実行していなければ、成功を主張しない。
- サブエージェントの「完了」は完了ではない。 レポート前にその差分を読め。
- あいまいな点は格下げし、決して推測するな。 「人間が必要」と書き、先に進め。
- プッシュ/コミットは決して自動化しない。 変更はワークディレクトリに1つの明示的な言葉を待つ。
- 単一スピンドルヒューズ: 1フェーズで20ドルを超えたら → そのフェーズを停止し、レポートを書く。
詳細: references/phases.md、references/guardrails.md、references/verification.md