子エージェント運用 Skill

クイックスタート（3ステップ）

1. 目的と完了条件を1行で決める（何を/いつまでに/どの状態なら完了か）。
2. codex で起動ログを残す（種別・担当範囲・完了条件・想定時間）。依頼メッセージとセットで記録。
3. 実行→即時共有→完了報告（リスク・分岐はリアルタイム共有、完了時は成果物/リスク/次アクションを報告）。コード変更時は必ずレビューエージェントを起動。

役割と責務

• リーダー: ゴールと優先度を明示、タスク分割、子起動の承認、進行監視、次アクション決定。
• 実装: 割り当て範囲のみを担当。障害・リスク・追加分岐は即共有。必要なら子を再分割。
• レビュー: 変更発生時に起動し、問題を指摘。ブロッカーはリーダーに即報告。

いつ起動するか

• Do: 実装/調査/検証で 独立した単位 があり、並行した方が速いとき。
• Do: 高度専門タスク（性能測定、セキュリティ確認など）を分離したいとき。
• Avoid: 依存が強く分離不能、コミュニケーションコストが成果を上回るとき。

標準ワークフロー

1. リーダーがタスクを調査/実装/検証に分類し、優先度と期待成果を整理。
2. 自律実行可能な単位に分割し、必要な専門性ごとに子エージェントを codex で起動（範囲・完了条件・想定時間を記録）。
3. 担当タスク/目的/完了条件/想定時間/連絡方法を明示して割り当て。再分割が要る場合は事前にリーダーへ共有。
4. 実行中の分岐・リスクは即共有。長時間タスクはチェックポイントで中間報告（子の状況も含める）。
5. 完了時に成果物・観測事項・リスク・起動した子の結果を報告し承認を得る。
6. リーダーが次アクション（再調査/追加実装/引継ぎ）を決定しタスク一覧を更新。
7. 不要な子エージェントを停止。並列更新はリーダーが調整。
8. コードを変更/新設した場合はレビューエージェントを起動し、審査結果を共有。

運用チェックリスト

• 開始前: 目的/完了条件/想定時間を決め、依頼メッセージと codex 起動ログを残す。
• 実行中: 仕様不明・互換性リスク・セキュリティ/課金/データ削除を伴う変更は必ずリーダー確認。ブロッカーは即共有。
• 終了時: 成果物（ファイル/ログ）、観測事項、リスク、次アクションをワンメモで報告。不要エージェントは停止。

自律判断と確認

• 要確認: UI/APIが変わる、互換性影響が読めない、セキュリティ/課金/データ削除の高リスク変更。
• 自律可: 文言・ログ改善、小規模スタイル調整、一般原則で自明な実装詳細。迷ったら暫定案を示し確認。

コミュニケーション / レポート

• リスクやブロッカーは即時共有。長時間タスクはチェックポイントごとに現状を送る。
• 起動/停止時は理由・担当範囲・完了状況をワンライナーで残し、タスクログに紐付ける。

報告テンプレート

• タスク報告
  mdCopy

  [目的]
  - XXX の YYY を実装するため
  
  [現状]
  - ZZZ まで完了、AAA が未着手
  
  [問題]
  - ...
  
  [次アクション]
  - ...
  

• 子エージェント起動ログ
  mdCopy

  [子エージェント起動]
  - 種別: 実装 / 調査 / 検証
  - タスクID: TASK-123
  - 担当範囲: ...
  - 完了条件: ...
  - 想定所要時間: ...
  

コマンド運用

• 許可コマンド: codex。起動前に意図を共有し、実行ログは報告に添付する。
• 実装エージェントが自律で子を起動する際も事前にリーダーへ意図共有。
• コード変更/新設時はレビューエージェントを必ず起動し、結果をログに残す。

安全運用とKPI

• 並列更新はリーダーが調整し競合を回避。外部アクセスや高リスク操作は事前承認。
• 長時間タスクはチェックポイントを設定し進捗を可視化。終了時に不要エージェントを停止。
• 定期確認: 再実行率、子エージェントの平均起動/完了時間、PRレビュー指摘件数、重大インシデント件数。