CodeNomad/docs/help/ja/missions.md

ミッション

ミッションは、永続的なプロジェクト計画と OpenCode ネイティブの会話を組み合わせます。コーディネーターが計画と委任を行い、タスクツリーが依存関係と結果を記録します。保存済みの計画、受け付けられた入力、観測された実行は、それぞれ別の事実です。

作成してから明示的に開始する

1. 右パネルの ミッション を開き、ミッションを作成 を選びます。
2. ミッションで何をしますか？ を入力し、最初の文から事前入力される タイトル（最大 60 文字）を確認します。
3. 実行タイミング で 1 回 または 毎日 を選びます。毎日の作業では、表示されたタイムゾーンを確認してください。変更 で IANA ゾーンを指定できます。
4. オプション を展開すると、プレイブック、メモ、エージェントとモデル、タスクセッション、保存済みの概要、任意の参照する会話を設定できます。2つのモデルを比較 では、モデルA と モデルB のセレクターがメインフォームに表示されます。
5. 作成 を選びます。新しい項目を選び、準備ができたら別の ▶ 操作を使用します。1 回限りの作業では ミッションを開始、毎日のスケジュールでは スケジュール {id} を開始 です。

作成だけでは作業は決して開始しません。 1 回限りのミッションは準備状態、毎日のスケジュールは一時停止状態になります。作成も概要の保存も、タイマーを作動させません。作成は選択したプロジェクト／Location を範囲とし、要求したプロファイルとタスクセッションポリシーを固定します。検証結果は該当フィールドの横に表示されます。何も送信されなかったとする拒否の場合は、修正用に下書きが残ります。1 回限りのミッションのコーディネーターが、フォローアップなどの別のミッションを準備することもあります。そのミッションは一覧に 準備済み と表示され、他のミッションと同じく ▶ 操作からのみ開始します。

プレイブック

プレイブック	想定する作業
フレキシブルミッション	コーディネーターが目的に合った、依存関係を考慮した計画を選びます。
デバッグ	診断、実装、独立した標準／仕様レビュー、新たな検証。問題解決は実装担当を継続して行います。
探索	不確実な点を整理し、人への質問を交えて範囲を限定した判断を進めます。
プロダクトデリバリー	製品分析、アーキテクチャ、実装、品質の各役割を調整します。
2つのモデルを比較	同じタスクを同一の依頼内容で モデルA と モデルB に実行させ、その後 匿名評価担当 が中立的なラベルのもとで両方を採点し、モデルAが優位、モデルBが優位、同等、結論なし のいずれかの判定を下します。

2つのモデルを比較 では両方のモデルが必須で、互いに異なる必要があります。思考 のレベルが違うだけでは、別のモデルとはみなされません。評価担当は、選ばない限りコーディネーターのモデルを使用します。A または B と同じ場合はフォームが警告し、比較が偏る可能性があります。概要には、判定、両モデルの名前、基準ごとのスコアが表示されます。

プレイブックは調整の指針であり、ネイティブ権限の回避や成功の保証はしません。探索の判断に関する質問は、エージェントに承認を装わせず、CodeNomad の割り込みドックで回答して、明示的な UI 回答を記録してください。

ツリーを追って結果を読む

1. ミッションのタイトルを選びます。先頭の山形矢印は一覧を開いたままにし、タイトル欄は一時的なピッカーを開きます。
2. 概要（目）で中央の概要を開くか、タスクノードを選んで、その正確な結果、依頼内容、根拠を読みます。
3. 依存リンクと レポート をたどります。コーディネーターの会話が必要なら、会話を開く を使用します。
4. 対応が必要です で 回答する を選ぶと、要求した担当の会話と割り込みドックを開きます。

表示	確認できること
割り当て済み	入力は受け付けられました。モデルによる取り込み／作業／完了は証明されていません。
アクティブ	ネイティブのアクティビティが観測されました。
待機	宣言された依存条件がまだ満たされていません。
ブロック	障害が報告されました。必ずしもユーザーへの質問ではありません。
入力待ち	開いているネイティブの Form／質問または権限に回答が必要です。対応が必要です に表示されます。
完了	タスク結果が記録されました。根拠と、残っているネイティブの作業を確認してください。
失敗／取り下げ済み	タスクが失敗したか、コーディネーターがタスクを置き換えたか中止しました。

