ccg-workflow 1.5.1 → 1.7.0

package/templates/commands/feat.md

@@ -1,348 +1,127 @@
 ---
-name: ccg:feat
-description: 🚀 智能功能开发 - 自动规划、设计、实施
-tools: Task, Read, Write, Bash, AskUserQuestion, Glob
+description: '智能功能开发 - 自动识别输入类型，规划/讨论/实施全流程'
 ---
 
-# CCG 智能功能开发
+# Feat - 智能功能开发
 
-智能识别用户输入类型，自动选择工作流：
-- **需求规划**：需求分析 → 任务分解 → 生成计划文档
-- **讨论迭代**：基于现有计划调整优化
-- **执行实施**：按计划调用多模型实施开发
+$ARGUMENTS
 
----
-
-## 执行流程
-
-### 步骤 1：输入类型识别
+## 核心工作流程
 
-分析用户输入，识别关键词：
+### 1. 输入类型判断
 
-#### 1.1 需求规划模式（默认）
-**关键词**：实现、开发、新增、添加、构建、需求、设计、规划
-**示例**："实现用户登录功能"、"开发商品管理模块"
-**执行**：→ 步骤 2（完整规划）
+**每次交互必须首先声明**：「我判断此次操作类型为：[具体类型]」
 
-#### 1.2 讨论迭代模式
-**关键词**：调整、修改、优化、改进、更新、重新规划、包含计划文件路径
-**示例**："调整登录功能方案"、"优化 .claude/plan/登录功能.md"
-**执行**：→ 读取现有计划 → 步骤 2.4（重新规划）
-
-#### 1.3 执行实施模式
-**关键词**：开始实施、执行计划、按照计划、根据计划
-**示例**："开始实施登录功能"、"按照 .claude/plan/登录功能.md 开发"
-**执行**：→ 步骤 3（直接实施）
+| 类型 | 关键词 | 动作 |
+|------|--------|------|
+| **需求规划** | 实现、开发、新增、添加、构建、设计 | → 步骤 2（完整规划） |
+| **讨论迭代** | 调整、修改、优化、改进、包含计划文件路径 | → 读取现有计划 → 步骤 2.3 |
+| **执行实施** | 开始实施、执行计划、按照计划、根据计划 | → 步骤 3（直接实施） |
 
 ---
 
-### 步骤 2：需求规划流程
+### 2. 需求规划流程
 
 #### 2.1 上下文检索
 
-调用 {{MCP_SEARCH_TOOL}} 检索相关代码：
-
-```
-{{MCP_SEARCH_TOOL}} {
-  "{{MCP_SEARCH_PARAM}}": "{{用户需求关键词}} + 相关代码实现、API、组件、数据模型、技术栈"
-}
-```
-
-**期望结果**：现有代码位置、可复用组件、数据模型、API 结构、技术栈
-
----
+调用 `mcp__ace-tool__search_context` 检索相关代码、组件、技术栈。
 
 #### 2.2 任务类型判断
 
-基于用户需求和检索结果：
-
 | 任务类型 | 判断依据 | 调用流程 |
 |----------|----------|----------|
 | **前端** | 页面、组件、UI、样式、布局 | ui-ux-designer → planner |
 | **后端** | API、接口、数据库、逻辑、算法 | planner |
 | **全栈** | 同时包含前后端 | ui-ux-designer → planner |
 
----
-
-#### 2.3 调用 ui-ux-designer（前端/全栈）
-
-如果是前端或全栈任务：
+#### 2.3 调用 Agents
 
-```bash
-Task(subagent_type="general-purpose", description="调用 UI/UX 设计师") {
-  prompt: "
+**前端/全栈任务**：先调用 `ui-ux-designer` agent
+```
 执行 agent: ~/.claude/agents/ccg/ui-ux-designer.md
