fix(commands): make ace-tool MCP optional in multi-* commands with built-in fallbacks

The multi-* commands (multi-plan, multi-execute, multi-workflow, multi-backend, multi-frontend) previously required ace-tool MCP (Augment Code) which is a paid service. This change makes ace-tool completely optional by: - Changing "MUST call" to "If ace-tool MCP is available" for enhance_prompt - Changing mandatory search_context calls to optional with fallback procedures - Adding detailed fallback instructions using Claude Code built-in tools (Glob, Grep, Read, Task/Explore agent) when ace-tool is unavailable - Updating all translations (ja-JP, zh-CN) to match This ensures multi-* commands work out of the box without ace-tool MCP configured. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-30 13:43:26 +08:00 · 2026-02-28 13:59:02 +09:00
parent 48b883d741
commit f94707d429
15 changed files with 79 additions and 43 deletions
--- a/docs/ja-JP/commands/multi-backend.md
+++ b/docs/ja-JP/commands/multi-backend.md
@@ -85,13 +85,13 @@ EOF",

 ### フェーズ 0: プロンプト強化(オプション)

-`[Mode: Prepare]` - ace-tool MCPが利用可能な場合、`mcp__ace-tool__enhance_prompt`を呼び出し、**後続のCodex呼び出しのために元の$ARGUMENTSを強化結果で置き換える**
+`[Mode: Prepare]` - ace-tool MCPが利用可能な場合、`mcp__ace-tool__enhance_prompt`を呼び出し、**後続のCodex呼び出しのために元の$ARGUMENTSを強化結果で置き換える**。利用できない場合は`$ARGUMENTS`をそのまま使用。

 ### フェーズ 1: 調査

 `[Mode: Research]` - 要件の理解とコンテキストの収集

-1. **コード取得**(ace-tool MCPが利用可能な場合): `mcp__ace-tool__search_context`を呼び出して既存のAPI、データモデル、サービスアーキテクチャを取得
+1. **コード取得**(ace-tool MCPが利用可能な場合): `mcp__ace-tool__search_context`を呼び出して既存のAPI、データモデル、サービスアーキテクチャを取得。利用できない場合は組み込みツールを使用: `Glob`でファイル検索、`Grep`でシンボル/API検索、`Read`でコンテキスト収集、`Task`(Exploreエージェント)でより深い探索。
 2. 要件の完全性スコア(0-10): >=7で継続、<7で停止して補足

 ### フェーズ 2: アイデア創出
--- a/docs/ja-JP/commands/multi-execute.md
+++ b/docs/ja-JP/commands/multi-execute.md
@@ -136,7 +136,7 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

 `[Mode: Retrieval]`

-**MCPツールを使用したクイックコンテキスト取得が必須です。ファイルを1つずつ手動で読まないでください**
+**ace-tool MCPが利用可能な場合**、クイックコンテキスト取得に使用:

 計画の「キーファイル」リストに基づいて、`mcp__ace-tool__search_context`を呼び出します:

@@ -151,7 +151,12 @@ mcp__ace-tool__search_context({
 - 計画の「キーファイル」テーブルから対象パスを抽出
 - カバー範囲のセマンティッククエリを構築: エントリファイル、依存モジュール、関連する型定義
 - 結果が不十分な場合、1-2回の再帰的取得を追加
- **決して**Bash + find/lsを使用してプロジェクト構造を手動で探索しない
+
+**ace-tool MCPが利用できない場合**、Claude Code組み込みツールでフォールバック:
+1. **Glob**: 計画の「キーファイル」テーブルから対象ファイルを検索 (例: `Glob("src/components/**/*.tsx")`)
+2. **Grep**: キーシンボル、関数名、型定義をコードベース全体で検索
+3. **Read**: 発見したファイルを読み取り、完全なコンテキストを収集
+4. **Task (Explore エージェント)**: より広範な探索が必要な場合、`Task` を `subagent_type: "Explore"` で使用

 **取得後**:
 - 取得したコードスニペットを整理
--- a/docs/ja-JP/commands/multi-frontend.md
+++ b/docs/ja-JP/commands/multi-frontend.md
@@ -85,13 +85,13 @@ EOF",

 ### フェーズ 0: プロンプト強化(オプション)

-`[Mode: Prepare]` - ace-tool MCPが利用可能な場合、`mcp__ace-tool__enhance_prompt`を呼び出し、**後続のGemini呼び出しのために元の$ARGUMENTSを強化結果で置き換える**
+`[Mode: Prepare]` - ace-tool MCPが利用可能な場合、`mcp__ace-tool__enhance_prompt`を呼び出し、**後続のGemini呼び出しのために元の$ARGUMENTSを強化結果で置き換える**。利用できない場合は`$ARGUMENTS`をそのまま使用。

 ### フェーズ 1: 調査

 `[Mode: Research]` - 要件の理解とコンテキストの収集

-1. **コード取得**(ace-tool MCPが利用可能な場合): `mcp__ace-tool__search_context`を呼び出して既存のコンポーネント、スタイル、デザインシステムを取得
+1. **コード取得**(ace-tool MCPが利用可能な場合): `mcp__ace-tool__search_context`を呼び出して既存のコンポーネント、スタイル、デザインシステムを取得。利用できない場合は組み込みツールを使用: `Glob`でファイル検索、`Grep`でコンポーネント/スタイル検索、`Read`でコンテキスト収集、`Task`(Exploreエージェント)でより深い探索。
 2. 要件の完全性スコア(0-10): >=7で継続、<7で停止して補足

 ### フェーズ 2: アイデア創出
--- a/docs/ja-JP/commands/multi-plan.md
+++ b/docs/ja-JP/commands/multi-plan.md
@@ -71,7 +71,7 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

 #### 1.1 プロンプト強化(最初に実行する必要があります)

-**`mcp__ace-tool__enhance_prompt`ツールを呼び出す必要があります**:
+**ace-tool MCPが利用可能な場合**、`mcp__ace-tool__enhance_prompt`ツールを呼び出す:

 ```
 mcp__ace-tool__enhance_prompt({
@@ -83,9 +83,11 @@ mcp__ace-tool__enhance_prompt({

 強化されたプロンプトを待ち、**後続のすべてのフェーズのために元の$ARGUMENTSを強化結果で置き換える**。

+**ace-tool MCPが利用できない場合**: このステップをスキップし、後続のすべてのフェーズで元の`$ARGUMENTS`をそのまま使用する。
+
 #### 1.2 コンテキスト取得

-**`mcp__ace-tool__search_context`ツールを呼び出す**:
+**ace-tool MCPが利用可能な場合**、`mcp__ace-tool__search_context`ツールを呼び出す:

 ```
 mcp__ace-tool__search_context({
@@ -96,7 +98,12 @@ mcp__ace-tool__search_context({

 - 自然言語を使用してセマンティッククエリを構築(Where/What/How)
 - **仮定に基づいて回答しない**
- MCPが利用できない場合: Glob + Grepにフォールバックしてファイル検出とキーシンボル位置を特定
+
+**ace-tool MCPが利用できない場合**、Claude Code組み込みツールでフォールバック:
+1. **Glob**: パターンで関連ファイルを検索 (例: `Glob("**/*.ts")`, `Glob("src/**/*.py")`)
+2. **Grep**: キーシンボル、関数名、クラス定義を検索 (例: `Grep("className|functionName")`)
+3. **Read**: 発見したファイルを読み取り、完全なコンテキストを収集
+4. **Task (Explore エージェント)**: より深い探索が必要な場合、`Task` を `subagent_type: "Explore"` で使用

 #### 1.3 完全性チェック

--- a/docs/ja-JP/commands/multi-workflow.md
+++ b/docs/ja-JP/commands/multi-workflow.md
@@ -15,14 +15,14 @@
 - 開発するタスク: $ARGUMENTS
 - 品質ゲートを備えた構造化された6フェーズワークフロー
 - マルチモデル連携: Codex(バックエンド) + Gemini(フロントエンド) + Claude(オーケストレーション)
- MCPサービス統合(ace-tool)による機能強化
+- MCPサービス統合(ace-tool、オプション)による機能強化

 ## 役割

 あなたは**オーケストレーター**として、マルチモデル協調システムを調整します(調査 → アイデア創出 → 計画 → 実装 → 最適化 → レビュー)。経験豊富な開発者向けに簡潔かつ専門的にコミュニケーションします。

 **連携モデル**:
- **ace-tool MCP** – コード取得 + プロンプト強化
+- **ace-tool MCP**(オプション) – コード取得 + プロンプト強化
 - **Codex** – バックエンドロジック、アルゴリズム、デバッグ(**バックエンドの権威、信頼できる**)
 - **Gemini** – フロントエンドUI/UX、ビジュアルデザイン(**フロントエンドエキスパート、バックエンドの意見は参考のみ**)
 - **Claude(自身)** – オーケストレーション、計画、実装、配信
@@ -111,8 +111,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

 `[Mode: Research]` - 要件の理解とコンテキストの収集:

-1. **プロンプト強化**: `mcp__ace-tool__enhance_prompt`を呼び出し、**後続のすべてのCodex/Gemini呼び出しのために元の$ARGUMENTSを強化結果で置き換える**
-2. **コンテキスト取得**: `mcp__ace-tool__search_context`を呼び出す
+1. **プロンプト強化**(ace-tool MCPが利用可能な場合): `mcp__ace-tool__enhance_prompt`を呼び出し、**後続のすべてのCodex/Gemini呼び出しのために元の$ARGUMENTSを強化結果で置き換える**。利用できない場合は`$ARGUMENTS`をそのまま使用。
+2. **コンテキスト取得**(ace-tool MCPが利用可能な場合): `mcp__ace-tool__search_context`を呼び出す。利用できない場合は組み込みツールを使用: `Glob`でファイル検索、`Grep`でシンボル検索、`Read`でコンテキスト収集、`Task`(Exploreエージェント)でより深い探索。
 3. **要件完全性スコア**(0-10):
   - 目標の明確性(0-3)、期待される結果(0-3)、スコープの境界(0-2)、制約(0-2)
   - ≥7: 継続 | <7: 停止、明確化の質問を尋ねる
--- a/docs/zh-CN/commands/multi-backend.md
+++ b/docs/zh-CN/commands/multi-backend.md
@@ -86,13 +86,13 @@ EOF",

 ### 阶段 0：提示词增强（可选）

-`[Mode: Prepare]` - 如果 ace-tool MCP 可用，调用 `mcp__ace-tool__enhance_prompt`，**用增强后的结果替换原始的 $ARGUMENTS，用于后续的 Codex 调用**
+`[Mode: Prepare]` - 如果 ace-tool MCP 可用，调用 `mcp__ace-tool__enhance_prompt`，**用增强后的结果替换原始的 $ARGUMENTS，用于后续的 Codex 调用**。不可用时，直接使用 `$ARGUMENTS`。

 ### 阶段 1：研究

 `[Mode: Research]` - 理解需求并收集上下文

-1. **代码检索**（如果 ace-tool MCP 可用）：调用 `mcp__ace-tool__search_context` 以检索现有的 API、数据模型、服务架构
+1. **代码检索**（如果 ace-tool MCP 可用）：调用 `mcp__ace-tool__search_context` 以检索现有的 API、数据模型、服务架构。不可用时，使用内置工具：`Glob` 进行文件发现，`Grep` 进行符号/API 搜索，`Read` 进行上下文收集，`Task`（Explore 代理）进行更深入的探索。
 2. 需求完整性评分（0-10）：>=7 继续，<7 停止并补充

 ### 阶段 2：构思
--- a/docs/zh-CN/commands/multi-execute.md
+++ b/docs/zh-CN/commands/multi-execute.md
@@ -138,23 +138,28 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

 `[Mode: Retrieval]`

-**必须使用 MCP 工具进行快速上下文检索，切勿手动逐个读取文件**
+**如果 ace-tool MCP 可用**，使用它进行快速上下文检索：

-基于计划中的“关键文件”列表，调用 `mcp__ace-tool__search_context`：
+基于计划中的”关键文件”列表，调用 `mcp__ace-tool__search_context`：

 ```
 mcp__ace-tool__search_context({
-  query: "<semantic query based on plan content, including key files, modules, function names>",
-  project_root_path: "$PWD"
+  query: “<semantic query based on plan content, including key files, modules, function names>”,
+  project_root_path: “$PWD”
 })
 ```

 **检索策略**：

-* 从计划的“关键文件”表中提取目标路径
+* 从计划的”关键文件”表中提取目标路径
 * 构建语义查询覆盖：入口文件、依赖模块、相关类型定义
 * 如果结果不足，添加 1-2 次递归检索
-* **切勿**使用 Bash + find/ls 手动探索项目结构
+
+**如果 ace-tool MCP 不可用**，使用 Claude Code 内置工具作为回退：
+1. **Glob**：从计划的”关键文件”表中查找目标文件（例如 `Glob(“src/components/**/*.tsx”)`）
+2. **Grep**：在代码库中搜索关键符号、函数名、类型定义
+3. **Read**：读取发现的文件以收集完整上下文
+4. **Task（Explore 代理）**：如需更广泛的探索，使用 `Task` 并设置 `subagent_type: “Explore”`

 **检索后**：

--- a/docs/zh-CN/commands/multi-frontend.md
+++ b/docs/zh-CN/commands/multi-frontend.md
@@ -86,13 +86,13 @@ EOF",

 ### 阶段 0: 提示词增强（可选）

-`[Mode: Prepare]` - 如果 ace-tool MCP 可用，调用 `mcp__ace-tool__enhance_prompt`，**将原始的 $ARGUMENTS 替换为增强后的结果，用于后续的 Gemini 调用**
+`[Mode: Prepare]` - 如果 ace-tool MCP 可用，调用 `mcp__ace-tool__enhance_prompt`，**将原始的 $ARGUMENTS 替换为增强后的结果，用于后续的 Gemini 调用**。不可用时，直接使用 `$ARGUMENTS`。

 ### 阶段 1: 研究

 `[Mode: Research]` - 理解需求并收集上下文

-1. **代码检索**（如果 ace-tool MCP 可用）: 调用 `mcp__ace-tool__search_context` 来检索现有的组件、样式、设计系统
+1. **代码检索**（如果 ace-tool MCP 可用）: 调用 `mcp__ace-tool__search_context` 来检索现有的组件、样式、设计系统。不可用时，使用内置工具：`Glob` 进行文件发现，`Grep` 进行组件/样式搜索，`Read` 进行上下文收集，`Task`（Explore 代理）进行更深入的探索。
 2. 需求完整性评分（0-10）: >=7 继续，<7 停止并补充

 ### 阶段 2: 构思
--- a/docs/zh-CN/commands/multi-plan.md
+++ b/docs/zh-CN/commands/multi-plan.md
@@ -73,7 +73,7 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

 #### 1.1 提示增强（必须先执行）

-**必须调用 `mcp__ace-tool__enhance_prompt` 工具**：
+**如果 ace-tool MCP 可用**，调用 `mcp__ace-tool__enhance_prompt` 工具：

 ```
 mcp__ace-tool__enhance_prompt({
@@ -85,9 +85,11 @@ mcp__ace-tool__enhance_prompt({

 等待增强后的提示，**将所有后续阶段的原始 $ARGUMENTS 替换为增强结果**。

+**如果 ace-tool MCP 不可用**：跳过此步骤，在所有后续阶段中直接使用原始 `$ARGUMENTS`。
+
 #### 1.2 上下文检索

-**调用 `mcp__ace-tool__search_context` 工具**：
+**如果 ace-tool MCP 可用**，调用 `mcp__ace-tool__search_context` 工具：

 ```
 mcp__ace-tool__search_context({
@@ -98,7 +100,12 @@ mcp__ace-tool__search_context({

 * 使用自然语言构建语义查询（Where/What/How）
 * **绝不基于假设回答**
-* 如果 MCP 不可用：回退到 Glob + Grep 进行文件发现和关键符号定位
+
+**如果 ace-tool MCP 不可用**，使用 Claude Code 内置工具作为回退：
+1. **Glob**：按模式查找相关文件（例如 `Glob("**/*.ts")`、`Glob("src/**/*.py")`）
+2. **Grep**：搜索关键符号、函数名、类定义（例如 `Grep("className|functionName")`）
+3. **Read**：读取发现的文件以收集完整上下文
+4. **Task（Explore 代理）**：如需更深入的探索，使用 `Task` 并设置 `subagent_type: "Explore"`

 #### 1.3 完整性检查

--- a/docs/zh-CN/commands/multi-workflow.md
+++ b/docs/zh-CN/commands/multi-workflow.md
@@ -15,7 +15,7 @@
 * 待开发任务：$ARGUMENTS
 * 结构化的 6 阶段工作流程，包含质量门控
 * 多模型协作：Codex（后端） + Gemini（前端） + Claude（编排）
-* MCP 服务集成（ace-tool）以增强能力
+* MCP 服务集成（ace-tool，可选）以增强能力

 ## 你的角色

@@ -23,7 +23,7 @@

 **协作模型**：

-* **ace-tool MCP** – 代码检索 + 提示词增强
+* **ace-tool MCP**（可选） – 代码检索 + 提示词增强
 * **Codex** – 后端逻辑、算法、调试（**后端权威，可信赖**）
 * **Gemini** – 前端 UI/UX、视觉设计（**前端专家，后端意见仅供参考**）
 * **Claude（自身）** – 编排、规划、执行、交付
@@ -114,8 +114,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

 `[Mode: Research]` - 理解需求并收集上下文：

-1. **提示词增强**：调用 `mcp__ace-tool__enhance_prompt`，**将所有后续对 Codex/Gemini 的调用中的原始 $ARGUMENTS 替换为增强后的结果**
-2. **上下文检索**：调用 `mcp__ace-tool__search_context`
+1. **提示词增强**（如果 ace-tool MCP 可用）：调用 `mcp__ace-tool__enhance_prompt`，**将所有后续对 Codex/Gemini 的调用中的原始 $ARGUMENTS 替换为增强后的结果**。不可用时，直接使用 `$ARGUMENTS`。
+2. **上下文检索**（如果 ace-tool MCP 可用）：调用 `mcp__ace-tool__search_context`。不可用时，使用内置工具：`Glob` 进行文件发现，`Grep` 进行符号搜索，`Read` 进行上下文收集，`Task`（Explore 代理）进行更深入的探索。
 3. **需求完整性评分** (0-10)：
   * 目标清晰度 (0-3)，预期成果 (0-3)，范围边界 (0-2)，约束条件 (0-2)
   * ≥7：继续 | <7：停止，询问澄清问题