ccg-workflow 1.6.0 → 1.7.1

package/templates/commands/workflow.md

@@ -0,0 +1,244 @@
+---
+description: '多模型协作开发工作流（研究→构思→计划→执行→优化→评审），智能路由前端→Gemini、后端→Codex'
+---
+
+# Workflow - 多模型协作开发
+
+使用质量把关、MCP 服务和多模型协作执行结构化开发工作流。
+
+## 使用方法
+
+```bash
+/workflow <任务描述>
+```
+
+## 上下文
+
+- 要开发的任务：$ARGUMENTS
+- 带质量把关的结构化 6 阶段工作流
+- 多模型协作：Codex（后端）+ Gemini（前端）+ Claude（编排）
+- MCP 服务集成（ace-tool）以增强功能
+
+## 你的角色
+
+你是**编排者**，协调多模型协作系统（研究 → 构思 → 计划 → 执行 → 优化 → 评审），用中文协助用户，面向专业程序员，交互应简洁专业，避免不必要解释。
+
+**协作模型**：
+- **ace-tool MCP** – 代码检索 + Prompt 增强
+- **Codex** – 后端逻辑、算法、调试（**后端权威，可信赖**）
+- **Gemini** – 前端 UI/UX、视觉设计（**前端高手，后端意见仅供参考**）
+- **Claude (自己)** – 编排、计划、执行、交付
+
+---
+
+---
+
+## 沟通守则
+
+1. 响应以模式标签 `[模式：X]` 开始，初始为 `[模式：研究]`。
+2. 核心工作流严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转。
+3. 每个阶段完成后必须请求用户确认。
+4. 评分低于 7 分或用户未批准时强制停止。
+
+---
+
+## 执行工作流
+
+**任务描述**：$ARGUMENTS
+
+### 🔍 阶段 1：研究与分析
+
+`[模式：研究]` - 理解需求并收集上下文：
+
+1. **Prompt 增强**：调用 `mcp__ace-tool__enhance_prompt`
+2. **上下文检索**：调用 `mcp__ace-tool__search_context`
+3. **需求完整性评分**（0-10 分）：
+   - 目标明确性（0-3）、预期结果（0-3）、边界范围（0-2）、约束条件（0-2）
+   - ≥7 分：继续 | <7 分：⛔ 停止，提出补充问题
+
+### 💡 阶段 2：方案构思
+
+`[模式：构思]` - 多模型并行分析：
+
+**并行调用 Codex 和 Gemini 进行分析**：
+
+1. **Codex 分析**：`~/.claude/.ccg/prompts/codex/analyzer.md`
+2. **Gemini 分析**：`~/.claude/.ccg/prompts/gemini/analyzer.md`
+
+**执行步骤**：
+1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程：
+
+**Codex 分析进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
+ROLE_FILE: ~/.claude/.ccg/prompts/codex/analyzer.md
+<TASK>
+分析需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: 技术可行性、推荐方案、风险点
+EOF_CODEX",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 技术分析"
+})
+```
+
+**Gemini 分析进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
+ROLE_FILE: ~/.claude/.ccg/prompts/gemini/analyzer.md
+<TASK>
+分析需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: UI可行性、推荐方案、用户体验
+EOF_GEMINI",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Gemini UI 分析"
+})
+```
+
+2. 使用 `TaskOutput` 监控并获取 2 个后台进程的输出结果
+
+**⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+**注意**：Gemini 可能不会在输出中直接显示 SESSION_ID。如需复用上下文，请查看输出中的 log 文件路径，运行 `grep "SESSION_ID" <log文件>` 获取。
+
+综合两方分析，输出方案对比（至少 2 个方案），等待用户选择。
+
+### 📋 阶段 3：详细规划
+
+`[模式：计划]` - 多模型协作规划：
+
+**并行调用 Codex 和 Gemini 进行架构规划**：
+
+1. **Codex 规划**：`~/.claude/.ccg/prompts/codex/architect.md`
+2. **Gemini 规划**：`~/.claude/.ccg/prompts/gemini/architect.md`
+
+调用示例（使用 `run_in_background: true`）：
+
+**Codex 规划进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
+ROLE_FILE: ~/.claude/.ccg/prompts/codex/architect.md
+<TASK>
+规划需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: 后端架构规划
+EOF_CODEX",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 后端架构规划"
+})
+```
+
+**Gemini 规划进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
+ROLE_FILE: ~/.claude/.ccg/prompts/gemini/architect.md
+<TASK>
+规划需求: <任务描述>
+Context: <项目上下文>
+</TASK>
+OUTPUT: 前端架构规划
+EOF_GEMINI",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Gemini 前端架构规划"
+})
+```
+
+使用 `TaskOutput` 获取 2 个模型的规划结果。
+
+**⚠️ 强制规则：必须等待 Codex 和 Gemini 两个进程都返回完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+**Claude 综合规划**：
+- 采纳 Codex 的后端规划（**可信赖**）
+- 采纳 Gemini 的前端规划（**可信赖**）
+- Gemini 的后端建议**仅供参考，以 Codex 为准**
+- 请求用户批准后存入 `.claude/plan/任务名.md`
+
+### ⚡ 阶段 4：实施
+
+`[模式：执行]` - 代码开发：
+
+- 严格按批准的计划实施
+- 遵循项目现有代码规范
+- 在关键里程碑请求反馈
+
+### 🚀 阶段 5：代码优化
+
+`[模式：优化]` - 多模型并行审查：
+
+**并行调用 Codex 和 Gemini 进行代码审查**：
+
+1. **Codex 审查**：`~/.claude/.ccg/prompts/codex/reviewer.md`
+2. **Gemini 审查**：`~/.claude/.ccg/prompts/gemini/reviewer.md`
+
+调用示例（使用 `run_in_background: true`）：
+
+**Codex 审查进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
+ROLE_FILE: ~/.claude/.ccg/prompts/codex/reviewer.md
+<TASK>
+审查代码: <实施的代码变更>
+关注点: 安全性、性能、错误处理
+</TASK>
+OUTPUT: 审查意见
+EOF_CODEX",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex 代码审查"
+})
+```
+
+**Gemini 审查进程**：
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
+ROLE_FILE: ~/.claude/.ccg/prompts/gemini/reviewer.md
+<TASK>
+审查代码: <实施的代码变更>
+关注点: 可访问性、设计一致性、用户体验
+</TASK>
+OUTPUT: 审查意见
+EOF_GEMINI",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Gemini 代码审查"
+})
+```
+
+使用 `TaskOutput` 获取 2 个模型的审查结果。
+
+**⚠️ 强制规则：必须等待 Codex 和 Gemini 两个进程都返回完整结果后才能进入下一阶段，禁止跳过或提前继续！**
+
+整合审查意见，提出优化建议，用户确认后执行。
+
+### ✅ 阶段 6：质量审查
+
+`[模式：评审]` - 最终评估：
+
+- 对照计划检查完成情况
+- 运行测试验证功能
+- 报告问题与建议
+- 请求最终用户确认
+
+---
+
+## 关键规则
+
+1. 阶段顺序不可跳过（除非用户明确指令）
+2. **多模型调用必须使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
+3. **必须等待所有模型返回完整结果后才能进入下一阶段**，禁止跳过或提前继续
+4. 外部模型对文件系统**零写入权限**，所有修改由 Claude 执行
+5. 评分 <7 分或用户未批准时**强制停止**

