トラブルシューティング

スレッド上限に達した

スレッドやエージェント上限で spawn に失敗したら:

1. まず完了済みエージェントを閉じます。
2. まだ必要なエージェントだけ再試行します。
3. それでも厳しければ 3-4 並列から 2 並列へ落とします。

wait がタイムアウトした

wait が最終状態になる前に戻ってきたら:

1. その結果が今のクリティカルパスで本当に必要かを判断します。
2. 必要なければ、先にローカルで進められる作業を進めます。
3. 本当にブロックしている場合だけ、1 回だけ長めに待つか、より短いプロンプトで再試行します。

エージェントが Interrupted で返ってきた

よくある原因:

• プロンプトが長すぎる
• fork_context が不要だった
• 終了条件が曖昧だった

プロンプトを短くし、必要性が証明されるまで fork_context: false を維持し、1 つの境界が明確な成果物だけを返すよう依頼します。

モデル名が見えない

実行時メタデータからモデル名が読めないことがあります。そのときは次の表現が安全です。

The subagent was requested with model `gpt-5.3-codex-spark`, but runtime metadata did not expose the active model name directly.

リカバリーは地味に

このスキルの狙いは、失敗時に派手になることではなく、安定した並列化です。思いつきで複雑化するより、再試行を小さくし、担当範囲を明確にし、同時起動数を減らす方がうまくいきます。