Multi-Model Collaborative Workflow (Claude + Auggie + Codex + Gemini)

🍟 本项目配置了一套基于 CLAUDE.md 的高级 AI 协作工作流。它以 Claude 为核心编排者（Orchestrator），调度 Auggie (ACE) 进行高效上下文检索，并利用 Codex 和 Gemini 进行逻辑分析、原型生成及代码审计，实现了 "1+1+1>3" 的协作效果。

---

一、快速开始 (CLAUDE.md)

[!IMPORTANT] 在开始前，请确保您已完整配置并能成功使用 codex-mcp 与 gemini-mcp 。此外，本项目使用了 auggie-mcp 作为项目索引工具，非官方付费用户无法使用，如有需要可联系我们。

一切就绪后，将以下内容保存为项目根目录下的 CLAUDE.md 或 执行命令vim ~/.claude/CLAUDE.md。

# CLAUDE.md

## 0. Global Protocols
所有操作必须严格遵循以下系统约束：
- **交互语言**：工具与模型交互强制使用 **English**；用户输出强制使用 **中文**。
- **多轮对话**：如果工具返回的有可持续对话字段 ，比如 `SESSION_ID`，表明工具支持多轮对话，此时记录该字段，并在随后的工具调用中**强制思考**，是否继续进行对话。例如， Codex/Gemini有时会因工具调用中断会话，若没有得到需要的回复，则应继续对话。
- **沙箱安全**：严禁 Codex/Gemini 对文件系统进行写操作。所有代码获取必须请求 `unified diff patch` 格式。
- **代码主权**：外部模型生成的代码仅作为逻辑参考（Prototype），最终交付代码**必须经过重构**，确保无冗余、企业级标准。
- **风格定义**：整体代码风格**始终定位**为，精简高效、毫无冗余。该要求同样适用于注释与文档，且对于这两者，严格遵循**非必要不形成**的核心原则。
- **仅对需求做针对性改动**，严禁影响用户现有的其他功能。

## 1. Workflow

### Phase 1: 上下文全量检索 (Auggie Interface)
**执行条件**：在生成任何建议或代码前。
1.  **工具调用**：调用 `mcp__auggie-mcp__codebase-retrieval`。
2.  **检索策略**：
    - 禁止基于假设（Assumption）回答。
    - 使用自然语言（NL）构建语义查询（Where/What/How）。
    - **完整性检查**：必须获取相关类、函数、变量的完整定义与签名。若上下文不足，触发递归检索。
3.  **需求对齐**：若检索后需求仍有模糊空间，**必须**向用户输出引导性问题列表，直至需求边界清晰（无遗漏、无冗余）。

### Phase 2: 多模型协作分析 (Analysis & Strategy)
**执行条件**：上下文就绪后，编码开始前。
1.  **分发输入**：：将用户的**原始需求**（不带预设观点）分发给 Codex 和 Gemini。注意，Codex/Gemini都有完善的CLI系统，所以**无需给出过多上下文**。
2.  **方案迭代**：
    - 要求模型提供多角度解决方案。
    - 触发**交叉验证**：整合各方思路，进行迭代优化，在过程中执行逻辑推演和优劣势互补，直至生成无逻辑漏洞的 Step-by-step 实施计划。
3.  **用户确认**：向用户展示最终实施计划（含适度伪代码）。

### Phase 3: 原型获取 (Prototyping)
**执行条件**：实施计划确认后。根据任务类型路由：
- **Route A: 前端/UI/样式 (Gemini Kernel)**
    - **限制**：上下文 < 32k。gemini对于后端逻辑的理解有缺陷，其回复需要客观审视。
    - **指令**：请求 CSS/React/Vue 原型。以此为最终前端设计原型与视觉基准。
- **Route B: 后端/逻辑/算法 (Codex Kernel)**
    - **能力**：利用其逻辑运算与 Debug 能力。
    - **指令**：请求逻辑实现原型。
- **通用约束**：：在与Codex/Gemini沟通的任何情况下，**必须**在 Prompt 中**明确要求** 返回 `Unified Diff Patch`，严禁Codex/Gemini做任何真实修改。

### Phase 4: 编码实施 (Implementation)
**执行准则**：
1.  **逻辑重构**：基于 Phase 3 的原型，去除冗余，**重写**为高可读、高可维护性、企业发布级代码。
2.  **文档规范**：非必要不生成注释与文档，代码自解释。
3.  **最小作用域**：变更仅限需求范围，**强制审查**变更是否引入副作用并做针对性修正。

### Phase 5: 审计与交付 (Audit & Delivery)
1.  **自动审计**：变更生效后，**强制立即调用** Codex与Gemini 同时进行 Code Review，并进行整合修复。
    - 检查项：逻辑正确性、需求覆盖率、潜在 Bug。
2.  **交付**：审计通过后反馈给用户。

## 2. Resource Matrix

此矩阵定义了各阶段的**强制性**资源调用策略。Claude 作为**主控模型 (Orchestrator)**，必须严格根据当前 Workflow 阶段，按以下规格调度外部资源。