package/templates/commands/worktree.md

@@ -1,276 +1,128 @@
 ---
-description: 管理 Git worktree，在项目平级的 ../.ccg/项目名/ 目录下创建，支持智能默认、IDE 集成和内容迁移
-allowed-tools: Read(**), Exec(git worktree add, git worktree list, git worktree remove, git worktree prune, git branch, git checkout, git rev-parse, git stash, git cp, detect-ide, open-ide, which, command, basename, dirname)
-argument-hint: <add|list|remove|prune|migrate> [path] [-b <branch>] [-o|--open] [--track] [--guess-remote] [--detach] [--checkout] [--lock] [--migrate-from <source-path>] [--migrate-stash]
-# examples:
-#   - /git-worktree add feature-ui                     # 从 main/master 创建新分支 'feature-ui'
-#   - /git-worktree add feature-ui -o                  # 创建 worktree 并直接用 IDE 打开
-#   - /git-worktree add hotfix -b fix/login -o         # 创建新分支 'fix/login'，路径为 'hotfix'
-#   - /git-worktree migrate feature-ui --from main     # 将主分支未提交内容迁移到 feature-ui
-#   - /git-worktree migrate feature-ui --stash         # 将当前 stash 迁移到 feature-ui
+description: '管理 Git Worktree：在 ../.ccg/项目名/ 目录创建，支持 IDE 集成和内容迁移'
 ---
 
-# Claude Command: Git Worktree
+# Worktree - Git Worktree 管理
 