グラフには完了・取り下げ済みの作業も含まれます。タスクを取り下げるだけでは会話は停止しません。1 回限りのミッションでは、コーディネーターがネイティブサブエージェントとして起動した取り下げ済みタスクの会話を、他のタスクに影響を与えずに別途停止できます。進行中 はミッションのライフサイクル上の状態であり、コーディネーターが現在実行中である証拠ではありません。詳しい文章はパネルのタスク一覧ではなく中央リーダーに表示されます。技術的な詳細 は識別子と要求された実行情報を折りたたんでいます。

状況報告と更新の依頼

コーディネーターは、初期計画の後、タスクの確定後、人の対応を待つとき、最終レポートの前に、プロジェクトの状況報告を公開するよう指示されます。これは作成された評価であり、ライブのアクティビティカウンターや、定期的な生存通知の保証ではありません。報告後にマップが変わった場合は、通知で示します。

ツールバーの下の 最新状況を依頼 でコーディネーターに新たな評価を求め、概要 を読みます。最新状況を依頼済み… は依頼が保留中であり、回答済みではないことを意味します。送信未確認 は自動再送を許可しません。別の新しい依頼を行う前に、コーディネーターの会話を開いてください。これは通常のネイティブ入力であって読み取り専用サンドボックスではなく、コーディネーターは通常の権限を保持します。

プロファイル、委任、深さ

1. ミッションの歯車、または 設定 → ミッション から 新規ミッションの既定値 を編集します。
2. 適用先 で すべてのミッション または 1 つのプレイブックを選び、タスクセッション と、エージェントとモデル の下で役割ごとに 1 行（コーディネーター、続いてプレイブックの各役割）を設定します。各選択はすぐに保存され、保存ボタンはありません。
3. プレイブックの範囲では、各行に グローバル の印付きでグローバルの値が表示されます。項目を変更すると、その値をもとにその役割をカスタマイズします。元に戻すアイコンで、再びグローバルの値を使用します。リセット（確認後）は、表示中の範囲のエージェントとモデルだけを消去します。
4. 作成時に特定のプロファイルを要求するには、オプション → エージェントとモデル を使用します。保存済みの既定値を使用 で保存済みの値に戻せます。
5. ネイティブの再帰制限には、サブセッションの入れ子の深さ → プロジェクトで指定する深さ を編集します。Enter を押すかフィールドを離れると、変更された有効な値が保存されます。継承 はすぐに保存され、Escape で未保存の値を破棄します。

設定	範囲と効果
新規ミッションの既定値	新しい ミッションのみに適用する、設定全体の既定値。プレイブックの例外は一般の既定値を上書きします。
エージェント／モデル／思考	作成時に記録する、要求されたコーディネーター／役割の選択。後の作業に合わせて処理中の担当を無断で切り替えません。毎日の実行は固定済みの要求プロファイルを再利用します。
ネイティブサブエージェント	タスクセッションはコーディネーター配下で、ネイティブの subagent/all エージェントを使用します。
独立したセッション	宣言したタスクセッションは primary/all エージェントと独立した会話を使用します。内部のネイティブヘルパーは無効にしません。
サブセッションの入れ子の深さ	ミッションだけでなく、そこにある すべての OpenCode 会話に適用するプロジェクト設定。空欄は継承です。保存しても OpenCode の再読み込みや実行中の会話の変更は行いません。

ネイティブの既定値 と グローバル は異なります。前者は OpenCode 自身の既定値を要求し、後者はグローバルの選択を継承します。プレイブックの範囲でネイティブの既定値を選ぶことは、引き続き明示的な例外になります。カタログ上の利用可否を確認しますが、要求したプロファイルは、会話が現在使用するプロファイルの証拠ではありません。どちらのタスクモードでも、内部ヘルパーの呼び出しにはネイティブ権限と設定済みの深さが適用されます。

拒否された選択や未確認の選択が再送されることはありません。保存済みの値が再び表示され、再読み込み はそれらを読み取れない場合にだけ表示されます。深さの変更が未確認の場合は入力した値が保持されるので、次の変更の前に プロジェクトの深さを更新 を使用します。OpenCode の有効な深さは不明 をゼロや無効と解釈しないでください。

保存済みの概要を再利用する

