コーディングエージェント (常にバックグラウンド)

すべてのコーディングエージェント作業に bash と background:true を使用します。 ここではフォアグラウンドのワンショットパスは使用しないでください。 エージェントを開始し、sessionId を取得し、process で監視し、完了時にワーカーがユーザーに直接通知することを要求します。

⚠️ PTYモード: Codex/Pi/OpenCodeはyes、Claude Codeはno

Codex、Pi、OpenCode の場合、PTYが必須です:

# Codex/Pi/OpenCode の正しい方法
bash pty:true background:true command:"codex exec 'Your prompt'"

Claude Code (claude CLI) の場合は、代わりに --print --permission-mode bypassPermissions を使用します。 Claude Code ではここで PTY を使用しないでください。

# Claude Code の正しい方法
bash background:true command:"claude --permission-mode bypassPermissions --print 'Your task'"

# Claude Code の誤った方法 (PTY、不正なフラグ、バックグラウンドなし)
bash pty:true command:"claude --dangerously-skip-permissions 'task'"

Bash ツールパラメータ

パラメータ	タイプ	説明
command	string	実行するシェルコマンド
pty	boolean	Codex/Pi/OpenCode に使用
workdir	string	作業ディレクトリ
background	boolean	このスキルでは常に true
timeout	number	タイムアウト(秒)
elevated	boolean	サンドボックスではなくホストで実行(許可された場合)

Process ツールアクション

アクション	説明
list	すべての実行中/最近のセッションをリスト表示
poll	セッションがまだ実行中かチェック
log	セッション出力を取得(オプションでオフセット/制限)
write	stdin に生データを送信
submit	データ + 改行を送信(入力して Enter を押す場合と同様)
send-keys	キートークンまたは 16 進バイトを送信
paste	テキストを貼り付け(オプションでブラケットモード)
kill	セッションを終了

---

必須パターン

すべてのコーディングエージェント実行は次のパターンに従います:

1. ワーカーをスポーンする前に、現在の会話から通知ルートをキャプチャします:
   • notifyChannel
   • notifyTarget
   • notifyAccount (該当する場合)
   • notifyReplyTo (特定のメッセージに返信する場合)
   • notifyThreadId (Telegram トピック / Slack スレッド(該当する場合))
2. background:true でコーディング CLI を即座に開始します。
3. 通知ルートをワーカープロンプトに含め、完了時に openclaw message send を呼び出すようワーカーに要求します。
4. process action:log / poll で監視します。
5. ワーカーが通知前に入力が必要な場合またはエラーが発生した場合は、明示的に自分で対応します。ハートビートに頼らないでください。

信頼できる通知ルートがない場合は、そのことを説明し、完了がユーザーに自動的に通知されることを主張しないでください。

---

通知ルート

以下に依存しないでください:

• openclaw system event
• tools.exec.notifyOnExit
• ハートビート配信
• HEARTBEAT.md

代わりに直接アウトバウンド完了メッセージを使用します:

openclaw message send --channel <channel> --target '<target>' --message '<text>'

オプションのルーティングフラグは、本当に該当する場合のみ追加します:

• --account <id>
• --reply-to <messageId>
• --thread-id <threadId>

openclaw message send は直接アウトバウンド送信です。ハートビートが有効になっていることに依存しません。

完了プロンプトスニペット

すべてのワーカープロンプトに以下のようなものを追加します:

Notification route for completion:
- channel: <notifyChannel>
- target: <notifyTarget>
- account: <notifyAccount or omit>
- reply_to: <notifyReplyTo or omit>
- thread_id: <notifyThreadId or omit>

When the task is completely finished, send exactly one completion message back to the user with openclaw message send using that route.
If the task fails fatally, send exactly one failure message back to the user with openclaw message send using that route.
Do not use openclaw system event. Do not rely on heartbeat. Do not skip the completion/failure message.

完了コマンドテンプレート

openclaw message send \
  --channel <notifyChannel> \
  --target '<notifyTarget>' \
  --message 'Done: <brief summary>'