-管理 Git worktree，支持智能默认、IDE 集成和内容迁移，使用结构化的 `../.ccg/项目名/` 路径。
+在结构化目录管理 Git worktree，支持智能默认和 IDE 集成。
 
-直接执行命令并提供简洁结果。
-
----
-
-## Usage
+## 使用方法
 
 ```bash
-# 基本操作
-/git-worktree add <path>                           # 从 main/master 创建名为 <path> 的新分支
-/git-worktree add <path> -b <branch>               # 创建指定名称的新分支
-/git-worktree add <path> -o                        # 创建并直接用 IDE 打开
-/git-worktree list                                 # 显示所有 worktree 状态
-/git-worktree remove <path>                        # 删除指定的 worktree
-/git-worktree prune                                # 清理无效 worktree 记录
-
-# 内容迁移
-/git-worktree migrate <target> --from <source>     # 迁移未提交内容
-/git-worktree migrate <target> --stash             # 迁移 stash 内容
+/worktree <add|list|remove|prune|migrate> [options]
 ```
 
-### Options
-
-| 选项               | 说明                                         |
-| ------------------ | -------------------------------------------- |
-| `add [<path>]`     | 在 `../.ccg/项目名/<path>` 添加新的 worktree |
-| `migrate <target>` | 迁移内容到指定 worktree                      |
-| `list`             | 列出所有 worktree 及其状态                   |
-| `remove <path>`    | 删除指定路径的 worktree                      |
-| `prune`            | 清理无效的 worktree 引用                     |
-| `-b <branch>`      | 创建新分支并检出到 worktree                  |
-| `-o, --open`       | 创建成功后直接用 IDE 打开（跳过询问）        |
-| `--from <source>`  | 指定迁移源路径（migrate 专用）               |
-| `--stash`          | 迁移当前 stash 内容（migrate 专用）          |
-| `--track`          | 设置新分支跟踪对应的远程分支                 |
-| `--guess-remote`   | 自动猜测远程分支进行跟踪                     |
-| `--detach`         | 创建分离 HEAD 的 worktree                    |
-| `--checkout`       | 创建后立即检出（默认行为）                   |
-| `--lock`           | 创建后锁定 worktree                          |
-
----
+## 子命令
 
-## What This Command Does
+| 命令 | 说明 |
+|------|------|
+| `add <path>` | 创建新 worktree |
+| `list` | 列出所有 worktree |
+| `remove <path>` | 删除指定 worktree |
+| `prune` | 清理无效引用 |
+| `migrate <target>` | 迁移内容到目标 worktree |
 
-1. **环境检查**
-   - 通过 `git rev-parse --is-inside-work-tree` 验证 Git 仓库
-   - 检测是否在主仓库或现有 worktree 中，进行智能路径计算
+## 选项
 
-2. **智能路径管理**
-   - 使用 worktree 检测自动从主仓库路径计算项目名
-   - 在结构化的 `../.ccg/项目名/<path>` 目录创建 worktree
-   - 正确处理主仓库和 worktree 执行上下文
+| 选项 | 说明 |
+|------|------|
+| `-b <branch>` | 创建新分支 |
+| `-o, --open` | 创建后用 IDE 打开 |
+| `--from <source>` | 迁移源路径 |
+| `--stash` | 迁移 stash 内容 |
+| `--track` | 跟踪远程分支 |
+| `--detach` | 分离 HEAD |
+| `--lock` | 锁定 worktree |
 
-```bash
-# worktree 检测的核心路径计算逻辑
-get_main_repo_path() {
-  local git_common_dir=$(git rev-parse --git-common-dir 2>/dev/null)
-  local current_toplevel=$(git rev-parse --show-toplevel 2>/dev/null)
-
-  # 检测是否在 worktree 中
-  if [[ "$git_common_dir" != "$current_toplevel/.git" ]]; then
-    # 在 worktree 中，从 git-common-dir 推导主仓库路径
-    dirname "$git_common_dir"
-  else
-    # 在主仓库中
-    echo "$current_toplevel"
-  fi
-}
-
-MAIN_REPO_PATH=$(get_main_repo_path)
-PROJECT_NAME=$(basename "$MAIN_REPO_PATH")
-WORKTREE_BASE="$MAIN_REPO_PATH/../.ccg/$PROJECT_NAME"
-
-# 始终使用绝对路径防止嵌套问题
-ABSOLUTE_WORKTREE_PATH="$WORKTREE_BASE/<path>"
-```
+---
 
