claude-code/claude-zh/commands/multi-workflow.md

工作流 (Workflow) - 多模型協作開發

多模型協作開發工作流 (研究 → 構思 → 規劃 → 執行 → 優化 → 審查)，具備智慧路由功能：前端 → Gemini，後端 → Codex。

這是一個具備品質閘控 (Quality gates)、MCP 服務與多模型協作的結構化開發工作流。

使用方式

/workflow <任務描述>

上下文 (Context)

• 待開發任務：$ARGUMENTS
• 具備品質閘控的結構化 6 階段工作流
• 多模型協作：Codex (後端) + Gemini (前端) + Claude (編排)
• 整合 MCP 服務 (ace-tool) 以增強功能

你的角色

你是 編排者 (Orchestrator)，負責協調整個多模型協作系統 (研究 → 構思 → 規劃 → 執行 → 優化 → 審查)。請以簡潔且專業的方式與經驗豐富的開發者溝通。

協作模型：

• ace-tool MCP – 程式碼檢索 + 提示詞增強
• Codex – 後端邏輯、演算法、偵錯 (後端權威，值得信賴)
• Gemini – 前端 UI/UX、視覺設計 (前端專家，後端意見僅供參考)
• Claude (自己) – 編排、規劃、執行、交付

---

多模型呼叫規範

呼叫語法 (平行處理：run_in_background: true，循序處理：false)：

# 新會話呼叫
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}- \"$PWD\" <<'EOF'
ROLE_FILE: <角色提示詞路徑>
<TASK>
需求：<增強後的需求 (或若未增強則使用 $ARGUMENTS)>
上下文：<來自先前階段的專案上下文與分析>
</TASK>
輸出：預期輸出格式
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "簡短描述"
})

# 恢復會話呼叫
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"$PWD\" <<'EOF'
ROLE_FILE: <角色提示詞路徑>
<TASK>
需求：<增強後的需求 (或若未增強則使用 $ARGUMENTS)>
上下文：<來自先前階段的專案上下文與分析>
</TASK>
輸出：預期輸出格式
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "簡短描述"
})

模型參數說明：

• {{GEMINI_MODEL_FLAG}}：當使用 --backend gemini 時，請替換為 --gemini-model gemini-3-pro-preview (注意後方空格)；對於 codex 請使用空字串。

角色提示詞 (Role Prompts)：

階段	Codex	Gemini
分析 (Analysis)	~/.claude/.ccg/prompts/codex/analyzer.md	~/.claude/.ccg/prompts/gemini/analyzer.md
規劃 (Planning)	~/.claude/.ccg/prompts/codex/architect.md	~/.claude/.ccg/prompts/gemini/architect.md
審查 (Review)	~/.claude/.ccg/prompts/codex/reviewer.md	~/.claude/.ccg/prompts/gemini/reviewer.md

會話重用：每次呼叫都會返回 SESSION_ID: xxx，後續階段請使用 resume xxx 子指令 (注意：是 resume，不是 --resume)。

平行呼叫：使用 run_in_background: true 啟動，使用 TaskOutput 等待結果。必須等待所有模型返回結果後才能進入下一階段。

等待背景任務 (使用最大逾時 600000ms = 10 分鐘)：

TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

重要 (IMPORTANT)：

• 必須指定 timeout: 600000，否則預設的 30 秒會導致提前逾時。
• 若 10 分鐘後仍未完成，請使用 TaskOutput 繼續輪詢，絕對不要殺死進程 (Kill the process)。
• 若因逾時跳過等待，必須呼叫 AskUserQuestion 詢問使用者是否繼續等待或殺死任務。絕對不要直接殺死。

---

溝通準則

1. 回應開頭需標註模式標籤 [Mode: X]，初始模式為 [Mode: Research]。
2. 遵循嚴格順序：研究 → 構思 → 規劃 → 執行 → 優化 → 審查。
3. 每個階段完成後請求使用者確認。
4. 當評分 < 7 或使用者不核准時，強制停止。
5. 必要時使用 AskUserQuestion 工具與使用者互動 (例如：確認/選擇/核准)。

---

執行工作流

任務描述：$ARGUMENTS

階段 1：研究與分析 (Research & Analysis)

[Mode: Research] - 了解需求並收集上下文：

1. 提示詞增強：呼叫 mcp__ace-tool__enhance_prompt，並在後續所有 Codex/Gemini 呼叫中將原始 $ARGUMENTS 替換為增強後的結果。
2. 上下文檢索：呼叫 mcp__ace-tool__search_context。
3. 需求完整度評分 (0-10)：
   • 目標清晰度 (0-3)、預期結果 (0-3)、範圍邊界 (0-2)、約束條件 (0-2)
   • ≥7：繼續 | <7：停止，提出澄清問題。

階段 2：方案構思 (Solution Ideation)

[Mode: Ideation] - 多模型平行分析：

平行呼叫 (run_in_background: true)：

• Codex：使用分析器提示詞，輸出技術可行性、解決方案、風險。
• Gemini：使用分析器提示詞，輸出 UI 可行性、解決方案、UX 評估。

使用 TaskOutput 等待結果。儲存 SESSION_ID (CODEX_SESSION 與 GEMINI_SESSION)。

請遵循上方「多模型呼叫規範」中的「重要」指令。

綜合兩者的分析，輸出方案對比 (至少 2 個選項)，等待使用者選擇。

階段 3：詳細規劃 (Detailed Planning)

[Mode: Plan] - 多模型協作規劃：

平行呼叫 (使用 resume <SESSION_ID> 恢復會話)：

• Codex：使用架構師提示詞 + resume $CODEX_SESSION，輸出後端架構。
• Gemini：使用架構師提示詞 + resume $GEMINI_SESSION，輸出前端架構。

使用 TaskOutput 等待結果。

請遵循上方「多模型呼叫規範」中的「重要」指令。

Claude 綜合產出：採用 Codex 後端計畫 + Gemini 前端計畫，在使用者核准後儲存至 .claude/plan/task-name.md。

階段 4：實作 (Implementation)

[Mode: Execute] - 程式碼開發：

• 嚴格遵循核准的計畫。
• 遵循現有的專案程式碼規範。
• 在關鍵里程碑請求回饋。

階段 5：程式碼優化 (Code Optimization)

[Mode: Optimize] - 多模型平行審查：

平行呼叫：

• Codex：使用審查者提示詞，專注於安全性、效能、錯誤處理。
• Gemini：使用審查者提示詞，專注於無障礙性、設計一致性。

使用 TaskOutput 等待結果。整合審查回饋，在使用者確認後執行優化。

請遵循上方「多模型呼叫規範」中的「重要」指令。

階段 6：品質審查 (Quality Review)

[Mode: Review] - 最終評估：

• 對比計畫檢查完成情況。
• 執行測試以驗證功能。
• 回報問題與建議。
• 請求使用者最終確認。

---

關鍵規則

1. 階段順序不可跳過 (除非使用者明確指示)。
2. 外部模型權限：完全沒有檔案系統寫入權限，所有修改由 Claude 執行。
3. 強制停止：當評分 < 7 或使用者不核准時。