ccg-workflow 1.6.0 → 1.7.1

package/templates/commands/frontend.md

@@ -1,200 +1,138 @@
 ---
-description: 前端/UI/样式任务，自动路由到配置的前端模型进行原型生成和审计
+description: '前端专项工作流（研究→构思→计划→执行→优化→评审），Gemini主导'
 ---
 
-## 用法
-`/frontend <UI_TASK_DESCRIPTION>`
+# Frontend - 前端专项开发
+
+## 使用方法
+
+```bash
+/frontend <UI任务描述>
+```
 
 ## 上下文
-- Frontend/UI task to implement: $ARGUMENTS
-- This command routes to your configured frontend models.
-- Default authority for CSS, React, Vue, and visual design.
 
-## ⭐ v1.6.0 重大升级
+- 前端任务：$ARGUMENTS
+- Gemini 主导，Codex 辅助参考
+- 适用：组件设计、响应式布局、UI动画、样式优化
 
-**从单模型调用升级为多模型并行工作流！**
+## 你的角色
+
+你是**前端编排者**，协调多模型完成 UI/UX 任务（研究 → 构思 → 计划 → 执行 → 优化 → 评审），用中文协助用户。
 
-### 新增功能
+**协作模型**：
+- **Gemini** – 前端 UI/UX（**前端权威，可信赖**）
+- **Codex** – 后端视角（**前端意见仅供参考**）
+- **Claude (自己)** – 编排、计划、执行、交付
 
-✅ **5阶段完整工作流**：
-- Step 1: 上下文检索（MCP）
-- Step 2: **多模型前端分析**（Gemini + Claude 并行） ← 新增
-- Step 3: **多模型原型生成**（所有前端模型并行） ← 增强
-- Step 4: 重构与实施（Claude 综合各模型优势）
-- Step 5: **多模型审计交付**（Gemini + Claude 交叉验证） ← 新增
+[沟通守则]
 
-✅ **交叉验证机制**：
-- Gemini 提供视觉设计和 UI 创新优势
-- Claude 提供更好的可访问性和代码结构
-- 综合各模型优势，重构为生产级 UI 代码
+1. 响应以模式标签 `[模式：X]` 开始，初始为 `[模式：研究]`
+2. 严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转
 
-✅ **强制用户确认**：
-- Step 2 分析完成后，会询问"是否继续执行此方案？(Y/N)"
-- 避免盲目执行，确保用户对方案满意
+---
 
-### 与 /ccg:dev 的区别
+## 多模型调用语法
 
-| 特性 | /ccg:frontend | /ccg:dev |
-|------|--------------|----------|
-| **模型范围** | 仅前端模型（Gemini + Claude）| 全部模型（前端+后端）|
-| **适用场景** | 前端专项任务 | 全栈功能开发 |
-| **Prompt 增强** | ❌ 不包含 | ✅ Phase 0 |
-| **工作流阶段** | 5 阶段 | 6 阶段（含 Prompt 增强）|
-| **推荐用户** | 前端/UI 开发者 | 全栈开发者 |
+```bash
+# Gemini 调用（前端主力）
+~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF'
+[角色提示词内容]
 
-### 使用建议
+[任务内容]
+EOF
 
-- 🎯 **纯前端任务**：使用 `/ccg:frontend`（如：组件设计、响应式布局、UI 动画）
-- 🎯 **全栈功能**：使用 `/ccg:dev`（如：用户登录功能，涉及前后端）
-- 🎯 **需要 Prompt 增强**：使用 `/ccg:dev`（复杂需求，需先优化需求描述）
+# Codex 调用（后端参考）
+~/.claude/bin/codeagent-wrapper --backend codex - "$PWD" <<'EOF'
+[任务内容]
+EOF
+```
 
 ---
 
-## 你的角色
-You are the **Frontend Orchestrator** specializing in UI/UX implementation. You coordinate:
-1. **ace-tool** – for retrieving existing frontend code and components
-2. **Configured Frontend Models** – for generating CSS/React/Vue prototypes
-3. **Claude (Self)** – for refactoring prototypes into production code
+## 核心工作流
+
+### 🔍 阶段 0：Prompt 增强（可选）
+
+`[模式：准备]` - 增强任务描述
 
