coding-agent

• 新機能やアプリの構築・作成 — coding-agent にコードベースを探索させ、インラインでパッチを当てるのではなく、エンドツーエンドで実装させる。
• プルリクエストのレビュー — 一時的なクローンまたは git worktree にエージェントを起動し、変更を安全に差分確認・分析・要約できるようにする。
• 大規模コードベースのリファクタリング — 多数のファイルにまたがるコンテキストを必要とする複数ファイルの変更は、プロジェクトツリーを横断できるエージェントが有効。
• 並行したイシューの修正 — git worktree を使って複数のエージェントを同時に実行し、イシューごとに1つのエージェントを割り当て、各ブランチからPRを作成する。

• シンプルな一行修正 — 変更が明確かつ局所的な場合は、ファイルを直接編集してください。エージェントを起動すると不要なオーバーヘッドが生じます。
• 読み取り専用のコード調査 — フルの coding-agent を起動するのではなく、read/grep ツールを使用してコードを調べてください。
• ~/clawd またはライブの OpenClaw ワークスペース内での作業 — エージェントはオーケストレーター自身の作業ディレクトリ内で起動してはなりません。
• スレッドにバインドされた ACP ハーネスリクエスト — Discord スレッドや類似の ACP コンテキスト内で Codex/Claude Code を起動または実行する必要がある場合は、代わりに runtime:"acp" を指定した sessions_spawn を使用してください。

4つの異なるcoding-agentをサポートし、それぞれに対して正しい起動パターンを提供します。CodexとPiはインタラクティブなターミナル動作のためにpty:trueが必要です。Claude Codeはクリーンな非PTY実行のために--print --permission-mode bypassPermissionsを使用します。

長時間実行するタスクは background:true を指定して起動でき、sessionId が返されます。その後、プロセスツールのアクションを使用して、ステータスのポーリング、ログのストリーミング、標準入力の送信、またはセッションの終了を行うことができます。これにより、処理をブロックすることなくユーザーへの情報提供を継続できます。

workdir を設定することで、エージェントが正しいプロジェクトフォルダで起動し、無関係なファイルに迷い込まないようにします。これは PR レビューや並行イシュー修正において非常に重要です。

イシューごとに独立したgit worktreeを作成し、それぞれに専用のエージェントを起動して並行監視を行い、メインブランチに触れることなくPR作成用の個別ブランチをプッシュします。

エージェントのプロンプトに openclaw system event コマンドを追記することで、タスクが完了した際にオーケストレーターが次のハートビートポーリングを待たずに即座にウェイクイベントを受信できるようになります。

レビューは常に一時的なクローンまたはgit worktreeで実行され、ライブプロジェクトフォルダでは決して行われません。これにより、誤ったブランチのチェックアウトやアクティブなコードベースへの変更を防ぎます。

workdir と明確な機能プロンプトを使って、Codex または Claude Code エージェントをプロジェクトディレクトリに向けます。エージェントはコードベースを調査し、複数のファイルにまたがって機能を実装してコミットします。その間、あなたは process action:log を通じて進捗を監視できます。

開いているすべてのPRのrefを取得し、バックグラウンドモードでPRごとに1つのCodexプロセスを起動し、それぞれのレビュー結果を収集して、gh CLIを使用してGitHubコメントとして投稿します — すべて並列で実行されます。

オープンな問題ごとにgit worktreeを作成し、各worktreeでエージェントを起動して進捗を監視した後、ブランチをプッシュしてレビュー用のPRを開くことで、修正時間を大幅に短縮できます。

既存のプロジェクトがない状態でクイックな一発プロンプトを試したい場合は、一時ディレクトリを作成して git init を実行し、coding-agent に自己完結したタスクを実行させましょう — 完了したらそのディレクトリを破棄するだけです。