-
-项目上下文: {{MCP 检索结果}}
-用户需求: {{原始需求}}
-技术栈: {{从检索结果提取}}
-
-输出: UI/UX 设计方案（Markdown）
-"
-}
+输入: 项目上下文 + 用户需求 + 技术栈
+输出: UI/UX 设计方案
 ```
 
----
-
-#### 2.4 调用 planner
-
-```bash
-Task(subagent_type="general-purpose", description="调用任务规划师") {
-  prompt: "
+**所有任务**：调用 `planner` agent
+```
 执行 agent: ~/.claude/agents/ccg/planner.md
-
-项目上下文: {{MCP 检索结果}}
-{{如果有 UI/UX 设计方案，附加在此}}
-用户需求: {{原始需求}}
-技术栈: {{从检索结果提取}}
-
-输出: 生成功能规划文档并保存到 .claude/plan/{{功能名}}.md
-"
-}
+输入: 项目上下文 + UI设计方案(如有) + 用户需求
+输出: 功能规划文档
 ```
 
----
-
-#### 2.5 计划版本控制
+#### 2.4 保存计划
 
-**首次规划**：
-```bash
-FEATURE_NAME="{{从需求提取的功能名}}"
-PLAN_FILE=".claude/plan/${FEATURE_NAME}.md"
+**文件命名规则**：
+- 首次规划：`.claude/plan/功能名.md`
+- 迭代版本：`.claude/plan/功能名-1.md`、`.claude/plan/功能名-2.md`...
 
-if [ -f "$PLAN_FILE" ]; then
-  PLAN_FILE=".claude/plan/${FEATURE_NAME}-1.md"
-fi
-```
+#### 2.5 交互确认
 
-**讨论迭代**：
-```bash
-EXISTING_PLAN=$(find .claude/plan -name "*{{关键词}}*.md" | head -n 1)
-
-if [ -n "$EXISTING_PLAN" ]; then
-  BASE_NAME=$(basename "$EXISTING_PLAN" .md)
-  if [[ $BASE_NAME =~ -([0-9]+)$ ]]; then
-    VERSION=$((${BASH_REMATCH[1]} + 1))
-    NEW_PLAN=".claude/plan/${BASE_NAME%-*}-${VERSION}.md"
-  else
-    NEW_PLAN=".claude/plan/${BASE_NAME}-1.md"
-  fi
-fi
-```
+规划完成后询问用户：
+- **开始实施** → 步骤 3
+- **讨论调整** → 重新执行步骤 2.3
+- **重新规划** → 删除当前计划，重新执行步骤 2
+- **仅保存计划** → 退出
 
 ---
 
-#### 2.6 交互确认
+### 3. 执行实施流程
 
-```bash
-AskUserQuestion {
-  question: "功能规划已完成，请选择下一步操作：",
-  header: "下一步",
-  options: [
-    { label: "开始实施（推荐）", description: "根据计划调用多模型开发" },
-    { label: "讨论调整", description: "修改计划中的某些部分" },
-    { label: "重新规划", description: "推翻当前方案重新开始" },
-    { label: "仅保存计划", description: "暂不实施，稍后手动执行" }
-  ]
-}
-```
-
-**处理逻辑**：
-- 开始实施 → 步骤 3
-- 讨论调整 → 重新执行步骤 2.4
-- 重新规划 → 删除当前计划，重新执行步骤 2
-- 仅保存计划 → 退出
-
----
+#### 3.1 读取计划
 
-### 步骤 3：执行实施
-
-#### 3.1 读取计划文档
-
-```bash
-if [[ "$USER_INPUT" =~ \.claude/plan/.*\.md ]]; then
-  PLAN_FILE="{{用户指定路径}}"
-else
-  PLAN_FILE=$(ls -t .claude/plan/*.md | head -n 1)
-fi
-
-PLAN_CONTENT=$(Read("$PLAN_FILE"))
-```
-
----
+优先使用用户指定路径，否则读取最新的计划文件。
 
 #### 3.2 任务类型分析
 
-从计划提取分类：
-
-```bash
-FRONTEND_TASKS=$(echo "$PLAN_CONTENT" | grep -E "模块.*：前端" || echo "")
-BACKEND_TASKS=$(echo "$PLAN_CONTENT" | grep -E "模块.*：后端" || echo "")
-
-if [ -n "$FRONTEND_TASKS" ] && [ -n "$BACKEND_TASKS" ]; then
-  TASK_TYPE="fullstack"
-elif [ -n "$FRONTEND_TASKS" ]; then
-  TASK_TYPE="frontend"
-elif [ -n "$BACKEND_TASKS" ]; then
-  TASK_TYPE="backend"
-fi
-```
-
-如无法判断，询问用户选择任务类型。
-
----
+从计划提取任务分类：前端 / 后端 / 全栈
 
 #### 3.3 多模型路由实施
 
-##### 前端任务 → {{FRONTEND_PRIMARY}}
+**参考 `multi-model-collaboration` skill 调用外部模型**
 
-```bash
-if [ "$TASK_TYPE" == "frontend" ] || [ "$TASK_TYPE" == "fullstack" ]; then
-  FRONTEND_PLAN=$(echo "$PLAN_CONTENT" | sed -n '/模块.*：前端/,/模块.*：/p')
-
-  codeagent-wrapper --backend {{FRONTEND_PRIMARY}} - "$PROJECT_DIR" <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/frontend.md
-
-<TASK>
-根据以下计划实施前端功能：
-$FRONTEND_PLAN
-
-要求：
-1. 创建/修改所有需要的组件文件
-2. 符合项目代码风格
-3. 实现响应式设计
-4. 添加 TypeScript 类型定义
-5. 处理 Loading/Success/Error 状态
-6. 遵循无障碍访问最佳实践
-</TASK>
-EOF
-
-  GEMINI_SESSION=$(echo "$OUTPUT" | grep "SESSION_ID:" | awk '{print $2}')
-fi
-```
-
-##### 后端任务 → {{BACKEND_PRIMARY}}
+**前端任务 → Gemini**：
+- 使用 `codeagent-wrapper --backend gemini`
+- 角色提示词：`~/.claude/.ccg/prompts/gemini/frontend.md`
+- 输出：前端组件代码
 
-```bash
-if [ "$TASK_TYPE" == "backend" ] || [ "$TASK_TYPE" == "fullstack" ]; then
-  BACKEND_PLAN=$(echo "$PLAN_CONTENT" | sed -n '/模块.*：后端/,/模块.*：/p')
-
-  codeagent-wrapper --backend {{BACKEND_PRIMARY}} - "$PROJECT_DIR" <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/architect.md
-
-<TASK>
-根据以下计划实施后端功能：
-$BACKEND_PLAN
-
-要求：
-1. 创建/修改所有 API 端点
-2. 实现数据验证（Zod/Joi）
-3. 统一错误处理
-4. 添加中间件（认证、日志、CORS）
-5. 编写数据库查询
-6. 确保代码可测试性
-</TASK>
-EOF
-
-  CODEX_SESSION=$(echo "$OUTPUT" | grep "SESSION_ID:" | awk '{print $2}')
-fi
-```
+**后端任务 → Codex**：
+- 使用 `codeagent-wrapper --backend codex`
+- 角色提示词：`~/.claude/.ccg/prompts/codex/architect.md`
+- 输出：后端 API 代码
 
-##### 全栈任务 → 并行调用
-
-```bash
-if [ "$TASK_TYPE" == "fullstack" ]; then
-  { 前端任务 } &
-  { 后端任务 } &
-  wait
-fi
-```
-
----
+**全栈任务 → 并行调用**：
+**执行步骤**：
+1. 在**同一个 Bash 调用**中启动两个后台进程（不加 wait，立即返回）：
+   - Codex 后端 + Gemini 前端同时运行
+2. 使用 `TaskOutput` 监控并获取结果
+3. **⚠️ 强制规则：必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段，禁止跳过或提前继续！**
 
 #### 3.4 实施后验证
 
 ```bash
 git status --short
 git diff --name-status
-
-AskUserQuestion {
-  question: "是否运行代码审查？",
-  options: [
-    { label: "是，运行 /ccg:review", description: "双模型代码审查" },
-    { label: "跳过，手动检查", description: "稍后自行审查代码" }
-  ]
-}
 ```
 
-如果用户选择审查，调用 `/ccg:review`。
+询问用户是否运行代码审查（`/ccg:review`）。
 
 ---
 
-### 步骤 4：后续建议
+### 4. 关键执行原则
 
-```bash
-echo "✅ 功能开发完成！"
-echo ""
-echo "📋 后续步骤："
-echo "  1. 运行测试：npm run test"
-echo "  2. 启动开发服务器：npm run dev"
-echo "  3. 验证功能是否正常"
-echo "  4. 运行 /ccg:commit 提交代码"
-echo ""
-echo "📂 计划文档：$PLAN_FILE"
-```
+1. **强制响应要求**：每次交互必须首先说明判断的操作类型
+2. **文档一致性**：规划文档与实际执行保持同步
+3. **依赖关系管理**：前端任务必须确保 UI 设计完整性
+4. **多模型信任规则**：
+   - 前端以 Gemini 为准
+   - 后端以 Codex 为准
+5. **用户沟通透明**：所有判断和动作都要明确告知用户
 
 ---
 
-## 命令参数
+## 使用方法
 
 ```bash
-/ccg:feat --mode=plan "实现用户登录"        # 显式指定规划模式
-/ccg:feat --mode=implement "path/to/plan"   # 显式指定实施模式
-/ccg:feat --mode=iterate "path" "调整需求"  # 显式指定迭代模式
-/ccg:feat --type=frontend "实现登录页面"    # 指定任务类型
-/ccg:feat --type=backend "实现登录 API"
-/ccg:feat --type=fullstack "实现完整登录"
+/feat <功能描述>
 ```
-
----
-
-## 使用示例
-
-```bash
-# 示例 1：完整流程
-/ccg:feat 实现用户登录功能
-
-→ 系统识别：需求规划模式
-→ 检索上下文（MCP）
-→ 判断任务类型：全栈
-→ 调用 ui-ux-designer
-→ 调用 planner
-→ 生成计划：.claude/plan/用户登录功能.md
-→ 用户确认：开始实施
-→ 并行调用 Gemini（前端）+ Codex（后端）
-→ 实施完成
-→ 可选：运行代码审查
-
-# 示例 2：讨论迭代
-/ccg:feat 调整登录功能，增加"记住我"选项
-
-→ 系统识别：讨论迭代模式
-→ 读取现有计划：.claude/plan/用户登录功能.md
-→ 调用 planner 重新规划
-→ 生成新版本：.claude/plan/用户登录功能-1.md
-
-# 示例 3：直接实施
-/ccg:feat 按照 .claude/plan/用户登录功能.md 开始实施
-
-→ 系统识别：执行实施模式
-→ 读取计划文档
-→ 分析任务类型：全栈
-→ 并行调用 Gemini + Codex
-→ 实施完成
-```
-
----
-
-现在开始智能功能开发！

package/templates/commands/frontend.md

@@ -1,69 +1,129 @@
 ---
-description: 前端/UI/样式任务，自动路由到配置的前端模型进行原型生成和审计
+description: '前端专项工作流（研究→构思→计划→执行→优化→评审），Gemini主导'
 ---
 
-> 调用语法见 `_config.md`
+# Frontend - 前端专项开发
 
-## 用法
-`/frontend <UI_TASK_DESCRIPTION>`
+## 使用方法
+
+```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.
+
+- 前端任务：$ARGUMENTS
+- Gemini 主导，Codex 辅助参考
+- 适用：组件设计、响应式布局、UI动画、样式优化
 
 ## 你的角色
-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
 
-## 流程
+你是**前端编排者**，协调多模型完成 UI/UX 任务（研究 → 构思 → 计划 → 执行 → 优化 → 评审），用中文协助用户。
+
+**协作模型**：
+- **Gemini** – 前端 UI/UX（**前端权威，可信赖**）
+- **Codex** – 后端视角（**前端意见仅供参考**）
+- **Claude (自己)** – 编排、计划、执行、交付
+
+[沟通守则]
+
+1. 响应以模式标签 `[模式：X]` 开始，初始为 `[模式：研究]`
+2. 严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转
+
+---
+
+## 多模型调用语法
+
+```bash
+# Gemini 调用（前端主力）
+~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF'
+[角色提示词内容]
+
+[任务内容]
+EOF
+
+# Codex 调用（后端参考）
+~/.claude/bin/codeagent-wrapper --backend codex - "$PWD" <<'EOF'
+[任务内容]
+EOF
+```
+
+---
+
+## 核心工作流
+
+### 🔍 阶段 1：研究
+
+`[模式：研究]` - 理解需求并收集上下文
 
-### Step 1: 上下文检索
-1. Call `{{MCP_SEARCH_TOOL}}` 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
+1. 检索现有组件、样式、设计系统
+2. 需求完整性评分（0-10 分）：≥7 继续，<7 停止补充
 
-### Step 2: 调用前端模型生成原型
+### 💡 阶段 2：构思
 
-使用配置的前端主模型 ({{FRONTEND_PRIMARY}}) 生成前端原型：
+`[模式：构思]` - Gemini 主导分析
+
+**调用示例**：
 
 ```bash
-codeagent-wrapper --backend {{FRONTEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/frontend.md
+~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF'
+你是前端分析专家，擅长 UI/UX、组件设计、响应式布局。
 
-<TASK>
-实现 UI 功能: {{前端任务描述}}
-Context: {{从 MCP 获取的相关组件和样式}}
-</TASK>
+任务：分析以下前端需求，提供设计方案
+- 组件结构与状态管理
+- 响应式策略
+- 可访问性考虑
+- 性能优化建议
 
-OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
+需求：[具体任务描述]
 EOF
 ```
 
-### Step 4: 重构与实施
-1. Review model prototype(s) as "dirty prototype"
-2. If multiple models, cross-validate and select best patterns
-3. Refactor into clean, maintainable code
-4. Ensure consistency with existing components
-
-### Step 5: 审计
-
-Call configured frontend model(s) to review the final implementation:
-- 使用 `reviewer` 角色
-- 审查内容: accessibility, responsiveness, design consistency
-- 输出: `Review comments only`
-
-## 输出格式
-1. **Configuration** – models and strategy being used
-2. **Component Analysis** – existing patterns and design system
-3. **Model Prototype(s)** – raw prototypes from configured models
-4. **Refined Implementation** – production-ready UI code
-5. **Audit Feedback** – accessibility and design review
-
-## 注意事项
-- Gemini context limit: < 32k tokens
-- Always request Unified Diff Patch format
-- Use HEREDOC syntax (`<<'EOF'`) to avoid shell escaping issues
+**⚠️ 等待 Gemini 返回后继续**
+
+输出方案（至少 2 个），等待用户选择。
+
+### 📋 阶段 3：计划
+
+`[模式：计划]` - Gemini 主导规划
+
+调用 Gemini（`architect.md`）→ 组件结构、UI流程、样式方案
+
+**⚠️ 等待 Gemini 返回后继续**
+
+Claude 综合规划，请求用户批准后存入 `.claude/plan/任务名.md`
+
+### ⚡ 阶段 4：执行
+
+`[模式：执行]` - 代码开发
+
+- 严格按批准的计划实施
+- 遵循项目现有设计系统和代码规范
+- 确保响应式、可访问性
+
+### 🚀 阶段 5：优化
+
+`[模式：优化]` - Gemini 主导审查
+
+调用 Gemini（`reviewer.md`）→ 可访问性、响应式、性能、设计一致性
+
+**⚠️ 等待 Gemini 返回后继续**
+
+整合审查意见，用户确认后执行优化。
+
+### ✅ 阶段 6：评审
+
+`[模式：评审]` - 最终评估
+
+- 对照计划检查完成情况
+- 验证响应式和可访问性
+- 报告问题与建议
+
+---
+
+## 关键规则
+
+1. **Gemini 前端意见可信赖**
+2. **Codex 前端意见仅供参考**
+3. 外部模型对文件系统**零写入权限**
+4. Claude 负责所有代码写入和文件操作