-## 流程
+**如果 ace-tool MCP 可用**，调用 `mcp__ace-tool__enhance_prompt`：
+- 输入原始任务描述
+- 获取增强后的详细需求
+- 用增强后的需求替代原始 $ARGUMENTS
 
-### Step 1: 上下文检索
-1. Call `mcp__ace-tool__search_context` to find existing UI components, styles, and patterns:
-   - `project_root_path`: Project root directory absolute path
-   - `query`: Natural language description of the UI/frontend task
-2. Identify the design system, component library, and styling conventions in use
-3. 如需求仍不清晰，提出澄清问题
+### 🔍 阶段 1：研究
 
-### Step 2: 多模型前端分析
+`[模式：研究]` - 理解需求并收集上下文
 
-**并行调用所有配置的前端模型进行分析**（使用 `run_in_background: true`）：
+1. **代码检索**（如 ace-tool MCP 可用）：调用 `mcp__ace-tool__search_context` 检索现有组件、样式、设计系统
+2. 需求完整性评分（0-10 分）：≥7 继续，<7 停止补充
 
-遍历 {{FRONTEND_MODELS}} 中的每个模型进行前端分析：
-- 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/analyzer.md`
-- 输出：`Structured analysis/diagnostic report`
+### 💡 阶段 2：构思
 
-**总共并行调用次数**: {{FRONTEND_MODELS}} 长度（例如：配置 gemini + claude = 2次）
+`[模式：构思]` - Gemini 主导分析
+
+**调用示例**：
 
-调用示例：
 ```bash
-# 遍历前端模型列表（假设配置了 gemini 和 claude）
-for model in gemini claude; do
-  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
-ROLE_FILE: ~/.claude/.ccg/prompts/$model/analyzer.md
-
-<TASK>
-分析前端需求: {{前端任务描述}}
-Context: {{从 MCP 获取的组件和样式}}
-关注点:
-- 组件设计和复用性
-- UI/UX 交互流程
-- 响应式布局策略
-- 可访问性 (a11y) 要求
-- 性能优化（懒加载、代码分割）
-- 设计系统一致性
-</TASK>
-
-OUTPUT: Structured analysis/diagnostic report.
+~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF'
+你是前端分析专家，擅长 UI/UX、组件设计、响应式布局。
+
+任务：分析以下前端需求，提供设计方案
+- 组件结构与状态管理
+- 响应式策略
+- 可访问性考虑
+- 性能优化建议
+
+需求：[具体任务描述]
 EOF
-done
 ```
 
-使用 `TaskOutput` 获取所有模型的分析结果，交叉验证后综合方案。
+**⚠️ 等待 Gemini 返回后继续**
 
-**强制停止**: 询问用户 **"是否继续执行此方案？(Y/N)"** 并等待确认
+输出方案（至少 2 个），等待用户选择。
 
-### Step 3: 多模型原型生成
+### 📋 阶段 3：计划
 
-**并行调用所有配置的前端模型生成原型**（使用 `run_in_background: true`）：
+`[模式：计划]` - Gemini 主导规划
 
-遍历 {{FRONTEND_MODELS}} 中的每个模型生成前端原型：
-- 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/frontend.md`（如无 frontend 角色，使用 architect）
-- 输出：`Unified Diff Patch ONLY`
+调用 Gemini（`architect.md`）→ 组件结构、UI流程、样式方案
 
-**总共并行调用次数**: {{FRONTEND_MODELS}} 长度（例如：配置 gemini + claude = 2次）
+**⚠️ 等待 Gemini 返回后继续**
 
-调用示例：
-```bash
-# 遍历前端模型生成原型
-for model in $(echo '{{FRONTEND_MODELS}}' | jq -r '.[]'); do
-  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
-ROLE_FILE: ~/.claude/.ccg/prompts/$model/frontend.md
-
-<TASK>
-生成前端原型: {{前端任务描述}}
-Context: {{相关组件和样式}}
-实现要点:
-- 遵循现有组件设计模式
-- 实现响应式布局
-- 确保可访问性 (ARIA 标签)
-- 使用设计系统的 tokens
-- 考虑性能优化
-</TASK>
-
-OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
-EOF
-done
-```
+Claude 综合规划，请求用户批准后存入 `.claude/plan/任务名.md`
 
-使用 `TaskOutput` 收集所有模型的原型结果。
+### ⚡ 阶段 4：执行
 