オプションの追加:

  --account <notifyAccount> \
  --reply-to <notifyReplyTo> \
  --thread-id <notifyThreadId>

---

クイックスタート

スクラッチ Codex 作業の場合は、まず一時的な git リポジトリを作成してから、完了ルートをプロンプトに注入した状態でワーカーをバックグラウンドで開始します:

SCRATCH=$(mktemp -d)
cd "$SCRATCH" && git init

bash pty:true workdir:$SCRATCH background:true command:"codex exec 'Your prompt here.

Notification route for completion:
- channel: <notifyChannel>
- target: <notifyTarget>
- account: <notifyAccount or omit>
- reply_to: <notifyReplyTo or omit>
- thread_id: <notifyThreadId or omit>

When the task is completely finished, send exactly one completion message back to the user with openclaw message send using that route.
If the task fails fatally, send exactly one failure message back to the user with openclaw message send using that route.
Do not use openclaw system event. Do not rely on heartbeat. Do not skip the completion/failure message.'"

Codex は信頼できる git ディレクトリの外では実行を拒否します。 以下のすべての例で同じ通知ルート注入ブロックを再利用します。タスク固有のプロンプト本文のみ変更してください。

---

Codex CLI

モデル: gpt-5.2-codex がデフォルト(~/.codex/config.toml に設定)

フラグ

フラグ	効果
exec "prompt"	ワーカー CLI 内でのワンショット実行
--full-auto	サンドボックス化されているが、ワークスペース内で自動承認
--yolo	サンドボックスなし、承認なし

ビルド/作成

# 常にバックグラウンドで即座に開始
bash pty:true workdir:~/project background:true command:"codex exec --full-auto 'Build a dark mode toggle'"

# より自律的
bash pty:true workdir:~/project background:true command:"codex --yolo 'Refactor the auth module'"

PR をレビューする

OpenClaw 自体のプロジェクトフォルダ内で PR をレビューしないでください。 一時フォルダにクローンするか、ワークツリーを使用します。

REVIEW_DIR=$(mktemp -d)
git clone https://github.com/user/repo.git $REVIEW_DIR
cd $REVIEW_DIR && gh pr checkout 130

bash pty:true workdir:$REVIEW_DIR background:true command:"codex review --base origin/main"

または:

git worktree add /tmp/pr-130-review pr-130-branch
bash pty:true workdir:/tmp/pr-130-review background:true command:"codex review --base main"

バッチ PR レビュー

git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*'

bash pty:true workdir:~/project background:true command:"codex exec 'Review PR #86. git diff origin/main...origin/pr/86'"
bash pty:true workdir:~/project background:true command:"codex exec 'Review PR #87. git diff origin/main...origin/pr/87'"

process action:list
process action:log sessionId:XXX

---

Claude Code

bash workdir:~/project background:true command:"claude --permission-mode bypassPermissions --print 'Your task'"

---

OpenCode

bash pty:true workdir:~/project background:true command:"opencode run 'Your task'"

---

Pi コーディングエージェント

# インストール: npm install -g @earendil-works/pi-coding-agent
bash pty:true workdir:~/project background:true command:"pi 'Your task'"

# 非対話モード
bash pty:true workdir:~/project background:true command:"pi -p 'Summarize src/'"

# 異なるプロバイダ/モデル
bash pty:true workdir:~/project background:true command:"pi --provider openai --model gpt-4o-mini -p 'Your task'"

---

git ワークツリーを使用した並列問題修正

git worktree add -b fix/issue-78 /tmp/issue-78 main
git worktree add -b fix/issue-99 /tmp/issue-99 main

bash pty:true workdir:/tmp/issue-78 background:true command:"pnpm install && codex --yolo 'Fix issue #78: <description>. Commit and push after review. Send the completion message with openclaw message send using the provided notify route.'"
bash pty:true workdir:/tmp/issue-99 background:true command:"pnpm install && codex --yolo 'Fix issue #99 from the approved ticket summary. Implement only the in-scope edits. Send the completion message with openclaw message send using the provided notify route.'"

process action:list
process action:log sessionId:XXX

---

⚠️ ルール

