Agent ガイド · 判断の要所はあなたが握る

尋ね、確認し、それから決める ​

Agent は開いているストーリープロジェクトの中で作業します。Lattice ソースを読み、ストーリーを理解したスキルを使い、焦点を絞った質問をし、創作モードでファイルを編集し、検証結果を表示できます。創作の方向を決め、どの計画を進めるかを決めるのはあなたです。

直接的な作業には創作モード ​

創作（Act）は通常のモードです。成果、重要な制約、期待する根拠を伝えます。

opening の対話を引き締めてください。ただし Block ID と経路の対象は変えないでください。ストーリーを検証し、変更点を要約してください。

具体的な依頼は、Agent が正しい境界を保つのに役立ちます。ファイル操作を細かく指示する必要はありません。完了時にどうなっていればよいかを説明してください。

依頼が範囲限定で、取り消し可能で、すぐ実装しても安全な場合は創作を使います。ファイルを変更する前に作業をレビューする必要がある場合は計画を使います。

持続する成果には目標モード ​

一つの Agent の応答よりも、最終的な成果を重視する場合は 目標（Goal）を使います。目標モードは、Agent の応答をまたいで一つの目的を保ちます。Agent は完了の根拠を示して明示的に終えるか、繰り返す障害を報告するか、外部待機に入らなければなりません。通常の最終メッセージだけで目標が黙って完了することはありません。あなたからの情報が必要な場合は、推測せず、通常の質問インターフェースを表示します。

目標モードは既定で最大 10 回のモデル応答を自動実行します。システム設定 → AI → ゴール で別の正の整数または無制限を選べます。無制限は自動応答の上限を取り除きますが、実行の停止、Credit の不足、トークン予算、進捗の停滞の繰り返し、ランタイム障害、ブロック、外部待機は依然として実行を停止または一時停止させます。会話には実行中の状態と設定された上限が表示されます。目標が完了前に停止した場合は、目標を再開 を選ぶと、その停止した実行を消去し、保存された目的から再開します。完了後は、別の依頼を始めるまで根拠の要約が表示されたままになります。

進捗カードが目標の待機を示しているときも、コンポーザーは目標を選択したまま利用できます。新しい情報や外部の結果をそこへ送ると、同じ実行を再開して続行します。Agent が特定の判断を必要とする場合は、通常の質問インターフェースを使います。

検証可能な複数ステップの成果、たとえばストーリー修正の完了と検証には目標を使います。素早い直接的な変更には創作を、ファイルを変更する前に方針を承認したい場合には計画を使います。

影響の大きい変更には計画モード ​

計画 トグルは次に送信する依頼に適用されます。そのターンの間、Agent は読み込み、検索、ストーリーの分析、質問、タスクチェックリストの作成ができますが、プロジェクトファイルは編集できません。

計画モードは次のような場合に役立ちます。

• CYOA の経路を追加または再構成する。
• State、Pool、複数の Module を導入する。
• ソースを複数ファイルに分割する。
• 重要な創作上のトレードオフを伴う変更を調整する。
• 作業を始める前に、変更が完了したと判断する方法を決める。

計画ターンで起こること ​

1. Agent がプロジェクトを調査します。
   作業を提案する前に、現在のソースと関連する構造を読みます。
2. 結果を左右する曖昧さを解消します。
   焦点を絞った質問グループで、結果を大きく変える選択を確認します。
3. 明確なチェックリストを作成します。
   完全な計画は会話に残り、横のタスクリストに進捗が表示されます。
4. 計画レビューが開きます。
   レビューは執筆モードの中央に開き、会話はその横に移ります。注釈を付け、承認し、変更を依頼し、または判断を保留できます。
5. Agent はあなたが承認した計画に従います。
   計画が変わった場合は、作業を始める前に新しい版をレビューします。

計画レビューから戻っても、承認や却下にはなりません。保留中のレビューはタスクリストから再び開けます。未完了のチェックリストがある状態で新しい計画の依頼を始めると、TypeApe は現在の計画を置き換えてよいか確認し、以前のタスクは会話履歴に残します。

計画に注釈を付ける ​

計画の注釈は、ソースファイルを変更する前に方針をレビューするために使います。

• 特定のステップが誤っている、または不明確な場合は、計画の該当箇所に焦点を絞ったコメントを付けます。
• フィードバックが計画全体を変える場合は、全体コメントを追加します。
• 計画に別のパスが必要な場合は 変更を依頼 を選びます。Agent は修正したチェックリストをレビュー用に返します。
• ステップ、境界、期待する結果が適切な場合は 承認 を選びます。承認と一緒に最終的な指示を添えられます。

承認は画面に表示されている計画にのみ適用されます。その計画が編集または置き換えられた場合、TypeApe は再度レビューを求めます。

ストーリーに読書メモを残す ​

読書メモは、ファイルパスではなく、体験したストーリーを起点にします。

1. 正確な本文を選択して、その引用のそばにマーカーを固定するか、選択せずに段落・対話マーカーを有効にして項目全体に注釈を付けます。
2. 必要な修正内容を書き、そのメモを保存します。
3. 読みながら繰り返します。各カードは引用と Block の文脈を保持します。
4. すべてのメモを保存したら、注釈を Agent に送信 を選びます。

TypeApe は、完全なレビューを含む新しい Agent の会話を始めます。引用されたストーリー本文はメモの位置を示すもので、指示としては扱われません。Agent はプロジェクトファイルを読み、修正を適用し、結果を検証します。

送信していない読書メモは一時的なものです。ストーリーを再開または離れる、プロジェクトを切り替える、TypeApe を閉じると消去されます。メモを送信した後は、Agent の会話にレビューの記録が残ります。

Agent の実行中に作業を方向修正する ​

実行中もコンポーザーは利用できます。意図に合った送信方法を選びます。

実行を停止した場合も、中止する前に待機中のテキストを戻します。「既存の語り手を保つ」といった修正にはステアリングを、「検証の後にタイトルを三つ提案する」といった別の次のタスクにはフォローアップを使います。

質問、根拠、復旧 ​

Agent が結果を左右する判断を必要とする場合は、製品内のアンケートに答えます。関連する質問は一つずつ表示され、まとめて送信されます。実行や修正が失敗した場合も、会話とチェックリストが表示状態を保つので、再試行できます。修正に失敗した後は、コンポーザーは計画モードに戻ります。そこでもっと狭い指示を送ると、保存されたフィードバックに追加され、同じ計画を再試行します。

ストーリーの作業を受け入れる前に、次の三つを確認します。

• 変更されたファイルまたはストーリーの概念。
• パーサーとバリデータの結果（確認した警告を含む）。
• 読者がこれから体験できる内容を平易な言葉で説明したもの。

ソースを自分で確認したい場合は、Lattice 言語ガイドに戻ってください。