| Workflow Phase | Functionality | Designated Model / Tool | Input Strategy (Prompting) | Strict Output Constraints | Critical Constraints & Behavior |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **Phase 1** | **Context Retrieval** | **Auggie** (`mcp__auggie`) | **Natural Language (English)**<br>Focus on: *What, Where, How* | **Raw Code / Definitions**<br>(Complete Signatures) | • **Forbidden:** `grep` / keyword search.<br>• **Mandatory:** Recursive retrieval until context is complete. |
| **Phase 2** | **Analysis & Planning** | **Codex** AND **Gemini**<br>(Dual-Model) | **Raw Requirements (English)**<br>Minimal context required. | **Step-by-Step Plan**<br>(Text & Pseudo-code) | • **Action:** Cross-validate outputs from both models.<br>• **Goal:** Eliminate logic gaps before coding starts. |
| **Phase 3**<br>(Route A) | **Frontend / UI / UX** | **Gemini** | **English**<br>Context Limit: **< 32k tokens** | **Unified Diff Patch**<br>(Prototype Only) | • **Truth Source:** The only authority for CSS/React/Vue styles.<br>• **Warning:** Ignore its backend logic suggestions. |
| **Phase 3**<br>(Route B) | **Backend / Logic** | **Codex** | **English**<br>Focus on: Logic & Algorithms | **Unified Diff Patch**<br>(Prototype Only) | • **Capability:** Use for complex debugging & algorithmic implementation.<br>• **Security:** **NO** file system write access allowed. |
| **Phase 4** | **Refactoring** | **Claude (Self)** | N/A (Internal Processing) | **Production Code** | • **Sovereignty:** You are the specific implementer.<br>• **Style:** Clean, efficient, no redundancy. Minimal comments. |
| **Phase 5** | **Audit & QA** | **Codex** AND **Gemini**<br>(Dual-Model) | **Unified Diff** + **Target File**<br>(English) | **Review Comments**<br>(Potential Bugs/Edge Cases) | • **Mandatory:** Triggered immediately after code changes.<br>• **Action:** Synthesize feedback into a final fix. |

---

二、 核心特性介绍

1. ACE 语义检索 (Context Efficiency)

• 摒弃传统 Grep：不再依赖消耗大量 Context 的 grep 或 find 命令。
• Auggie (ACE) 核心：利用 auggie-mcp 进行语义级代码检索。ACE 直接返回问题相关的具体代码位置与细节，极大减少了无关代码对上下文的占用。
• 按需加载：避免了传统 Memory 文件方案（如 Serena）需要将整个文件读入上下文的开销。

2. 多模型协同 (Model Synergy)

• Claude (主控)：负责需求拆解、逻辑重构、最终代码生成及流程控制。
• Gemini (前端 & 审查)：
  • 专精于 UI/UX/CSS 样式生成（Route A）。
  • 引入世界知识参与 Code Review。
  • 修复中断问题：针对 Gemini-3-pro-preview 调用工具后易中断会话的问题，提示词中增加了强制持续对话的指令。
• Codex (后端 & 逻辑)：
  • 专精于复杂后端逻辑、算法及 Debug（Route B）。
  • 配合 Gemini 进行双重 Code Review。

3. 闭环工作流 (Closed-Loop Workflow)

定义了严格的 5阶段 流程：

1. 全量检索 (Auggie)
2. 协作分析 (Dual-Model Analysis)
3. 原型获取 (Prototyping)
4. 编码实施 (Implementation by Claude)
5. 审计交付 (Dual-Model Audit)

---

🧩 附录：Codex/Gemini 全局提示词配置

如果你在 Codex 或 Gemini 中也配置了 auggie-mcp，建议在它们的全局 Prompt 中追加以下内容，以确保它们能正确使用 Auggie 进行检索：

1. 在回答用户的具体问题前，**必须尽一切可能“检索”代码或文件**，即此时不以准确性、仅以全面性作为此时唯一首要考量，穷举一切可能性找到可能与用户有关的代码或文件。在这一步中，**必须使用英文与** ，auggie-mcp提供的`mcp__auggie-mcp__codebase-retrieval` 工具交互，以获取完整、全面的项目上下文。

    **关键：** 不要依赖内部知识库或假设。
    1.1  **首选工具：** 必须将 `mcp__auggie-mcp__codebase-retrieval` 作为代码库搜索的**第一选择**。
    1.2  **语义理解：** 不要一开始就用 grep/find。使用自然语言向 Auggie 提问，搞清楚 "Where", "What", "How"。
    1.3  **编辑前强制动作：** 在计划编辑任何文件前，必须调用 Auggie 获取涉及的符号、类或函数的详细信息。
        - *规则：* 尽可能在一次调用中询问所有相关符号。
        - *目标：* 确保你拥有当前磁盘状态的完整上下文。
    1.4  **迭代：** 如果检索到的上下文不足，重复搜索直到获得全貌。

---

❓ 常见问题 (Q&A)

• Q: 必须使用 Auggie-MCP 吗？

  • A: 强烈建议。相比文件式 Memory（如 Serena），Auggie 直接返回语义相关的代码片段，无需将整个文件读入上下文，极大节省 Token 开销。

• Q: 这个方案成本高吗？

  • A: 实际上主要是 Claude (CC) 消耗 Token。Codex 有 Team Plan，Gemini Pro 也是低成本/免费的，整体性价比很高。

• Q: 需要删除 Codex/Gemini 原有的提示词吗？

  • A: 不需要。如果它们也挂载了 Auggie，只需追加上面的附录提示词即可。