-**关键修复**: 在现有 worktree 内创建新 worktree 时，始终使用绝对路径以防止出现类似 `../.ccg/project/.ccg/project/path` 的路径嵌套问题。
-
-3. **Worktree 操作**
-   - **add**: 使用智能分支/路径默认创建新 worktree
-   - **list**: 显示所有 worktree 的分支和状态
-   - **remove**: 安全删除 worktree 并清理引用
-   - **prune**: 清理孤立的 worktree 记录
-
-4. **智能默认**
-   - **分支创建**: 未指定 `-b` 时，使用路径名创建新分支
-   - **基础分支**: 新分支从 main/master 分支创建
-   - **路径解析**: 未指定路径时使用分支名作为路径
-   - **IDE 集成**: 自动检测并提示 IDE 打开
-
-5. **内容迁移**
-   - 在 worktree 之间迁移未提交改动
-   - 将 stash 内容应用到目标 worktree
-   - 安全检查防止冲突
-
-6. **安全特性**
-   - **路径冲突防护**: 创建前检查目录是否已存在
-   - **分支检出验证**: 确保分支未被其他地方使用
-   - **绝对路径强制**: 防止在 worktree 内创建嵌套的 `.ccg` 目录
-   - **删除时自动清理**: 同时清理目录和 git 引用
-   - **清晰的状态报告**: 显示 worktree 位置和分支状态
-
-7. **环境文件处理**
-   - **自动检测**: 扫描 `.gitignore` 文件中的环境变量文件模式
-   - **智能复制**: 复制 `.gitignore` 中列出的 `.env` 和 `.env.*` 文件
-   - **排除逻辑**: 跳过 `.env.example` 等模板文件
-   - **权限保护**: 保持原始文件权限和时间戳
-   - **用户反馈**: 提供已复制环境文件的清晰状态信息
+## 目录结构
 
-```bash
-# 环境文件复制实现
-copy_environment_files() {
-    local main_repo="$MAIN_REPO_PATH"
-    local target_worktree="$ABSOLUTE_WORKTREE_PATH"
-    local gitignore_file="$main_repo/.gitignore"
-    
-    # 检查 .gitignore 是否存在
-    if [[ ! -f "$gitignore_file" ]]; then
-        return 0
-    fi
-    
-    local copied_count=0
-    
-    # 检测 .env 文件
-    if [[ -f "$main_repo/.env" ]] && grep -q "^\.env$" "$gitignore_file"; then
-        cp "$main_repo/.env" "$target_worktree/.env"
-        echo "✅ 已复制 .env"
-        ((copied_count++))
-    fi
-    
-    # 检测 .env.* 模式文件（排除 .env.example）
-    for env_file in "$main_repo"/.env.*; do
-        if [[ -f "$env_file" ]] && [[ "$(basename "$env_file")" != ".env.example" ]]; then
-            local filename=$(basename "$env_file")
-            if grep -q "^\.env\.\*$" "$gitignore_file"; then
-                cp "$env_file" "$target_worktree/$filename"
-                echo "✅ 已复制 $filename"
-                ((copied_count++))
-            fi
-        fi
-    done
-    
-    if [[ $copied_count -gt 0 ]]; then
-        echo "📋 已从 .gitignore 复制 $copied_count 个环境文件"
-    fi
-}
+```
+parent-directory/
+├── your-project/           # 主项目
+│   ├── .git/
+│   └── src/
+└── .ccg/                   # worktree 管理目录
+    └── your-project/
+        ├── feature-ui/     # 功能分支
+        ├── hotfix/         # 修复分支
+        └── debug/          # 调试 worktree
 ```
 
 ---
 
-## Enhanced Features
+## 执行工作流
 
-### IDE 集成
+### Add - 创建 Worktree
 
-- **自动检测**: VS Code → Cursor → WebStorm → Sublime Text → Vim
-- **智能提示**: 创建 worktree 后询问是否在 IDE 中打开
-- **直接打开**: 使用 `-o` 标志跳过提示直接打开
-- **自定义配置**: 通过 git config 配置
+`[模式：创建]`
 
-### 内容迁移系统
-
-```bash
-# 迁移未提交改动
-/git-worktree migrate feature-ui --from main
-/git-worktree migrate hotfix --from ../other-worktree
+1. 验证 Git 仓库
+2. 计算路径：`../.ccg/项目名/<path>`
+3. 创建 worktree
+4. 自动复制环境文件（`.env` 等）
+5. 可选：用 IDE 打开
 
