ccg-workflow 1.5.1 → 1.7.0

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,100 +1,141 @@
 ---
-description: 多模型性能优化（Codex 后端优化 + Gemini 前端优化）
+description: '多模型性能优化：Codex 后端优化 + Gemini 前端优化'
 ---
 
-> 调用语法见 `_config.md`
+# 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
+
+### 🔍 阶段 1：性能基线
 
-### Phase 1: 性能基线分析
-1. 调用 `{{MCP_SEARCH_TOOL}}` 检索目标代码:
-   - `project_root_path`: 项目根目录绝对路径
-   - `query`: 需要优化的目标代码描述
+`[模式：研究]`
+
+1. 调用 `mcp__ace-tool__search_context` 检索目标代码（如可用）
 2. 识别性能关键路径
-3. 收集现有指标（如有）：
-   - 后端: 响应时间、查询耗时、内存占用
-   - 前端: LCP、FID、CLS、Bundle Size
+3. 收集现有指标（如有）
+
+### 🔬 阶段 2：并行性能分析
 
-### Phase 2: 并行性能分析
-**同时调用**（`run_in_background: true`）:
+`[模式：分析]`
 
-**调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
+**并行调用两个模型**：
 
+**执行步骤**：
+1. 在**同一个 Bash 调用**中启动两个后台进程（不加 wait，立即返回）：
 ```bash
-# Codex 后端性能分析
-codeagent-wrapper --backend {{BACKEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/optimizer.md
+# Codex：后端性能分析
+~/.claude/bin/codeagent-wrapper --backend codex - $PWD <<'EOF' &
+[角色] 你是后端性能优化专家
 
-<TASK>
-性能优化: {{优化目标}}
-Context: {{从 ace-tool 获取的相关代码和性能指标}}
-</TASK>
+[任务] 分析以下代码的后端性能问题：
+$ARGUMENTS
 
-OUTPUT: Analysis report + Unified Diff Patch for optimizations.
+[输出格式]
+1. 性能瓶颈列表（按严重程度排序）
+2. 每个问题的优化方案（含代码 Diff）
+3. 预期收益评估
 EOF
-```
 
-```bash
-# Gemini 前端性能分析
-codeagent-wrapper --backend {{FRONTEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/optimizer.md
+# Gemini：前端性能分析
+~/.claude/bin/codeagent-wrapper --backend gemini - $PWD <<'EOF' &
+[角色] 你是前端性能优化专家
 
-<TASK>
-性能优化: {{优化目标}}
-Context: {{从 ace-tool 获取的相关代码和性能指标}}
-</TASK>
+[任务] 分析以下代码的前端性能问题：
+$ARGUMENTS
 
-OUTPUT: Analysis report + Unified Diff Patch for optimizations.
+[输出格式]
+1. Core Web Vitals 问题列表
+2. 每个问题的优化方案（含代码 Diff）
+3. 预期收益评估
 EOF
 ```
+2. 使用 `TaskOutput` 监控并获取 2 个模型的分析结果。
 
-- **Codex** + `optimizer` 角色 → 后端性能分析
-- **Gemini** + `optimizer` 角色 → 前端性能分析
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
 
-### Phase 3: 优化整合
-1. 收集双模型分析（`TaskOutput`）
-2. **优先级排序**：按影响程度 × 实施难度 计算性价比
-3. Claude 重构优化代码
+### 🔀 阶段 3：优化整合
 
-### Phase 4: 实施优化
-1. 按优先级实施
-2. 确保不破坏现有功能
-3. 添加必要的性能监控
+`[模式：计划]`
 
-### Phase 5: 验证
-1. 运行性能测试（如有）
-2. 对比优化前后指标
-3. 双模型审查优化效果
+1. 收集双模型分析结果
+2. **优先级排序**：按 `影响程度 × 实施难度⁻¹` 计算性价比
+3. 请求用户确认优化方案
 
-## 性能指标参考
+### ⚡ 阶段 4：实施优化
 
-### 后端
-| 指标 | 良好 | 需优化 | 严重 |
-|------|------|--------|------|
-| 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 |
+用户确认后按优先级实施，确保不破坏现有功能。
+
+### ✅ 阶段 5：验证
+
+`[模式：评审]`
+
+运行测试验证功能，对比优化前后指标。
+
+---
+
+## 性能指标参考
+
+| 类型 | 指标 | 良好 | 需优化 |
+|------|------|------|--------|
+| 后端 | 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. **必须等待所有模型返回** – 禁止提前进入下一步

package/templates/commands/review.md

@@ -1,91 +1,134 @@
 ---
-description: 多模型代码审查（并行执行），无参数时自动审查 git diff
+description: '多模型代码审查：无参数时自动审查 git diff，双模型交叉验证'
 ---
 
-> 调用语法见 `_config.md`
+# Review - 多模型代码审查
 
-## 用法
-`/review [CODE_OR_DESCRIPTION]`
+双模型并行审查，交叉验证综合反馈。无参数时自动审查当前 git 变更。
 
-## 上下文
-- Arguments: $ARGUMENTS
-- This command triggers multi-model code review based on your configuration.
-- Configured models review simultaneously for comprehensive feedback.
+## 多模型调用语法
 
-## 行为
-- **No arguments**: Automatically review current git changes (staged + unstaged)
-- **With arguments**: Review specified code or description
+**⚠️ 必须使用 heredoc 语法调用外部模型**：
 
