The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
fix(commands): make ace-tool MCP optional in multi-* commands with built-in fallbacks
to.watanabef94707d429dd
diff --git a/commands/multi-backend.md b/commands/multi-backend.mdindex c8bb7e1a0..d9faf18fd 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: Ideationdiff --git a/commands/multi-execute.md b/commands/multi-execute.mdindex cc5c24bc8..45efb4cde 100644--- a/commands/multi-execute.md+++ b/commands/multi-execute.md@@ -136,7 +136,7 @@ TaskOutput({ task_id: "<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 snippetsdiff --git a/commands/multi-frontend.md b/commands/multi-frontend.mdindex 64b3b2616..cd74af44a 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: Ideationdiff --git a/commands/multi-plan.md b/commands/multi-plan.mdindex 947fc9537..cd685053a 100644--- a/commands/multi-plan.md+++ b/commands/multi-plan.md@@ -71,7 +71,7 @@ TaskOutput({ task_id: "<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 Checkdiff --git a/commands/multi-workflow.md b/commands/multi-workflow.mdindex c6e8e4baf..8ca12a9a8 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 RoleYou 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: "<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 questionsdiff --git a/docs/ja-JP/commands/multi-backend.md b/docs/ja-JP/commands/multi-backend.mdindex e23af1ac1..8c72936ae 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.mdindex 8dd48ad00..d7b1f73c7 100644--- 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"` で使用**取得後**:- 取得したコードスニペットを整理diff --git a/docs/ja-JP/commands/multi-frontend.md b/docs/ja-JP/commands/multi-frontend.mdindex f67664c0d..509339466 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.mdindex db26be766..0f1c938bd 100644--- 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 完全性チェックdiff --git a/docs/ja-JP/commands/multi-workflow.md b/docs/ja-JP/commands/multi-workflow.mdindex 95b784408..cf4766dca 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: "<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.mdindex db6c43af0..f7a944121 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.mdindex 09359915b..2fe0be89f 100644--- 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”`**检索后**:diff --git a/docs/zh-CN/commands/multi-frontend.md b/docs/zh-CN/commands/multi-frontend.mdindex 59a03eded..c728fef01 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.mdindex 1f3136f48..f1915eaf9 100644--- 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 完整性检查diff --git a/docs/zh-CN/commands/multi-workflow.md b/docs/zh-CN/commands/multi-workflow.mdindex 58e08cefe..ddf3e55e7 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: "<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:停止,询问澄清问题