1. 作成画面で オプション → 保存済みの概要から始める を展開し、保存済みの概要を選びます。
2. コピーされた目的、メモ、プレイブック、プロファイル、委任を確認してから 作成 します。
3. 概要として保存 で再利用可能な下書きに名前を付けます。完了済みを含む選択中の 1 回限りのミッションにも 概要として保存 があります。

概要が保存するのは指示と要求した選択であり、タスク計画、結果、会話、スケジュール時刻、実行権限ではありません。読み込むと通常の作成下書きを埋めますが、開始やスケジュールはしません。概要を削除しても既存のミッション／会話は残ります。設定 → ミッション → 保存済みの概要 でライブラリを管理します。ライブラリを読み取れなくなった場合、保存済みライブラリをリセット（確認後）は、実行ではなく保存済みの概要を削除します。スケジュール自体に概要として保存する操作はありません。

毎日の時刻、遅延実行、参照する会話

毎日のスケジュールは、経過時間の 24 時間間隔ではなく、保存した IANA タイムゾーンと現地時刻を使用します。時刻はスケジュールのゾーンで表示し、閲覧者のゾーンと異なる場合は明記します。実行ごとに専用コーディネーターと分離されたミッションマップを作ります。選択したスケジュールには現在のタスクツリーと日付／結果の履歴が表示されます。過去の実行を選ぶと中央で読めます。履歴は 30 結果までです。

状況	スケジュールの動作
複数の予定日を逃した	確定済みの日次マーカーより新しい、最新の予定日だけを実行します。逃した日すべてを順に実行しません。
夏時間開始による時刻の欠落	その後の最初の有効な分に進みます。日の終わりの欠落では日付境界を越えます。
時計の同じ時間の繰り返し	最初の出現を使用し、2 回目の日次実行は作りません。
現地暦日が丸ごとスキップされた	その日の実行はありません。
時計が後退した	処理済みの日を再び実行対象にしません。
既存の実行がまだ保留中	新しい日次実行を重複させません。

作成時刻も、対象となる日次作業の範囲を制限します。新しいスケジュールの開始は、存在する前の日付の処理を許可しません。今すぐ実行 が利用できる場合は、別の手動実行を開始します。日次の時計の置き換えや、保留中の実行の回避はしません。表示される次回時刻は予測であり、正確な時刻での実行保証ではありません。

参照する会話（任意） は、選んだ会話から範囲を限定したコンテキストを追加します。処理済みメッセージのカーソルを進めるのは完了した実行だけであり、失敗／中断した実行が無断でコンテキストを消費することはありません。指示とコンテキストが容量を超える場合は、履歴を無制限に読むと思い込まず、指示を短くするか参照する会話を削除します。

寿命とサービスの再起動

要素	閉じた場合の意味
CodeNomad のプロジェクトタブ	CodeNomad 内でそのプロジェクトを閉じます。ネイティブのセッションは OpenCode で続き、プロジェクトを開き直すと再び確認できます。
ウィンドウ全体、アプリの終了、レンダラーの再読み込み	復元のためにプロジェクト接続を保持します。ネイティブの作業や OpenCode サービスは停止しません。
CodeNomad バックエンド	OpenCode は停止しません。1 回限りの CodeNomad の調整はバックエンドの存在に依存します。閉じている間も 1 回限りの新たな指示／制御が使えると想定しないでください。
稼働中の毎日スケジュール	時計と各回の実行は、CodeNomad UI とバックエンドを閉じても、OpenCode プラグイン／サービス内で動きます。実行ホストと OpenCode サービスを稼働させておく必要があります。
OpenCode サービスの再起動	プロセス内のスケジュールジョブが失われます。実行を希望する状態のスケジュールは、明示的に 再開 するまで 中断 になります。CodeNomad を開き直しても再作動しません。

再起動後は保留中の実行を確認し、準備ができたら 再開 を選びます。再開は、コーディネーターへの入力を二重送信せずに既存の実行を照合します。中断したネイティブターンの継続を保証するものではありません。再起動で切れたターンは、再起動により中断 として、レポートなしで終了する場合があります。ツールの副作用を再試行する手段として、再起動を使わないでください。

ミッションは、デスクトップアプリでも、スタンドアロンの CodeNomad サーバーでも動作します。パネルに ミッションコントロールを利用できません と表示された場合、そのメッセージに原因が示されます。

