InDesign MCP オペレータ

ゴール

indesign-dom および indesign-exec MCP サーバーを使用して、InDesign タスクを安全かつ繰り返し実行します。

ワークフロー

1. 現在の状態を検査する。
2. API の事実を調査する。
3. 明確なアンドゥポリシーで JSX を実行する。
4. 結果を検証する。
5. 必要に応じてロールバックする。
6. 新しい学習を記録する。

必須シーケンス

非自明なタスクの場合、以下のステップを順番に実行してください：

1. get_quick_reference()
2. get_gotchas(context)
3. DOM 検索（search_dom、lookup_class、get_method_detail など）
4. run_jsx(...) を以下で実行：
   • 任意の変更に対して undo_mode="entire" を使用
   • 説明的な undo_name（Agent: <task>）を付ける
5. 検証（eval_expression、get_document_info、get_selection）
6. 結果が正しくない場合：先にいくつかの対象絞った修正を試す。undo(steps=1) を直ちに使用するのは、ドキュメント状態が不確定、部分的に破損している、または広範なロールバックが段階的な修正より安全な場合のみ。

厳密に読み取り専用の確認の場合は、undo_mode="none" を使用してください。

スクリプトラベルポリシー

• 一時キーは _tmp_ で始まる必要があります。
• 永続キーは agentContext_ で始まる必要があります。
• タスク終了時に常に一時キーをクリアしてください：
  • doc.insertLabel("_tmp_key", "")
• 永続ラベルは、セッション間での価値が証明された場合のみ保持してください。
• オプションで _agentLabelRegistry をすべての永続キーで管理してください。

JSX ルール

• ES3 構文のみを使用してください（var、クラシック関数）。
• 出力を __result に割り当てる。return を使用しないでください。
• ループより集合 API を優先してください：
  • everyItem()、itemByName()、itemByID()、itemByRange()。
• 使用前に検索/置換の環境設定をクリアしてください：
  • app.findTextPreferences = NothingEnum.NOTHING
  • app.changeTextPreferences = NothingEnum.NOTHING

セーフティゲート

変更前：

• ドキュメントが開いており、正しいことを確認してください。
• 重要な前提条件を読み取り専用の確認で確認してください。

変更後：

• 特定のターゲット状態が意図したように変更されたことを検証してください。
• 部分的な失敗が検出された場合、まずアンドゥしてから、より狭いスコープで再試行してください。

学習ループ

ユーザーが報告した問題が明確な根本原因で解決された場合：

1. 同等の落とし穴がないか最初に確認してください。
2. report_learning(...) で送信してください。
3. エントリは簡潔で実行可能な内容に保ってください。

しないこと

• タスク終了後、一時的な _tmp_ ラベルを保持しないでください。
• モダン JavaScript 構文を仮定しないでください。
• 操作がリスキーな場合、検査と破壊的な編集を 1 つの大きな不透明な JSX ブロック内で混在させないでください。

レスポンスコントラクト

タスク完了を報告する場合：

• 何が検証されたかを述べてください。
• アンドゥが可能かどうか、および使用されたラベルを述べてください。
• 一時ラベルがクリアされたかどうかを述べてください。

追加参考資料

再利用可能なプロンプトと短いテンプレートについては、reference.md を参照してください。