タスクが失敗します。ほとんどのエラーは設定や仕様書の問題であり、不可解なものではなく、ごく少数のパターンに分類されます。
まずは、処理が停止した箇所を確認してください。
実行ログには、どのステージで失敗したかが記載されています。この単一の事実が、原因を絞り込む上で最も重要です。
| 失敗した箇所： | ほぼ常に、以下を意味します。 |
|---|---|
| コードが記述される前に | クリーンなワークスペース用のビルドまたはインストールコマンドが誤っている。 |
| 変更を適用している最中に | 本当に難しい作業が発生したか、依存関係が欠落している。 |
| テストを実行している際に | テストコマンドが誤っているか、テストスイートがサービスを必要としている。 |
| 検証時 | ブロッキングゲートに引っかかっています。検出結果を確認してください。 |
| レビュー | 自動修正が不可能な検出結果。 |
変更が記述される前のエラーは設定上の問題です。以下を参照してください。ビルドおよびテストの設定.
処理が停止しているのではなく、キューに入れられているだけです。
「PENDING」内のタスクは停止していません。空きエージェントスロットを待機しているだけです。以下を確認してください。キャパシティ他の何よりも先に確認してください。これが最も一般的な誤報です。
システムがあなたに問い合わせています。
NEEDS_HUMAN_REVIEWこれは、タスクがあなたのみが決定できる判断に直面したことを意味します。エラーではありません。質問に答えれば、一時停止した箇所から処理が続行されます。
正確に回答してください。曖昧な回答だと、再び推測を繰り返し、再度一時停止してしまいます。
予想以上に長時間実行されている場合
一般的な原因は2つです。
**遅延またはハングアップするテストスイート。**Coroidがスイートを実行します。クリーンなワークスペースでハングアップする場合、タスクは待機状態になります。新しいクローンに対してスイートを実行し、再現を試してください。
**エージェントがさらに作業を見つけ続けてしまうほど、仕様書が曖昧すぎる場合。**その兆候はファイルリストの増加です。キャンセルし、明確な範囲外項目を指定してスコープを絞り、再実行してください。以下を参照してください。仕様書.
対処方法を選択する
コストが高くなる順に：
- 回答— 「
NEEDS_HUMAN_REVIEW」に対して。最もコストが低く、すべてのコンテキストが保持されます。 - 手直し— 作業内容は正しいが不完全な場合。検出結果とコンテキストをそのまま保持した状態で、開発者エージェントに戻されます。
- 一時停止— 事前に確認が必要な場合。スロットが解放され、後で再開可能です。
- 再試行— 本当に一時的なエラーのみに使用してください。設定上の問題を再試行しても同じ結果が生じます。
- キャンセルして再指定— アプローチやスコープが誤っていた場合。最もコストがかかりますが、多くの場合正しい選択です。
タスク間で繰り返し発生するエラー
関連性のないタスクで同じステージで同じエラーが発生する場合、それはタスクの問題ではなくプロジェクト設定上の問題です。タスクの再実行をやめ、設定を修正してください。