原因	対処
OpenCode ワークスペースの準備ができていない	プロジェクトに再接続してから更新します。
OpenCode がミッションプラグインを読み込んでいない	しばらくしてから更新します。解決しない場合は、設定 → OpenCode の OpenCode の設定を再読み込み を使用します。
OpenCode がミッションプラグインを読み込めなかった	プラグイン一覧でエラーを確認し、修正後に更新します。
CodeNomad サーバーがミッション用のローカル接続（127.0.0.1）を開けなかった	サーバーログを確認します。OpenCode を再読み込みしても解決しません。

一時停止、停止、不確かな結果

1. 項目を選び、操作前に現在の状態と会話を確認します。
2. 再開可能な保留には一時停止アイコン、終端の停止には停止アイコンと確認を使用します。1 回限りのツールチップは ミッションを一時停止 と ミッションを完全に停止 です。スケジュールのツールチップはスケジュールを明記します。
3. 結果が未確認なら、状態を確認／制御状況を確認 で既存の結果を読みます。不確実性を回避するための代替操作は送らないでください。
4. 1 回限りの操作では、ヘッダーの 更新して未確認の操作を再送信 がまず状態を確認し、明示的なクリックから、その同一の操作がまだ未確認の場合に限り再送します。

1 回限りの一時停止は、ミッションのネイティブファミリーを中断し、調整を保留します。停止はさらに、キューにあるファミリーの入力／配信をキャンセルし、終端状態になります。処理には上限があり、一部のサブエージェントがまだ実行中の可能性があります。 は停止が不完全であることを意味します。すべてのシェル／ツールの影響がキャンセルされたと想定せず、保持された結果を確認し、明示的な再試行を使用してください。再開時には中断した子孫がコーディネーターに通知され、作業の続け方を判断する必要があります。

毎日の一時停止／停止は、スケジュールをキャンセルし、コーディネーターと独立した専門担当を含む登録済みルート担当の中断を要求しますが、それらの会話や子孫が停止した証拠にはなりません。ネイティブのファミリーを確認してください。停止は終端です。停止済みのスケジュールは、開始、再開、今すぐ実行を行えません。実行を確認 は、再送せずに保留中の実行を照合します。一時的な定期確認の失敗は、最後の失敗を表示し自動再試行しますが、ユーザー制御の応答消失で制御を自動再送することはありません。

レポートなしで待機している 1 回限りのコーディネーターは、主操作の ▶ で確認・復旧できる場合があります。タスクにも、対象条件を満たせば個別の不足レポート復旧があります。復旧は先にネイティブのアクティビティ、子孫、待機を確認し、アクティビティが不明なら受け付けを拒否します。割り当ての再実行や計画の置き換えはしません。会話を開いて、未解決の質問、権限、シェル、バックグラウンド作業を解消してください。

作成 が未確認の場合、ウィンドウは送信したリクエストを保持し、そのプロジェクトの追加作成を無効にします。ワークツリー削除も保留されたままになる場合があります。更新は状態を読むだけです。エディターの開閉では修復しません。ウィンドウの再読み込み前にミッション一覧を確認してください。再読み込みはローカルのロックを消しますが、作成に失敗した証拠ではありません。再読み込みや再起動の後に、無条件で重複作成しないでください。

編集、削除、会話のクリーンアップ

編集可能な 1 回限りのミッションで 選択したミッションを編集 を使用します。競合時は上書きせず、エディターを閉じて開き直し、現在のリビジョンを読み込みます。毎日のスケジュールには編集／削除操作はありません。

1. 不要になった 1 回限りのミッションで、選択したミッションを削除… を選び、確認内容を読みます。
2. 必要に応じて、確認前に このミッション用に作成された専門担当の会話も削除する を選びます。
3. 会話のクリーンアップ で削除／保持／保留の件数を確認します。再試行が提示される場合は、記録された残りのクリーンアップだけを再試行します。

ミッションの削除と停止は同じではありません。先に停止を使用して残った作業を確認してください。コーディネーターと再利用された会話は保持されます。共有、移動済み、子を持つ、所有関係を確認できない専門担当も保持される場合があります。部分的なクリーンアップは巻き戻されず、バックグラウンドで無断で完了されることもありません。完了したクリーンアップの履歴は、概要リーダーで引き続き確認できます。

ネイティブの作業とサービス制御については、権限、会話、OpenCode のセットアップを参照してください。