-## 你的角色
-You are the **Code Review Coordinator** orchestrating multi-model review. You direct:
-1. **ace-tool** – for retrieving code context
-2. **Configured Review Models** – for comprehensive code review
-3. **Claude (Self)** – for synthesizing feedback and recommendations
+```bash
+~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - "$PWD" <<'EOF'
+<任务内容>
+EOF
+```
+
+---
+
+## 使用方法
+
+```bash
+/review [代码或描述]
+```
 
-## 流程
+- **无参数**：自动审查 `git diff HEAD`
+- **有参数**：审查指定代码或描述
 
-### Step 1: 获取待审查代码
+---
+
+## 执行工作流
+
+### 🔍 阶段 1：获取待审查代码
 
-**If no arguments provided**, run git commands to get current changes:
+`[模式：研究]`
+
+**无参数时**：
 ```bash
-# Get staged and unstaged changes
 git diff HEAD
 git status --short
 ```
 
-**If arguments provided**, use the specified code/description.
+**有参数时**：使用指定的代码/描述
 
-Then call `{{MCP_SEARCH_TOOL}}` to get related context:
-   - `project_root_path`: Project root directory absolute path
-   - `query`: Description of code/files to review
+调用 `mcp__ace-tool__search_context` 获取相关上下文。
 
-### Step 2: 并行审查
+### 🔬 阶段 2：并行审查
 
-**并行调用所有配置的审查模型**（使用 `run_in_background: true`）：
+`[模式：审查]`
 
-遍历 {{REVIEW_MODELS}} 中的每个模型进行代码审查：
+**并行调用两个模型**：
 
+**执行步骤**：
+1. 在**同一个 Bash 调用**中启动两个后台进程（不加 wait，立即返回）：
 ```bash
-# 遍历审查模型列表（默认: codex, gemini）
-for model in $(echo '{{REVIEW_MODELS}}' | jq -r '.[]'); do
-  codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
-ROLE_FILE: ~/.claude/.ccg/prompts/$model/reviewer.md
+# Codex 后端审查
+~/.claude/bin/codeagent-wrapper --backend codex - "$PWD" <<'EOF' &
+[角色] 后端代码审查专家
+[任务] 审查以下代码变更
+
+## 审查重点
+- 安全性：注入、认证、授权
+- 性能：N+1 查询、缓存、复杂度
+- 错误处理：异常捕获、边界条件
+- 可维护性：命名、结构、文档
 
-<TASK>
-审查代码: {{待审查的代码变更}}
-关注点: 安全性、性能、错误处理、可访问性、响应式设计、设计一致性
-</TASK>
+## 待审查代码
+<粘贴 git diff 内容>
 
-OUTPUT: Review comments only. No code modifications.
+## 输出格式
+按 Critical/Major/Minor/Suggestion 分类列出问题
 EOF
-done
-wait  # 等待所有后台任务完成
-```
 
-### Step 3: 综合反馈
-使用 `TaskOutput` 获取所有任务的结果，然后：
-1. Collect feedback from all configured models
-2. Categorize by severity (Critical, Major, Minor, Suggestion)
-3. Remove duplicate concerns
-4. Cross-validate findings across models
-5. Prioritize actionable items
+# Gemini 前端审查
+~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF' &
+[角色] 前端代码审查专家
+[任务] 审查以下代码变更
 
-### Step 4: 呈现审查结果
-Provide unified review report to user with recommendations.
+## 审查重点
+- 可访问性：ARIA、键盘导航、色彩对比
+- 响应式：移动端适配、断点
+- 设计一致性：组件复用、样式规范
+- 用户体验：加载状态、错误提示
+
+## 待审查代码
+<粘贴 git diff 内容>
 
 ## 输出格式
-1. **Configuration** – models used for review
-2. **Review Summary** – overall assessment
-3. **Critical Issues** – must fix before merge
-4. **Major Issues** – should fix
-5. **Minor Issues** – nice to fix
-6. **Suggestions** – optional improvements
-7. **Recommended Actions** – prioritized fix list
-
-## 注意事项
-- **审查模型已在安装时注入**: {{REVIEW_MODELS}}
-- **No arguments** = auto-review git changes (`git diff HEAD`)
-- **With arguments** = review specified content
-- **Use `run_in_background: true` for parallel execution** to avoid blocking
-- 多模型结果交叉验证，综合反馈
-- Use HEREDOC syntax (`<<'EOF'`) to avoid shell escaping issues
+按 Critical/Major/Minor/Suggestion 分类列出问题
+EOF
+```
+2. 使用 `TaskOutput` 监控并获取 2 个模型的审查结果。
+
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+### 🔀 阶段 3：综合反馈
+
+`[模式：综合]`
+
+1. 收集双方审查结果
+2. 按严重程度分类：Critical / Major / Minor / Suggestion
+3. 去重合并 + 交叉验证
+
+### 📊 阶段 4：呈现审查结果
+
+`[模式：总结]`
+
+```markdown
+## 📋 代码审查报告
+
+### 审查范围
+- 变更文件：<数量> | 代码行数：+X / -Y
+
+### 关键问题 (Critical)
+> 必须修复才能合并
+1. <问题描述> - [Codex/Gemini]
+
+### 主要问题 (Major) / 次要问题 (Minor) / 建议 (Suggestions)
+...
+
+### 总体评价
+- 代码质量：[优秀/良好/需改进]
+- 是否可合并：[是/否/需修复后]
+```
+
+---
+
+## 关键规则
+
+1. **无参数 = 审查 git diff** – 自动获取当前变更
+2. **heredoc 语法** – 必须使用 `<<'EOF'` 传递多行任务
+3. **双模型交叉验证** – 后端问题以 Codex 为准，前端问题以 Gemini 为准
+4. **必须等待所有模型返回** – 禁止提前进入下一步