-# 迁移 stash 内容
-/git-worktree migrate feature-ui --stash
-```
+### Migrate - 迁移内容
 
-**迁移流程**:
+`[模式：迁移]`
 
 1. 验证源有未提交内容
-2. 确保目标 worktree 干净
+2. 确保目标干净
 3. 显示即将迁移的改动
-4. 使用 git 命令安全迁移
-5. 确认结果并建议后续步骤
+4. 安全迁移
+5. 确认结果
 
 ---
 
-## Examples
+## 示例
 
 ```bash
-# 基本用法
-/git-worktree add feature-ui                       # 从 main/master 创建新分支 'feature-ui'
-/git-worktree add feature-ui -b my-feature         # 创建新分支 'my-feature'，路径为 'feature-ui'
-/git-worktree add feature-ui -o                    # 创建并直接用 IDE 打开
+# 基本创建
+/worktree add feature-ui
+
+# 创建并用 IDE 打开
+/worktree add feature-ui -o
+
+# 创建指定分支
+/worktree add hotfix -b fix/login -o
+
+# 迁移未提交内容
+/worktree migrate feature-ui --from main
 
-# 内容迁移场景
-/git-worktree add feature-ui -b feature/new-ui     # 创建新功能 worktree
-/git-worktree migrate feature-ui --from main       # 迁移未提交改动
-/git-worktree migrate hotfix --stash               # 迁移 stash 内容
+# 迁移 stash 内容
+/worktree migrate feature-ui --stash
 
 # 管理操作
-/git-worktree list                                 # 查看所有 worktree
-/git-worktree remove feature-ui                    # 删除不需要的 worktree
-/git-worktree prune                                # 清理无效引用
+/worktree list
+/worktree remove feature-ui
+/worktree prune
 ```
 
-**示例输出**:
+## 输出示例
 
 ```
 ✅ Worktree created at ../.ccg/项目名/feature-ui
 ✅ 已复制 .env
 ✅ 已复制 .env.local
 📋 已从 .gitignore 复制 2 个环境文件
-🖥️ 是否在 IDE 中打开 ../.ccg/项目名/feature-ui？[y/n]: y
-🚀 正在用 VS Code 打开 ../.ccg/项目名/feature-ui...
-```
-
----
-
-## Directory Structure
-
-```
-parent-directory/
-├── your-project/            # 主项目
-│   ├── .git/
-│   └── src/
-└── .ccg/                    # worktree 管理
-    └── your-project/        # 项目 worktree
-        ├── feature-ui/      # 功能分支
-        ├── hotfix/          # 修复分支
-        └── debug/           # 调试 worktree
+🖥️ 是否在 IDE 中打开？[y/n]: y
+🚀 正在用 VS Code 打开...
 ```
 
 ---
 
-## Configuration
+## 智能特性
 
-### IDE 配置
+1. **智能默认** – 未指定分支时使用路径名
+2. **IDE 集成** – 自动检测 VS Code / Cursor / WebStorm
+3. **环境文件** – 自动复制 `.gitignore` 中的 `.env` 文件
+4. **路径安全** – 始终使用绝对路径防止嵌套问题
+5. **分支保护** – 验证分支未被其他地方使用
 
-- 支持 VS Code、Cursor、WebStorm、Sublime Text、Vim
-- 通过 git config 配置自定义 IDE
-- 基于优先级的自动检测选择
+## 注意事项
 
-### 自定义 IDE 设置
-
-```bash
-# 配置自定义 IDE
-git config worktree.ide.custom.sublime "subl %s"
-git config worktree.ide.preferred "sublime"
-
-# 控制自动检测
-git config worktree.ide.autodetect true  # 默认
-```
-
----
-
-## Notes
-
-- **性能**: worktree 共享 `.git` 目录，节省磁盘空间
-- **安全**: 路径冲突防护和分支检出验证
-- **迁移**: 仅限未提交改动；已提交内容需使用 `git cherry-pick`
-- **IDE 要求**: 命令行工具必须在 PATH 中
-- **跨平台**: 支持 Windows、macOS、Linux
-- **环境文件**: 自动复制 `.gitignore` 中列出的环境文件到新 worktree
-- **文件排除**: 模板文件如 `.env.example` 仅保留在主仓库中
-
----
+- Worktree 共享 `.git` 目录，节省磁盘空间
+- 迁移仅限未提交改动，已提交内容用 `git cherry-pick`
+- 支持 Windows、macOS、Linux