From f94707d429dda38cf3bf5e2530fbc2d689f5e925 Mon Sep 17 00:00:00 2001 From: "to.watanabe" Date: Sat, 28 Feb 2026 13:59:02 +0900 Subject: [PATCH] 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 --- commands/multi-backend.md | 4 ++-- commands/multi-execute.md | 9 +++++++-- commands/multi-frontend.md | 4 ++-- commands/multi-plan.md | 13 ++++++++++--- commands/multi-workflow.md | 8 ++++---- docs/ja-JP/commands/multi-backend.md | 4 ++-- docs/ja-JP/commands/multi-execute.md | 9 +++++++-- docs/ja-JP/commands/multi-frontend.md | 4 ++-- docs/ja-JP/commands/multi-plan.md | 13 ++++++++++--- docs/ja-JP/commands/multi-workflow.md | 8 ++++---- docs/zh-CN/commands/multi-backend.md | 4 ++-- docs/zh-CN/commands/multi-execute.md | 17 +++++++++++------ docs/zh-CN/commands/multi-frontend.md | 4 ++-- docs/zh-CN/commands/multi-plan.md | 13 ++++++++++--- docs/zh-CN/commands/multi-workflow.md | 8 ++++---- 15 files changed, 79 insertions(+), 43 deletions(-) diff --git a/commands/multi-backend.md b/commands/multi-backend.md index c8bb7e1a..d9faf18f 100644 --- a/commands/multi-backend.md +++ b/commands/multi-backend.md @@ -85,13 +85,13 @@ EOF", ### Phase 0: Prompt Enhancement (Optional) -`[Mode: Prepare]` - If ace-tool MCP available, call `mcp__ace-tool__enhance_prompt`, **replace original $ARGUMENTS with enhanced result for subsequent Codex calls** +`[Mode: Prepare]` - If ace-tool MCP available, call `mcp__ace-tool__enhance_prompt`, **replace original $ARGUMENTS with enhanced result for subsequent Codex calls**. If unavailable, use `$ARGUMENTS` as-is. ### Phase 1: Research `[Mode: Research]` - Understand requirements and gather context -1. **Code Retrieval** (if ace-tool MCP available): Call `mcp__ace-tool__search_context` to retrieve existing APIs, data models, service architecture +1. **Code Retrieval** (if ace-tool MCP available): Call `mcp__ace-tool__search_context` to retrieve existing APIs, data models, service architecture. If unavailable, use built-in tools: `Glob` for file discovery, `Grep` for symbol/API search, `Read` for context gathering, `Task` (Explore agent) for deeper exploration. 2. Requirement completeness score (0-10): >=7 continue, <7 stop and supplement ### Phase 2: Ideation diff --git a/commands/multi-execute.md b/commands/multi-execute.md index cc5c24bc..45efb4cd 100644 --- a/commands/multi-execute.md +++ b/commands/multi-execute.md @@ -136,7 +136,7 @@ TaskOutput({ task_id: "", block: true, timeout: 600000 }) `[Mode: Retrieval]` -**Must use MCP tool for quick context retrieval, do NOT manually read files one by one** +**If ace-tool MCP is available**, use it for quick context retrieval: Based on "Key Files" list in plan, call `mcp__ace-tool__search_context`: @@ -151,7 +151,12 @@ mcp__ace-tool__search_context({ - Extract target paths from plan's "Key Files" table - Build semantic query covering: entry files, dependency modules, related type definitions - If results insufficient, add 1-2 recursive retrievals -- **NEVER** use Bash + find/ls to manually explore project structure + +**If ace-tool MCP is NOT available**, use Claude Code built-in tools as fallback: +1. **Glob**: Find target files from plan's "Key Files" table (e.g., `Glob("src/components/**/*.tsx")`) +2. **Grep**: Search for key symbols, function names, type definitions across the codebase +3. **Read**: Read the discovered files to gather complete context +4. **Task (Explore agent)**: For broader exploration, use `Task` with `subagent_type: "Explore"` **After Retrieval**: - Organize retrieved code snippets diff --git a/commands/multi-frontend.md b/commands/multi-frontend.md index 64b3b261..cd74af44 100644 --- a/commands/multi-frontend.md +++ b/commands/multi-frontend.md @@ -85,13 +85,13 @@ EOF", ### Phase 0: Prompt Enhancement (Optional) -`[Mode: Prepare]` - If ace-tool MCP available, call `mcp__ace-tool__enhance_prompt`, **replace original $ARGUMENTS with enhanced result for subsequent Gemini calls** +`[Mode: Prepare]` - If ace-tool MCP available, call `mcp__ace-tool__enhance_prompt`, **replace original $ARGUMENTS with enhanced result for subsequent Gemini calls**. If unavailable, use `$ARGUMENTS` as-is. ### Phase 1: Research `[Mode: Research]` - Understand requirements and gather context -1. **Code Retrieval** (if ace-tool MCP available): Call `mcp__ace-tool__search_context` to retrieve existing components, styles, design system +1. **Code Retrieval** (if ace-tool MCP available): Call `mcp__ace-tool__search_context` to retrieve existing components, styles, design system. If unavailable, use built-in tools: `Glob` for file discovery, `Grep` for component/style search, `Read` for context gathering, `Task` (Explore agent) for deeper exploration. 2. Requirement completeness score (0-10): >=7 continue, <7 stop and supplement ### Phase 2: Ideation diff --git a/commands/multi-plan.md b/commands/multi-plan.md index 947fc953..cd685053 100644 --- a/commands/multi-plan.md +++ b/commands/multi-plan.md @@ -71,7 +71,7 @@ TaskOutput({ task_id: "", block: true, timeout: 600000 }) #### 1.1 Prompt Enhancement (MUST execute first) -**MUST call `mcp__ace-tool__enhance_prompt` tool**: +**If ace-tool MCP is available**, call `mcp__ace-tool__enhance_prompt` tool: ``` mcp__ace-tool__enhance_prompt({ @@ -83,9 +83,11 @@ mcp__ace-tool__enhance_prompt({ Wait for enhanced prompt, **replace original $ARGUMENTS with enhanced result** for all subsequent phases. +**If ace-tool MCP is NOT available**: Skip this step and use the original `$ARGUMENTS` as-is for all subsequent phases. + #### 1.2 Context Retrieval -**Call `mcp__ace-tool__search_context` tool**: +**If ace-tool MCP is available**, call `mcp__ace-tool__search_context` tool: ``` mcp__ace-tool__search_context({ @@ -96,7 +98,12 @@ mcp__ace-tool__search_context({ - Build semantic query using natural language (Where/What/How) - **NEVER answer based on assumptions** -- If MCP unavailable: fallback to Glob + Grep for file discovery and key symbol location + +**If ace-tool MCP is NOT available**, use Claude Code built-in tools as fallback: +1. **Glob**: Find relevant files by pattern (e.g., `Glob("**/*.ts")`, `Glob("src/**/*.py")`) +2. **Grep**: Search for key symbols, function names, class definitions (e.g., `Grep("className|functionName")`) +3. **Read**: Read the discovered files to gather complete context +4. **Task (Explore agent)**: For deeper exploration, use `Task` with `subagent_type: "Explore"` to search across the codebase #### 1.3 Completeness Check diff --git a/commands/multi-workflow.md b/commands/multi-workflow.md index c6e8e4ba..8ca12a9a 100644 --- a/commands/multi-workflow.md +++ b/commands/multi-workflow.md @@ -15,14 +15,14 @@ Structured development workflow with quality gates, MCP services, and multi-mode - Task to develop: $ARGUMENTS - Structured 6-phase workflow with quality gates - Multi-model collaboration: Codex (backend) + Gemini (frontend) + Claude (orchestration) -- MCP service integration (ace-tool) for enhanced capabilities +- MCP service integration (ace-tool, optional) for enhanced capabilities ## Your Role You are the **Orchestrator**, coordinating a multi-model collaborative system (Research → Ideation → Plan → Execute → Optimize → Review). Communicate concisely and professionally for experienced developers. **Collaborative Models**: -- **ace-tool MCP** – Code retrieval + Prompt enhancement +- **ace-tool MCP** (optional) – Code retrieval + Prompt enhancement - **Codex** – Backend logic, algorithms, debugging (**Backend authority, trustworthy**) - **Gemini** – Frontend UI/UX, visual design (**Frontend expert, backend opinions for reference only**) - **Claude (self)** – Orchestration, planning, execution, delivery @@ -111,8 +111,8 @@ TaskOutput({ task_id: "", block: true, timeout: 600000 }) `[Mode: Research]` - Understand requirements and gather context: -1. **Prompt Enhancement**: Call `mcp__ace-tool__enhance_prompt`, **replace original $ARGUMENTS with enhanced result for all subsequent Codex/Gemini calls** -2. **Context Retrieval**: Call `mcp__ace-tool__search_context` +1. **Prompt Enhancement** (if ace-tool MCP available): Call `mcp__ace-tool__enhance_prompt`, **replace original $ARGUMENTS with enhanced result for all subsequent Codex/Gemini calls**. If unavailable, use `$ARGUMENTS` as-is. +2. **Context Retrieval** (if ace-tool MCP available): Call `mcp__ace-tool__search_context`. If unavailable, use built-in tools: `Glob` for file discovery, `Grep` for symbol search, `Read` for context gathering, `Task` (Explore agent) for deeper exploration. 3. **Requirement Completeness Score** (0-10): - Goal clarity (0-3), Expected outcome (0-3), Scope boundaries (0-2), Constraints (0-2) - ≥7: Continue | <7: Stop, ask clarifying questions diff --git a/docs/ja-JP/commands/multi-backend.md b/docs/ja-JP/commands/multi-backend.md index e23af1ac..8c72936a 100644 --- 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: アイデア創出 diff --git a/docs/ja-JP/commands/multi-execute.md b/docs/ja-JP/commands/multi-execute.md index 8dd48ad0..d7b1f73c 100644 --- a/docs/ja-JP/commands/multi-execute.md +++ b/docs/ja-JP/commands/multi-execute.md @@ -136,7 +136,7 @@ TaskOutput({ 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"` で使用 **取得後**: - 取得したコードスニペットを整理 diff --git a/docs/ja-JP/commands/multi-frontend.md b/docs/ja-JP/commands/multi-frontend.md index f67664c0..50933946 100644 --- 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: アイデア創出 diff --git a/docs/ja-JP/commands/multi-plan.md b/docs/ja-JP/commands/multi-plan.md index db26be76..0f1c938b 100644 --- a/docs/ja-JP/commands/multi-plan.md +++ b/docs/ja-JP/commands/multi-plan.md @@ -71,7 +71,7 @@ TaskOutput({ 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 完全性チェック diff --git a/docs/ja-JP/commands/multi-workflow.md b/docs/ja-JP/commands/multi-workflow.md index 95b78440..cf4766dc 100644 --- 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: "", 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: 停止、明確化の質問を尋ねる diff --git a/docs/zh-CN/commands/multi-backend.md b/docs/zh-CN/commands/multi-backend.md index db6c43af..f7a94412 100644 --- 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：构思 diff --git a/docs/zh-CN/commands/multi-execute.md b/docs/zh-CN/commands/multi-execute.md index 09359915..2fe0be89 100644 --- a/docs/zh-CN/commands/multi-execute.md +++ b/docs/zh-CN/commands/multi-execute.md @@ -138,23 +138,28 @@ TaskOutput({ 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: "", - project_root_path: "$PWD" + query: “”, + 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”` **检索后**： diff --git a/docs/zh-CN/commands/multi-frontend.md b/docs/zh-CN/commands/multi-frontend.md index 59a03ede..c728fef0 100644 --- 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: 构思 diff --git a/docs/zh-CN/commands/multi-plan.md b/docs/zh-CN/commands/multi-plan.md index 1f3136f4..f1915eaf 100644 --- a/docs/zh-CN/commands/multi-plan.md +++ b/docs/zh-CN/commands/multi-plan.md @@ -73,7 +73,7 @@ TaskOutput({ 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 完整性检查 diff --git a/docs/zh-CN/commands/multi-workflow.md b/docs/zh-CN/commands/multi-workflow.md index 58e08cef..ddf3e55e 100644 --- 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: "", 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：停止，询问澄清问题