OpenClaw PR メンテナー は何をしますか?
- 要求されたIssue/PR操作のみ。ルート
AGENTS.md: 修復、プロダクト、ソース信頼、承認ポリシー。このスキル: GitHubワークフローとメンテナー権限。
- 貼り付けられた参照 ≠ 公開許可またはスコープ拡張。
メンテナー権限
- 赤
main は緊急事態であり、無関係なマージの前提条件ではない。 修復スコープ内で、証明された赤main修正を直接mainにプッシュします。無関係または既存のCIにもかかわらず、スコープ指定されたメンテナーの指示でマージするには、承継失敗例外を選択してください。特別な文言、承認の再取得、または無関係なメインCIの修復/再実行を要求しないでください。人間の承認、失敗の証拠、保護された書き込み者の実行能力は別々のチェックです。
- 修復とマージの権限には、内部スケジューリング、データベース登録、ライフサイクル設計、リスク、検証が含まれます。タスク内のバグ修正(互換性のあるSDK修正を含む)および無効または到達不能なデータのみを削除するバックアップされた修復は、再承認を必要としません。
- 50項目を超える一括クローズ/再オープンには、明示的な数とスコープが必要です。
- アドバイザリワークフローには、明示的なセキュリティリクエストが必要です。
- Peter指示によるチーム更新は、リリースデプロイヤーを使用します。その所有者以外はライブ状態を決して編集しないでください。すべてのデプロイ/再起動についてNight Watchに通知します。Night Watchは再起動のタイミングを調整しますが、更新の承認は行いません。
スコープを選択する
- レビュー/トリアージ/一覧表示: 読み取り専用。変更点/発見事項/証拠/不確実性を説明します。編集、割り当て、ラベル、コメント、クローズには権限が必要です。
- 修正のみ: ローカルで調査/修復/検証します。公開には出荷/マージまたはスコープ指定された同等のものが必要です。
- マージ/出荷/自律修復: ソース証明 → レビュー → ネイティブ送信 → 検証済みマージ。保留中のリクエストを追跡します。同じ権限下でPR起因のCI/競合を修復し、帰属する承継失敗は上記の例外を経由してルーティングします。受け入れられた自動マージ ≠ 完了。クレジット/無関係な作業を保持します。ルートゲートは残り、定型的な許可は繰り返しません。
- キュー/発見: トリアージを読みます。ライブ読み取り/共有発見をバッチ処理します。名前付きPR ≠ キュースイープ。
- 作成者/回帰帰属: 作成者と来歴調査。アカウントの経過期間/履歴条件付き。
- リーダーが実践的であり、有効なワーカー数を制限し、チェックアウト/参照とGitHub書き込みを直列化します。内部サブタスクを隠すユーザー所有のアプリタスクはありません。引き継ぎ/再割り当て前に、スタックしたワーカーのパッチ/クレーム/証拠を保持します。
実際のアイテムを検査する
git status -sb から開始します。無関係な作業を保持します。ローカル gitcrawl → PATH ghx、狭いライブJSON。古い/欠落したアーカイブ → ghx、広範な同期は不要。PRソース: ghx pr view/diff + チェックアウト。Web検索は使用しません。
ghx pr view <pr> --repo openclaw/openclaw \
--json number,title,state,body,author,assignees,baseRefName,headRefName,headRefOid,files,comments,reviews
ghx issue view <issue> --repo openclaw/openclaw \
--json number,title,state,body,author,assignees,comments
- 割り当て: トリアージを参照し、深い作業の前に行います。他の担当者に言及し、所有権を保持します。アカウント/活動調査は条件付きです。
結果を確定する
- 所有者、エントリポイント、呼び出し元、兄弟、テスト、ドキュメント、履歴、現在のmainを読みます。決定論的な依存関係契約を検査します。Codex: ルートの個人的なソース検査。矛盾する証拠 → 防御する前に調査します。でっち上げのマトリックス/代替案はありません。
- 既に修正済み: 現在のmainでの修復を証明します。正規のコミット/PR + 一致するソース/実行可能な証拠。クローズ権限 → 証拠をコメント + クローズ。それ以外の場合は報告します。
- 実際の欠陥: 再現 → 所有不変条件を修復 → パス/兄弟を証明します。症状ガードよりも単純化。サイズ/LOC ≠ 正当性のゲート。
- 有用なPR: 編集可能なブランチを改善します。安全でない場合 → クローズ前に権限のあるクレジット付き代替案を作成します。置き換えられた祖先 → メンテナー所有の代替案。貢献者のPRを決してスカッシュしません。
- 不確実/プロダクト決定: ギャップを述べます。推測によるマージや自動的なスコープ外クローズはしません。
- 証明 + ソース信頼/ホストルート:
$openclaw-testing、ランディング。焦点を絞った証明 → 準備完了のPR。PR CI = 広範な証明。資格のある利用可能なホストでの、境界を限定したローカル証明を優先します。計画的なリモート証明は、高コストなチェックや環境のギャップをカバーできます。キュー → タスク所有の割り当てを停止し、PR CIまたは安全なローカルスコープを使用し、カバーされていない要件を保持します。信頼できないソースをローカルで決して実行しません。オプションのライブギャップ → 意味のある境界証明 + 制限。明示的なライブ、外部API、認証リスク証明は必須です。モック/スキップ/古いヘッド ≠ ライブ。
- 動作変更: 境界証明契約 +
$test-audit。要求された動作とリポジトリ標準: 別々に確認します。
CODEOWNERSレビュー
CODEOWNERS がレビューをルーティングします。ライブ適用を検査します。制限付き/セキュリティパス + 重要なプロダクト/動作/セキュリティ/所有権の変更は、リストされた所有者の関与が必要です。
- 所有権/レビューガバナンス: 検証済みのアクティブな組織管理者の指示も資格があります。リポジトリ管理者/バイパスだけでは資格はありません。どちらのルートも強制レビューを免除しません。
レビューと公開
- 重要なコードをコミットまたはマージする前: 許可されたワークフローを通じて新鮮なレビュー。ユーザーがオプトアウトしない限り、実行可能な所見を解決します。実行可能 = 可能性が高いまたは影響が大きい。可能性が低く、回復可能で、修正が不釣り合いに複雑になるエッジケースは、1行の理由とともに辞退します。
- 重要なコードのコミット/マージ: 選択されたローカルレビュールートを使用し、検証済みの実行可能な所見を解決します。必要な新鮮な独立レビューは引き続き適用されます。レビューのみ: 要求された場合にのみ独立パス。追加の必須CLIパスは不要。
- 実質的な変更/未解決の懸念がある場合はレビューを再開します。パッチ同一のリベース/機械的なヘッド変更では再開しません。実際の人間/ボットの所見に対処します。却下を説明します。ボットスコア/ランクアップリストは別個の義務を生じません。ClawSweeperは助言的。マージのためにコメントを待つことはありません。
- 現在のPRテンプレート: プレーンな問題/影響。インベントリは差分/詳細に。リスク、移行、アクション、証拠、ギャップ、クレジットを最新に保ちます。重要なトレードオフを説明します。内部利用者の利益や普遍的なLOC/来歴/代替修正のエッセイを作成しません。
CHANGELOG.md はリリース所有。PR/コミットにリリースノートコンテキスト。エージェントのトランスクリプトは明示的な要求があった場合のみ。
- 公開変更: 作成者/コミッター + 書き込み者を検証します。実際の
--body-file <path> ペイロードで ghx を使用します。stdin(--body-file -、--input -、/dev/stdin)は使用しません。プロキシはstdinを転送しません。変更されたボディを ghx --no-cache で読み戻し、正確な空でないバイト数を検証します。許可されたスコープのみ。既存のコメント/ボディを更新し、重複は作成しません。
- 公開/マージ: ランディング(メディア、正確なヘッドCI、ネイティブワークフロー)を読みます。
- リモートマージ/クローズ + ソースを検証します。問題、所有する変更、証拠/ギャップ、クレジット、リンクされた最終状態を散文で報告します。価値のあるフォローアップのみ。
最終化とクリーンアップ
- ライブセッションのカレントディレクトリを保持しているワークツリー(自身のものやサブディレクトリを含む)を決して削除しません。子の
cd/cwdオーバーライドは親を移動しません。所有者が終了/解放するまで保持し、パスを報告します。
- 検証済みの結果 → タスクログ、レシート、証明アーカイブ、
.crabbox、スクラッチ、完了したワークツリーをネイティブクローズアウトを介して削除します。削除のためだけの保持/アーカイブ/エクスポート/ハンドオフは行いません。
- 作成したワークツリーは、作業/PRがマージされた後、すぐに次に必要な場合を除き削除します。ライブcwdのワークツリーを決して削除しません。
- すべてのタスク: 所見はチャット/stdoutに。ファイルは成果物/ツール/証明/リカバリのためにのみ、目的/再利用を記載します。マージ前の証明は必須。オプションのフォローアップが完了を妨げることはありません。
- 要求された成果物/保持、未完了のソース + 必要なリカバリ状態、アクティブ/ライブ/不明な所有者、認証情報、エージェント状態、共有依存関係を保持します。