-### Step 4: 重构与实施
-1. 将所有模型的原型视为"脏原型" – 仅作参考
-2. **交叉验证所有模型结果，集各家所长**：
-   - 分析每个模型的优势和不足
-   - Gemini 通常在视觉设计和 UI 创新上更强
-   - Claude 可能提供更好的可访问性和代码结构
-   - 选择最佳实现方案或综合创新点
-3. 重构为干净的生产级代码
-4. 确保与现有组件的一致性
-5. 验证响应式布局和可访问性
+`[模式：执行]` - 代码开发
 
-### Step 5: 多模型审计交付
+- 严格按批准的计划实施
+- 遵循项目现有设计系统和代码规范
+- 确保响应式、可访问性
 
-**并行调用所有配置的前端模型进行审计**（使用 `run_in_background: true`）：
+### 🚀 阶段 5：优化
 
-遍历 {{FRONTEND_MODELS}} 中的每个模型进行代码审查：
-- 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/reviewer.md`
-- 输出：`Review comments only`
+`[模式：优化]` - Gemini 主导审查
 
-**总共并行调用次数**: {{FRONTEND_MODELS}} 长度（例如：配置 gemini + claude = 2次）
+调用 Gemini（`reviewer.md`）→ 可访问性、响应式、性能、设计一致性
 
-调用示例：
-```bash
-# 遍历前端模型列表进行审计
-for model in $(echo '{{FRONTEND_MODELS}}' | jq -r '.[]'); do
-  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
-ROLE_FILE: ~/.claude/.ccg/prompts/$model/reviewer.md
-
-<TASK>
-审查前端代码: {{实施的代码变更}}
-关注点:
-- 可访问性（WCAG 2.1 AA 标准）
-- 响应式设计（移动端适配）
-- 性能（首屏渲染、Lighthouse 分数）
-- 设计一致性（颜色、字体、间距）
-- 代码质量（组件复用、prop 类型）
-- 浏览器兼容性
-</TASK>
-
-OUTPUT: Review comments only. No code modifications.
-EOF
-done
-```
+**⚠️ 等待 Gemini 返回后继续**
+
+整合审查意见，用户确认后执行优化。
 
-使用 `TaskOutput` 收集所有模型的审计结果，交叉验证后提供综合反馈。
+### ✅ 阶段 6：评审
 
-**最终交付**: 根据审计反馈进行必要的调整，确保 UI 达到生产级质量。
+`[模式：评审]` - 最终评估
+
+- 对照计划检查完成情况
+- 验证响应式和可访问性
+- 报告问题与建议
+
+---
 
-## 输出格式
-1. **Configuration** – 使用的模型和策略 ({{FRONTEND_MODELS}})
-2. **Component Analysis** – 现有组件模式和设计系统
-3. **Multi-Model Analysis** – 所有前端模型的分析报告（交叉验证）
-4. **Multi-Model Prototypes** – 所有前端模型的原型（交叉验证）
-5. **Refined Implementation** – 综合各模型优势的生产级 UI 代码
-6. **Multi-Model Audit** – 所有前端模型的审计反馈（交叉验证）
+## 关键规则
 
-## 注意事项
-- Gemini context limit: < 32k tokens
-- Always request Unified Diff Patch format
-- Use HEREDOC syntax (`<<'EOF'`) to avoid shell escaping issues
+1. **Gemini 前端意见可信赖**
+2. **Codex 前端意见仅供参考**
+3. 外部模型对文件系统**零写入权限**
+4. Claude 负责所有代码写入和文件操作

package/templates/commands/init.md

@@ -1,53 +1,117 @@
 ---
-description: 初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引
-allowed-tools: Read(**), Write(CLAUDE.md, **/CLAUDE.md)
-argument-hint: <项目摘要或名称>
+description: '初始化项目 AI 上下文：生成根级与模块级 CLAUDE.md 索引'
 ---
 
-## 用法
+# Init - 初始化项目 AI 上下文
 
-`/init-project <项目摘要或名称>`
+以「根级简明 + 模块级详尽」策略生成项目 AI 上下文文档。
 
-## 目标
+## 使用方法
 
-以"根级简明 + 模块级详尽"的混合策略初始化项目 AI 上下文：
+```bash
+/init <项目摘要或名称>
+```
 
-- 在仓库根生成/更新 `CLAUDE.md`（高层愿景、架构总览、模块索引、全局规范）。
-- 在识别的各模块目录生成/更新本地 `CLAUDE.md`（接口、依赖、入口、测试、关键文件等）。
-- ✨ **为了提升可读性，会在根 `CLAUDE.md` 中自动生成 Mermaid 结构图，并为每个模块 `CLAUDE.md` 添加导航面包屑**。
+## 上下文
 
-## 编排说明
+- 项目摘要：$ARGUMENTS
+- 生成/更新根级与模块级 `CLAUDE.md`
+- 自动生成 Mermaid 结构图和导航面包屑
 
-**步骤 1**：调用 `get-current-datetime` 子智能体获取当前时间戳。
+## 你的角色
 
-**步骤 2**：调用一次 `init-architect` 子智能体，输入：
+你是**项目架构师**，负责扫描仓库并生成 AI 上下文文档：
+- 根级 `CLAUDE.md`：高层愿景、架构总览、模块索引
+- 模块级 `CLAUDE.md`：接口、依赖、入口、测试、关键文件
 
-- `project_summary`: $ARGUMENTS
-- `current_timestamp`: (来自步骤1的时间戳)
+---
+
+## 执行工作流
+
+### 🔍 阶段 A：全仓清点
+
+`[模式：扫描]`
+
+1. 调用 `get-current-datetime` 子智能体获取当前时间戳
+2. 快速统计文件与目录
+3. 识别模块根：
+   - `package.json` / `pyproject.toml` / `go.mod`
+   - `apps/*` / `packages/*` / `services/*`
+
+### 📦 阶段 B：模块优先扫描
+
+`[模式：分析]`
+
+对每个模块做定点读取：
+- 入口文件
+- 接口定义
+- 依赖关系
+- 测试覆盖
+- 数据模型
+- 质量工具
+
+### 🔬 阶段 C：深度补捞（按需）
+
+`[模式：深度]`
+
+- 仓库较小：扩大读取面
+- 仓库较大：对高价值路径分批追加扫描
+
+### ✅ 阶段 D：生成文档
 
-## 执行策略（由 Agent 自适应决定，不需要用户传参）
+`[模式：执行]`
 
-- **阶段 A：全仓清点（轻量）**
-  快速统计文件与目录，识别模块根（package.json、pyproject.toml、go.mod、apps/_、packages/_、services/\* 等）。
-- **阶段 B：模块优先扫描（中等）**
-  对每个模块做"入口/接口/依赖/测试/数据模型/质量工具"的定点读取与样本抽取。
-- **阶段 C：深度补捞（按需）**
-  若仓库较小或模块规模较小，则扩大读取面；若较大，则对高风险/高价值路径分批追加扫描。
-- **覆盖率度量与可续跑**
-  输出"已扫描文件数 / 估算总文件数、已覆盖模块占比、被忽略/跳过原因"，并列出"建议下一步深挖的子路径"。重复运行 `/init-project` 时按上次索引做**增量更新**与**断点续扫**。
+1. 生成根级 `CLAUDE.md`
+   - 项目概述
+   - 架构图（Mermaid）
+   - 模块索引
+   - 全局规范
+2. 生成模块级 `CLAUDE.md`
+   - 导航面包屑
+   - 模块职责
+   - 关键文件
+   - 接口说明
+
+---
+
+## 输出格式
+
+```markdown
+## 初始化结果摘要
+
+### 根级文档
+- 状态：[创建/更新]
+- 主要栏目：<列表>
+
+### 模块识别
+- 识别模块数：X
+- 模块列表：
+  1. <模块路径>
+  2. ...
+
+### 覆盖率
+- 已扫描文件：X / Y
+- 覆盖模块：X%
+- 跳过原因：<如有>
+
+### 生成内容
+- ✅ Mermaid 结构图
+- ✅ N 个模块导航面包屑
+
+### 推荐下一步
+- [ ] 补扫：<路径>
+```
+
+---
 
-## 安全与边界
+## 安全边界
 
-- 只读/写文档与索引，不改源代码。
-- 默认忽略常见生成物与二进制大文件。
-- 结果在主对话打印"摘要"，全文写入仓库。
+1. **只读/写文档** – 不改源代码
+2. **忽略生成物** – 跳过 `node_modules`、`dist`、二进制文件
+3. **增量更新** – 重复运行时做断点续扫
 
-## 输出要求
+## 关键规则
 
-- 在主对话中打印"初始化结果摘要"，包含：
-  - 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览。
-  - 识别的模块数量及其路径列表。
-  - 每个模块 `CLAUDE.md` 的生成/更新情况。
-  - ✨ **明确提及"已生成 Mermaid 结构图"和"已为 N 个模块添加导航面包屑"**。
-  - 覆盖率与主要缺口。
-  - 若未读全：说明"为何到此为止"，并列出**推荐的下一步**（例如"建议优先补扫：packages/auth/src/controllers"）。
+1. 调用 `init-architect` 子智能体执行扫描
+2. 结果在主对话打印摘要，全文写入仓库
+3. 输出覆盖率与建议下一步

package/templates/commands/optimize.md

@@ -1,98 +1,165 @@
 ---
-description: 多模型性能优化（Codex 后端优化 + Gemini 前端优化）
+description: '多模型性能优化：Codex 后端优化 + Gemini 前端优化'
 ---
 
-## 用法
-`/optimize <优化目标>`
+# Optimize - 多模型性能优化
+
+双模型并行分析性能瓶颈，按性价比排序优化建议。
+
+## 多模型调用语法
+
+**必须使用 heredoc 语法调用外部模型**：
+
+```bash
+~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - $PWD <<'EOF'
+<任务内容>
+EOF
+```
+
+> ⚠️ 禁止使用 `echo | codeagent-wrapper` 管道语法，会导致多行内容截断。
+
+---
+
+## 使用方法
+
+```bash
+/optimize <优化目标>
+```
 
 ## 上下文
-- 优化目标: $ARGUMENTS
+
+- 优化目标：$ARGUMENTS
 - Codex 专注后端性能（数据库、算法、缓存）
 - Gemini 专注前端性能（渲染、加载、交互）
 
-## 流程
+## 你的角色
+
+你是**性能工程师**，编排多模型优化流程：
+- **Codex** – 后端性能优化（**后端权威**）
+- **Gemini** – 前端性能优化（**前端权威**）
+- **Claude (自己)** – 综合优化、实施变更
+
+---
+
+## 执行工作流
+
+**优化目标**：$ARGUMENTS
+
+### 🔍 阶段 0：Prompt 增强（可选）
+
+`[模式：准备]` - 增强任务描述
+
+**如果 ace-tool MCP 可用**，调用 `mcp__ace-tool__enhance_prompt`：
+- 输入原始优化目标
+- 获取增强后的详细需求
+- 用增强后的需求替代原始 $ARGUMENTS
+
+### 🔍 阶段 1：性能基线
 
-### Phase 1: 性能基线分析
-1. 调用 `mcp__ace-tool__search_context` 检索目标代码:
-   - `project_root_path`: 项目根目录绝对路径
-   - `query`: 需要优化的目标代码描述
+`[模式：研究]`
+
+1. 调用 `mcp__ace-tool__search_context` 检索目标代码（如可用）
 2. 识别性能关键路径
-3. 收集现有指标（如有）：
-   - 后端: 响应时间、查询耗时、内存占用
-   - 前端: LCP、FID、CLS、Bundle Size
+3. 收集现有指标（如有）
 
-### Phase 2: 并行性能分析
-**同时调用**（`run_in_background: true`）:
+### 🔬 阶段 2：并行性能分析
 
-**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
+`[模式：分析]`
 
-```bash
-# Codex 后端性能分析
-codeagent-wrapper --backend {{BACKEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/optimizer.md
+**并行调用两个模型**：
 
-<TASK>
-性能优化: {{优化目标}}
-Context: {{从 ace-tool 获取的相关代码和性能指标}}
-</TASK>
+**执行步骤**：
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程：
 
-OUTPUT: Analysis report + Unified Diff Patch for optimizations.
-EOF
+**Codex 性能分析进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
+[角色] 你是后端性能优化专家
+
+[任务] 分析以下代码的后端性能问题：
+$ARGUMENTS
+
+[输出格式]
+1. 性能瓶颈列表（按严重程度排序）
+2. 每个问题的优化方案（含代码 Diff）
+3. 预期收益评估
+EOF_CODEX",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 后端性能分析"
+})
 ```
 
-```bash
-# Gemini 前端性能分析
-codeagent-wrapper --backend {{FRONTEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/optimizer.md
+**Gemini 性能分析进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
+[角色] 你是前端性能优化专家
+
+[任务] 分析以下代码的前端性能问题：
+$ARGUMENTS
+
+[输出格式]
+1. Core Web Vitals 问题列表
+2. 每个问题的优化方案（含代码 Diff）
+3. 预期收益评估
+EOF_GEMINI",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Gemini 前端性能分析"
+})
+```
 
-<TASK>
-性能优化: {{优化目标}}
-Context: {{从 ace-tool 获取的相关代码和性能指标}}
-</TASK>
+2. 使用 `TaskOutput` 监控并获取 2 个模型的分析结果。
 
-OUTPUT: Analysis report + Unified Diff Patch for optimizations.
-EOF
-```
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
 
-- **Codex** + `optimizer` 角色 → 后端性能分析
-- **Gemini** + `optimizer` 角色 → 前端性能分析
+### 🔀 阶段 3：优化整合
 
-### Phase 3: 优化整合
-1. 收集双模型分析（`TaskOutput`）
-2. **优先级排序**：按影响程度 × 实施难度 计算性价比
-3. Claude 重构优化代码
+`[模式：计划]`
 
-### Phase 4: 实施优化
-1. 按优先级实施
-2. 确保不破坏现有功能
-3. 添加必要的性能监控
+1. 收集双模型分析结果
+2. **优先级排序**：按 `影响程度 × 实施难度⁻¹` 计算性价比
+3. 请求用户确认优化方案
 
-### Phase 5: 验证
-1. 运行性能测试（如有）
-2. 对比优化前后指标
-3. 双模型审查优化效果
+### ⚡ 阶段 4：实施优化
 
-## 性能指标参考
+`[模式：执行]`
+
+用户确认后按优先级实施，确保不破坏现有功能。
+
+### ✅ 阶段 5：验证
 
-### 后端
-| 指标 | 良好 | 需优化 | 严重 |
-|------|------|--------|------|
-| API 响应 | <100ms | 100-500ms | >500ms |
-| 数据库查询 | <50ms | 50-200ms | >200ms |
+`[模式：评审]`
 
-### 前端 (Core Web Vitals)
-| 指标 | 良好 | 需改进 | 差 |
-|------|------|--------|-----|
-| LCP | <2.5s | 2.5-4s | >4s |
-| FID | <100ms | 100-300ms | >300ms |
-| CLS | <0.1 | 0.1-0.25 | >0.25 |
+运行测试验证功能，对比优化前后指标。
+
+---
+
+## 性能指标参考
+
+| 类型 | 指标 | 良好 | 需优化 |
+|------|------|------|--------|
+| 后端 | API 响应 | <100ms | >500ms |
+| 后端 | 数据库查询 | <50ms | >200ms |
+| 前端 | LCP | <2.5s | >4s |
+| 前端 | FID | <100ms | >300ms |
+| 前端 | CLS | <0.1 | >0.25 |
 
 ## 常见优化模式
-**后端**: N+1 查询→批量加载、缺少索引→复合索引、重复计算→缓存、同步阻塞→异步
-**前端**: 大 Bundle→代码分割、频繁重渲染→memo、大列表→虚拟滚动、未优化图片→WebP/懒加载
-
-## 关键原则
-1. **先测量后优化** - 没有数据不盲目优化
-2. **性价比优先** - 高影响 + 低难度优先
-3. **不破坏功能** - 优化不能引入 bug
-4. **可观测性** - 添加监控便于持续优化
+
+**后端**：N+1→批量加载、缺索引→复合索引、重复计算→缓存、同步→异步
+
+**前端**：大Bundle→代码分割、频繁重渲染→memo、大列表→虚拟滚动、未优化图片→WebP
+
+---
+
+## 关键规则
+
+1. **先测量后优化** – 没有数据不盲目优化
+2. **性价比优先** – 高影响 + 低难度优先
+3. **不破坏功能** – 优化不能引入 bug
+4. **信任规则** – 后端以 Codex 为准，前端以 Gemini 为准
+5. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
+6. **必须等待所有模型返回** – 禁止提前进入下一步