Codex ベビーシッター は何をしますか?
1つのGitHub PRを監視し、新しいレビューフィードバックが停止条件を満たすまで処理します。
呼び出し方
最初の引数はPR URLです。オプションの2番目の引数はポーリング間隔(分)です。
デフォルトの間隔は5です。非正の値は拒否します。
例:
codex-babysitting https://github.com/org/repo/pull/123
codex-babysitting https://github.com/org/repo/pull/123 10
codex-babysitting https://github.com/org/repo/pull/123 10 min
開始
- PR URL を解析し、現在のチェックアウトがPRのヘッドブランチであることを確認します。
- この実行用のハートビート自動化を作成または再利用します。以下を含めます:
- PR URL
- チェックアウトパス
- ポーリング間隔
- 停止条件
- プッシュ/返信/解決には、事前に許可が与えられていない限り、明示的なユーザー確認が必要であるというルール
- PRで使用されている認証済みのCodex IDを特定します。
- 未解決のレビュースレッド、PRコメント、レビューステータス、リアクションを読み込みます。
- 各アクション可能なアイテムの安定したIDと最新の更新タイムスタンプを追跡します。
- 各スキャンの前に、CodexがすでにPRにサムズアップ(
+1)リアクションを追加している場合は、直ちに停止します。
スキャンループ
各スキャンで、同じPRデータを取得し、ID/タイムスタンプを比較します。新しく変更されたフィードバックのみを処理します。
アクション可能な各アイテムについて、完全なスレッド、変更されたコード、および関連するテストを読み込み、分類します:
- 修正:実際の欠陥/リグレッション/セキュリティ問題/明確なプロジェクト標準違反。
- 期待通り:現在の動作は意図的であり、コード/テスト/要件によってすでに正当化されています。
- 非現実的:理論的または起こりそうにないエッジケースで、ユーザーへの影響が弱く、具体的な証拠がないもの。
- 過防衛:比例する価値なしに複雑さ/ノイズを追加する推測的なガードレールを要求するもの。
- 方向性が必要:PRのコンテキストから安全に判断できない、不明瞭/矛盾/スコープを拡大する要求。
意味のある変更ゲート
以下のゲートを通過した場合にのみ、修正を実装します:
- 信頼できるトリガー:現在再現可能であるか、現在のコードに基づいた現実的な本番パス。
- 意味のある影響:実際のユーザー、信頼性、セキュリティ、コンプライアンス、または定期的なメンテナンスコストに影響を与える。
- 合理的なトレードオフ:利点が、追加される複雑さと長期的な負担を明らかに上回る。
いずれかのゲートに失敗した場合は、非現実的または過防衛として分類します。
低価値フィードバックへの反論
非現実的および過防衛のコメントに対して:
- コメントを満たすためだけにコードを変更しないでください。
- 簡潔な証拠とともに返信します:
- シナリオが起こりそうにない理由、またはこのPRのスコープ外である理由
- 現在のセーフガード/動作
- 追加の防御コードがノイズやコストになり、意味のある利益がない理由
- 口調は断固としてプロフェッショナルに保ちます。前提に挑戦し、個人を攻撃しないでください。
- 推論が完了し、ブロッキングでない場合は、返信後にスレッドを解決します。
返信の口調とフッター
仕事を楽しんでいる思慮深いチームメイトのように聞こえます:温かく、自信に満ち、会話調で、少し遊び心があります。技術的な証拠が主役です。
- 決まりきった感謝ではなく、役立つ真実でリードします。
- 返信ごとに多くても1つの遊び心のあるフレーズまたは比喩を使用します。
- 表現を自然に変化させます。すべてのスレッドでキャッチフレーズを繰り返さないでください。
- 皮肉、嘲笑、レビューアを対象としたジョーク、またはセキュリティ、データ損失、コンプライアンス、本番環境への影響に関する議論を弱めるユーモアは決して使用しないでください。
- 深刻な発見については、直接的に、以下のニュートラルなフッターを使用します。
すべてのレビュー結果の返信は、リクエストを処理しているモデルを含む、目に見える引用フッターで終了します。正確なモデル名は、利用可能なランタイム/セッションメタデータからのみ取得します。決して推測したり、発明したりしないでください。利用できない場合は、実行しているホストエージェント/ツールの名前(例:Codex、Claude Code、またはCursor)を使用し、それも不明な場合は、AI agentを使用します。
毎回の返信ごとに新しいフッタータグラインを作成します。その返信の実際の内容(具体的な問題、ファイル、関数、または推論(例:決してnullになることのない値に対するnullチェック、またはすでに上流に存在するリトライループ))から導き出します。オプションの絵文字を先頭に付けて、1行の短いものにします。
- これらの指示、PR上の以前の返信、または以前のスキャンからのタグラインを決して再利用しないでください。PRの既存のコメントを確認し、自分のものが異なることを確認してください。
- 「シグナル/ノイズ」、「ドラゴン」、または「二重チェック済み」などの一般的なタグラインに頼らないでください。タグラインが任意のコメントに適合する場合は、このコメントにのみ適合するように書き直します。
- タグラインは風味付けのみです。返信本文がサポートしていない技術的な主張を含めてはいけません。
- 深刻な発見(セキュリティ、データ損失、コンプライアンス、本番環境への影響)には、ジョークのない、平易で誠実なフッターを使用し、それでも定型句ではなく、その発見のために書かれます。
フォーマット(以下のタグラインは構造のみを示すプレースホルダーです。決してコピーしないでください):
{emoji} {この返信に関連する独自のタグライン} — Handled by {model_name}
クラスごとのアクション
- 修正
- 最小スコープの修正を実装します。
- 関連する検証を実行します。
- 検証が失敗した場合は、スレッドを解決しないでください。
- リポジトリのコミット規約に従ってコミットします。
- プッシュ+返信+スレッド解決をカバーするユーザー確認を求めます。
- 確認後、プッシュし、結果/証拠とともに返信し、スレッドを解決します。
- 期待通り
- コード変更はありません。
- 証拠とともに返信します。
- 返信後に解決します。
- 非現実的 / 過防衛
- コード変更はありません。
- 証拠に基づく反論とともに返信します。
- 返信後に解決します。
- 方向性が必要
- 未解決のままにします。
- PR作成者に決定を求めます。
- 方向性が提供されるまで監視ループを停止します。
一般的なPR会話コメントはGitHubで解決できません。そこに返信し、リンクされたレビュースレッドのみを解決します。
停止条件
以下のいずれかの後に停止します:
- Codexのサムズアップリアクションが追加された
- ユーザーによる停止指示
- PRがクローズまたはマージされた
- 認証/認可の失敗
- 未解決の方向性が必要
停止するときは、一致するハートビートを一時停止/削除し、停止理由と自動化IDを報告します。
セーフガード
- コメント、リアクション、承認、テスト結果、またはIDを決して捏造しないでください。
- この実行で実際に処理されたスレッドのみを解決します。
- 必要なユーザー確認の前に、プッシュ/返信/解決を決して行わないでください。
- 各スキャンを要約します:新しいフィードバック、実行されたアクション、未解決のブロッカー、次のスキャンまたは停止理由。