1. エージェントごとに正しい実行モードを使用:
   • Codex/Pi/OpenCode: pty:true
   • Claude Code: --print --permission-mode bypassPermissions (PTY 不要)
2. ツール選択を尊重 - ユーザーが Codex を要求した場合は Codex を使用します。
   • オーケストレーターモード: 自分で手動でパッチをコーディングしないでください。
   • エージェントが失敗/ハング した場合は、それを再スポーンするか、ユーザーに指示を求めますが、静かに引き継がないでください。
3. 忍耐強く - セッションが「遅い」からといって殺さないでください
4. process:log で監視 - 進捗を確認しながら干渉しない
5. ビルドには --full-auto - 変更を自動承認
6. レビューには vanilla - 特別なフラグは不要
7. 並列は OK - バッチ作業用に多くの Codex プロセスを同時に実行
8. OpenClaw の状態ディレクトリ内で Codex を開始しないでください ($OPENCLAW_STATE_DIR、デフォルト ~/.openclaw) - ソウルドキュメントを読み、組織図について奇妙な考えを持つようになります!
9. ~/Projects/openclaw/ でブランチをチェックアウトしないでください - これはライブ OpenClaw インスタンスです!
10. スポーンする前に、常に完了プロンプトスニペットをワーカープロンプトに注入します。 簡潔にするため、以下の簡略化された例はそれを省略しています — ワーカーなしでスポーンしないでください。

---

進捗更新 (重要)

バックグラウンドでコーディングエージェントをスポーンするとき、ユーザーをループ内に保ちます。

• 開始時に 1 つの短いメッセージを送信: 実行内容と場所。
• 何かが変わった場合のみ更新:
  • マイルストーン完了
  • ワーカーが質問する
  • エラーが発生するか、ユーザーのアクションが必要
  • ワーカーが完了
• セッションを終了した場合は、即座にそのことと理由を述べます。
• ワーカーが openclaw message send で自動通知する予定の場合は、開始時の更新で明確に述べます。

これにより、ユーザーが返信の欠落のみを見て、何が起こったのか全く知らないという事態を防ぎます。

---

ルール

1. 常にバックグラウンドで即座に開始します。
   • すべてのコーディングエージェント起動に background:true を使用します。
   • このスキルではフォアグラウンドのワンショットパスを使用しないでください。
2. エージェントごとに正しい実行モードを使用します。
   • Codex/Pi/OpenCode: pty:true
   • Claude Code: --print --permission-mode bypassPermissions
3. ツール選択を尊重します。
   • ユーザーが Codex を要求した場合は、Codex を使用します。
   • オーケストレーターモード: リクエストされたコーディングエージェントを使用する代わりに、自分で手動でパッチをコーディングしないでください。
4. スポーン前に通知ルーティングをキャプチャします。
   • 完了メッセージには実際のルートが必要です。
5. 直接完了メッセージングを使用します。
   • openclaw message send が必須です。
   • openclaw system event またはハートビートに依存しないでください。
6. 静かに引き継がないでください。
   • ワーカーが失敗またはハング した場合は、それを再スポーンするか、指示を求めます。静かに手編集に切り替えないでください。
7. process で監視します。
   • process action:log はデフォルトの低摩擦チェックです。
8. 忍耐強くいます。
   • セッションが遅いからといって終了しないでください。
9. 並列は OK です。
   • 多くのバックグラウンド Codex セッションを同時に実行できます。
10. ~/.openclaw/ で Codex を開始しないでください。
11. ~/Projects/openclaw/ でブランチをチェックアウトしないでください。

---

学習

• PTY は Codex/Pi/OpenCode にとって本質的です。
• Git リポジトリが必須: Codex は信頼できる git ディレクトリが必要です。
• バックグラウンドオーケストレーションの下で exec を使用: 短いタスクと長いタスクは同じパスに従うようになりました。
• submit vs write: 入力と Enter を送信する場合は submit を使用します。
• ハートビートを超える直接メッセージ送信: ユーザーに直ちに通知する必要があり、ハートビートが無効な可能性がある場合の完了通知に最適です。