> ## Documentation Index
> Fetch the complete documentation index at: https://factory-docs-model-update-cl-824.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# トラブルシューティング

> ミッションでよくある問題と復旧方法 -- 停止したミッション、詰まったワーカーやマイルストーン、途中での方向転換。

Factory Missions は設定したら放置するものではありません。オーケストレーターはエージェントであり、会話することができます。問題が起きたときに最も効果的なのは、オーケストレーターを一時停止し、見えている状況を平易な言葉で説明し、復旧を依頼することです。以下のシナリオは、私たちが最もよく遭遇する問題と、応用できる例文をまとめたものです。

<AccordionGroup>
  <Accordion title="ミッションが停止した、または進行しない">
    ミッションが止まって何も起きていないように見える場合は、オーケストレーターを一時停止し、見えている状況を伝えます。率直に、ミッションが停止または壊れているように見えること、最後に見えたアクティビティ、復旧してほしいことを説明してください。オーケストレーターは状態を再評価し、再開できます。

    **例:** *「ミッションが停止しているようです。最後のワーカーは10分前に完了しましたが、その後何も始まっていません。状況を再評価して続行してください。」*
  </Accordion>

  <Accordion title="ワーカーが1つの項目に時間をかけすぎている">
    1つのワーカーが意味のある進捗なしに長時間タスクで止まっている場合、完了を待つ必要はありません。オーケストレーターを一時停止し、現在の項目を完了としてマークして次へ進むよう伝えます。その項目には後で戻ることも、手動で対応することもできます。

    **例:** *「認証連携を担当しているワーカーが20分間詰まっています。完了としてマークして、次の機能に進んでください。」*
  </Accordion>

  <Accordion title="ミッションがマイルストーンで詰まっている">
    以前の前提が間違っていたり、依存関係が不足していたりして、オーケストレーターがブロックされたマイルストーンに到達することがあります。この場合は、残りの作業を再評価し、なぜブロックされたのかを特定するよう依頼します。障害を回避する再計画、機能の並べ替え、マイルストーン範囲の調整が可能です。

    **例:** *「マイルストーン3で詰まっています。残りの作業を再評価し、何が進行を妨げているのか教えてください。」*
  </Accordion>

  <Accordion title="ミッションの途中で方向転換したい">
    計画を変更する必要があると気づいた場合（機能を削除する、新しい要件が入った、アプローチが間違っているなど）は、一時停止してオーケストレーターに伝えます。計画を更新し、マイルストーンのスコープを見直し、新しい方向から続行できます。

    **例:** *「メール通知機能を削除して、代わりに Slack 連携を追加してください。残りのマイルストーンを再計画してください。」*
  </Accordion>

  <Accordion title="「Feature retry limit reached」と表示される">
    *"Feature retry limit reached. A feature kept failing..."* のようなメッセージは、特定の機能が繰り返し失敗し、オーケストレーターがその再試行を停止したことを意味します。その機能の最新のワーカーを調べ、なぜ失敗し続けるのかを特定してください。多くの場合、これは user-testing バリデーターであり、アプリケーションを正しく QA できないこと、つまりミッションにアプリを確実に立ち上げて動かす手段がないことを示しています。アプリの依存関係を立ち上げるかモックして QA が実際のユーザーフローをシミュレートできるスクリプトを用意し、ログが Droid の確認できるファイルシステムに書き出されていることを確認してください。[計画と検証](/jp/features/missions/planning#development-scripting-for-qa) を参照してください。QAスタイルの検証が不要なプロジェクトの場合は、Mission Control 内のミッション設定で無効化してください。
  </Accordion>

  <Accordion title="検証が失敗し続ける、またはQAが実行できない">
    検証ワーカーが繰り返し失敗する場合、実行中のアプリケーションを確実に動かす手段がミッションに不足していることがよくあります。アプリの依存関係を立ち上げるかモックしてQAが実際のユーザーフローをシミュレートできるスクリプトを用意し、ログが Droid の確認できるファイルシステムに書き出されていることを確認してください。[計画と検証](/jp/features/missions/planning#development-scripting-for-qa) を参照してください。QAスタイルの検証がそもそも不要なプロジェクトの場合は、Mission Control 内のミッション設定で無効化できます。
  </Accordion>
</AccordionGroup>

## 関連項目

* [CLIでの実行](/jp/cli/features/missions/running-cli) -- ターミナルから実行を監視・操作する
* [Desktop/Webでの実行](/jp/web/missions) -- ダッシュボードから一時停止・再評価・再計画する
* [計画と検証](/jp/features/missions/planning) -- マイルストーンのスコープ設定とQAスクリプトの準備