ccg-workflow 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,8 +2,6 @@
2
2
  description: 前端/UI/样式任务,自动路由到配置的前端模型进行原型生成和审计
3
3
  ---
4
4
 
5
- > 调用语法见 `_config.md`
6
-
7
5
  ## 用法
8
6
  `/frontend <UI_TASK_DESCRIPTION>`
9
7
 
@@ -12,6 +10,46 @@ description: 前端/UI/样式任务,自动路由到配置的前端模型进行
12
10
  - This command routes to your configured frontend models.
13
11
  - Default authority for CSS, React, Vue, and visual design.
14
12
 
13
+ ## ⭐ v1.6.0 重大升级
14
+
15
+ **从单模型调用升级为多模型并行工作流!**
16
+
17
+ ### 新增功能
18
+
19
+ ✅ **5阶段完整工作流**:
20
+ - Step 1: 上下文检索(MCP)
21
+ - Step 2: **多模型前端分析**(Gemini + Claude 并行) ← 新增
22
+ - Step 3: **多模型原型生成**(所有前端模型并行) ← 增强
23
+ - Step 4: 重构与实施(Claude 综合各模型优势)
24
+ - Step 5: **多模型审计交付**(Gemini + Claude 交叉验证) ← 新增
25
+
26
+ ✅ **交叉验证机制**:
27
+ - Gemini 提供视觉设计和 UI 创新优势
28
+ - Claude 提供更好的可访问性和代码结构
29
+ - 综合各模型优势,重构为生产级 UI 代码
30
+
31
+ ✅ **强制用户确认**:
32
+ - Step 2 分析完成后,会询问"是否继续执行此方案?(Y/N)"
33
+ - 避免盲目执行,确保用户对方案满意
34
+
35
+ ### 与 /ccg:dev 的区别
36
+
37
+ | 特性 | /ccg:frontend | /ccg:dev |
38
+ |------|--------------|----------|
39
+ | **模型范围** | 仅前端模型(Gemini + Claude)| 全部模型(前端+后端)|
40
+ | **适用场景** | 前端专项任务 | 全栈功能开发 |
41
+ | **Prompt 增强** | ❌ 不包含 | ✅ Phase 0 |
42
+ | **工作流阶段** | 5 阶段 | 6 阶段(含 Prompt 增强)|
43
+ | **推荐用户** | 前端/UI 开发者 | 全栈开发者 |
44
+
45
+ ### 使用建议
46
+
47
+ - 🎯 **纯前端任务**:使用 `/ccg:frontend`(如:组件设计、响应式布局、UI 动画)
48
+ - 🎯 **全栈功能**:使用 `/ccg:dev`(如:用户登录功能,涉及前后端)
49
+ - 🎯 **需要 Prompt 增强**:使用 `/ccg:dev`(复杂需求,需先优化需求描述)
50
+
51
+ ---
52
+
15
53
  ## 你的角色
16
54
  You are the **Frontend Orchestrator** specializing in UI/UX implementation. You coordinate:
17
55
  1. **ace-tool** – for retrieving existing frontend code and components
@@ -21,47 +59,140 @@ You are the **Frontend Orchestrator** specializing in UI/UX implementation. You
21
59
  ## 流程
22
60
 
23
61
  ### Step 1: 上下文检索
24
- 1. Call `{{MCP_SEARCH_TOOL}}` to find existing UI components, styles, and patterns:
62
+ 1. Call `mcp__ace-tool__search_context` to find existing UI components, styles, and patterns:
25
63
  - `project_root_path`: Project root directory absolute path
26
64
  - `query`: Natural language description of the UI/frontend task
27
65
  2. Identify the design system, component library, and styling conventions in use
66
+ 3. 如需求仍不清晰,提出澄清问题
67
+
68
+ ### Step 2: 多模型前端分析
69
+
70
+ **并行调用所有配置的前端模型进行分析**(使用 `run_in_background: true`):
71
+
72
+ 遍历 {{FRONTEND_MODELS}} 中的每个模型进行前端分析:
73
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/analyzer.md`
74
+ - 输出:`Structured analysis/diagnostic report`
75
+
76
+ **总共并行调用次数**: {{FRONTEND_MODELS}} 长度(例如:配置 gemini + claude = 2次)
77
+
78
+ 调用示例:
79
+ ```bash
80
+ # 遍历前端模型列表(假设配置了 gemini 和 claude)
81
+ for model in gemini claude; do
82
+ codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
83
+ ROLE_FILE: ~/.claude/.ccg/prompts/$model/analyzer.md
84
+
85
+ <TASK>
86
+ 分析前端需求: {{前端任务描述}}
87
+ Context: {{从 MCP 获取的组件和样式}}
88
+ 关注点:
89
+ - 组件设计和复用性
90
+ - UI/UX 交互流程
91
+ - 响应式布局策略
92
+ - 可访问性 (a11y) 要求
93
+ - 性能优化(懒加载、代码分割)
94
+ - 设计系统一致性
95
+ </TASK>
96
+
97
+ OUTPUT: Structured analysis/diagnostic report.
98
+ EOF
99
+ done
100
+ ```
101
+
102
+ 使用 `TaskOutput` 获取所有模型的分析结果,交叉验证后综合方案。
103
+
104
+ **强制停止**: 询问用户 **"是否继续执行此方案?(Y/N)"** 并等待确认
28
105
 
29
- ### Step 2: 调用前端模型生成原型
106
+ ### Step 3: 多模型原型生成
30
107
 
31
- 使用配置的前端主模型 ({{FRONTEND_PRIMARY}}) 生成前端原型:
108
+ **并行调用所有配置的前端模型生成原型**(使用 `run_in_background: true`):
32
109
 
110
+ 遍历 {{FRONTEND_MODELS}} 中的每个模型生成前端原型:
111
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/frontend.md`(如无 frontend 角色,使用 architect)
112
+ - 输出:`Unified Diff Patch ONLY`
113
+
114
+ **总共并行调用次数**: {{FRONTEND_MODELS}} 长度(例如:配置 gemini + claude = 2次)
115
+
116
+ 调用示例:
33
117
  ```bash
34
- codeagent-wrapper --backend {{FRONTEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
35
- ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/frontend.md
118
+ # 遍历前端模型生成原型
119
+ for model in $(echo '{{FRONTEND_MODELS}}' | jq -r '.[]'); do
120
+ codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
121
+ ROLE_FILE: ~/.claude/.ccg/prompts/$model/frontend.md
36
122
 
37
123
  <TASK>
38
- 实现 UI 功能: {{前端任务描述}}
39
- Context: {{从 MCP 获取的相关组件和样式}}
124
+ 生成前端原型: {{前端任务描述}}
125
+ Context: {{相关组件和样式}}
126
+ 实现要点:
127
+ - 遵循现有组件设计模式
128
+ - 实现响应式布局
129
+ - 确保可访问性 (ARIA 标签)
130
+ - 使用设计系统的 tokens
131
+ - 考虑性能优化
40
132
  </TASK>
41
133
 
42
134
  OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
43
135
  EOF
136
+ done
44
137
  ```
45
138
 
139
+ 使用 `TaskOutput` 收集所有模型的原型结果。
140
+
46
141
  ### Step 4: 重构与实施
47
- 1. Review model prototype(s) as "dirty prototype"
48
- 2. If multiple models, cross-validate and select best patterns
49
- 3. Refactor into clean, maintainable code
50
- 4. Ensure consistency with existing components
142
+ 1. 将所有模型的原型视为"脏原型" 仅作参考
143
+ 2. **交叉验证所有模型结果,集各家所长**:
144
+ - 分析每个模型的优势和不足
145
+ - Gemini 通常在视觉设计和 UI 创新上更强
146
+ - Claude 可能提供更好的可访问性和代码结构
147
+ - 选择最佳实现方案或综合创新点
148
+ 3. 重构为干净的生产级代码
149
+ 4. 确保与现有组件的一致性
150
+ 5. 验证响应式布局和可访问性
151
+
152
+ ### Step 5: 多模型审计交付
153
+
154
+ **并行调用所有配置的前端模型进行审计**(使用 `run_in_background: true`):
155
+
156
+ 遍历 {{FRONTEND_MODELS}} 中的每个模型进行代码审查:
157
+ - 每个模型使用对应的 `~/.claude/.ccg/prompts/<模型名>/reviewer.md`
158
+ - 输出:`Review comments only`
159
+
160
+ **总共并行调用次数**: {{FRONTEND_MODELS}} 长度(例如:配置 gemini + claude = 2次)
161
+
162
+ 调用示例:
163
+ ```bash
164
+ # 遍历前端模型列表进行审计
165
+ for model in $(echo '{{FRONTEND_MODELS}}' | jq -r '.[]'); do
166
+ codeagent-wrapper --backend $model - $PROJECT_DIR <<'EOF' &
167
+ ROLE_FILE: ~/.claude/.ccg/prompts/$model/reviewer.md
168
+
169
+ <TASK>
170
+ 审查前端代码: {{实施的代码变更}}
171
+ 关注点:
172
+ - 可访问性(WCAG 2.1 AA 标准)
173
+ - 响应式设计(移动端适配)
174
+ - 性能(首屏渲染、Lighthouse 分数)
175
+ - 设计一致性(颜色、字体、间距)
176
+ - 代码质量(组件复用、prop 类型)
177
+ - 浏览器兼容性
178
+ </TASK>
179
+
180
+ OUTPUT: Review comments only. No code modifications.
181
+ EOF
182
+ done
183
+ ```
51
184
 
52
- ### Step 5: 审计
185
+ 使用 `TaskOutput` 收集所有模型的审计结果,交叉验证后提供综合反馈。
53
186
 
54
- Call configured frontend model(s) to review the final implementation:
55
- - 使用 `reviewer` 角色
56
- - 审查内容: accessibility, responsiveness, design consistency
57
- - 输出: `Review comments only`
187
+ **最终交付**: 根据审计反馈进行必要的调整,确保 UI 达到生产级质量。
58
188
 
59
189
  ## 输出格式
60
- 1. **Configuration** – models and strategy being used
61
- 2. **Component Analysis** – existing patterns and design system
62
- 3. **Model Prototype(s)** – raw prototypes from configured models
63
- 4. **Refined Implementation** – production-ready UI code
64
- 5. **Audit Feedback** – accessibility and design review
190
+ 1. **Configuration** – 使用的模型和策略 ({{FRONTEND_MODELS}})
191
+ 2. **Component Analysis** – 现有组件模式和设计系统
192
+ 3. **Multi-Model Analysis** – 所有前端模型的分析报告(交叉验证)
193
+ 4. **Multi-Model Prototypes** – 所有前端模型的原型(交叉验证)
194
+ 5. **Refined Implementation** – 综合各模型优势的生产级 UI 代码
195
+ 6. **Multi-Model Audit** – 所有前端模型的审计反馈(交叉验证)
65
196
 
66
197
  ## 注意事项
67
198
  - Gemini context limit: < 32k tokens
@@ -2,8 +2,6 @@
2
2
  description: 多模型性能优化(Codex 后端优化 + Gemini 前端优化)
3
3
  ---
4
4
 
5
- > 调用语法见 `_config.md`
6
-
7
5
  ## 用法
8
6
  `/optimize <优化目标>`
9
7
 
@@ -15,7 +13,7 @@ description: 多模型性能优化(Codex 后端优化 + Gemini 前端优化)
15
13
  ## 流程
16
14
 
17
15
  ### Phase 1: 性能基线分析
18
- 1. 调用 `{{MCP_SEARCH_TOOL}}` 检索目标代码:
16
+ 1. 调用 `mcp__ace-tool__search_context` 检索目标代码:
19
17
  - `project_root_path`: 项目根目录绝对路径
20
18
  - `query`: 需要优化的目标代码描述
21
19
  2. 识别性能关键路径
@@ -2,8 +2,6 @@
2
2
  description: 多模型代码审查(并行执行),无参数时自动审查 git diff
3
3
  ---
4
4
 
5
- > 调用语法见 `_config.md`
6
-
7
5
  ## 用法
8
6
  `/review [CODE_OR_DESCRIPTION]`
9
7
 
@@ -35,32 +33,12 @@ git status --short
35
33
 
36
34
  **If arguments provided**, use the specified code/description.
37
35
 
38
- Then call `{{MCP_SEARCH_TOOL}}` to get related context:
36
+ Then call `mcp__ace-tool__search_context` to get related context:
39
37
  - `project_root_path`: Project root directory absolute path
40
38
  - `query`: Description of code/files to review
41
39
 
42
40
  ### Step 2: 并行审查
43
41
 
44
- **并行调用所有配置的审查模型**(使用 `run_in_background: true` 非阻塞执行):
45
-
46
- **调用方式**: 使用 `Bash` 工具调用 `codeagent-wrapper`
47
-
48
- ```bash
49
- # Codex 代码审查示例
50
- codeagent-wrapper --backend {{BACKEND_PRIMARY}} - $PROJECT_DIR <<'EOF'
51
- ROLE_FILE: ~/.claude/.ccg/prompts/{{BACKEND_PRIMARY}}/reviewer.md
52
-
53
- <TASK>
54
- 审查代码: {{待审查的代码变更}}
55
- 关注点: 安全性、性能、错误处理
56
- </TASK>
57
-
58
- OUTPUT: Review comments only. No code modifications.
59
- EOF
60
- ```
61
-
62
- ```
63
-
64
42
  **并行调用所有配置的审查模型**(使用 `run_in_background: true`):
65
43
 
66
44
  遍历 {{REVIEW_MODELS}} 中的每个模型进行代码审查:
@@ -2,8 +2,6 @@
2
2
  description: 多模型测试生成(Codex 后端测试 + Gemini 前端测试)
3
3
  ---
4
4
 
5
- > 调用语法见 `_config.md`
6
-
7
5
  ## 用法
8
6
  `/test <测试目标>`
9
7
 
@@ -14,7 +12,7 @@ description: 多模型测试生成(Codex 后端测试 + Gemini 前端测试)
14
12
  ## 流程
15
13
 
16
14
  ### Phase 1: 测试分析
17
- 1. 调用 `{{MCP_SEARCH_TOOL}}` 检索:
15
+ 1. 调用 `mcp__ace-tool__search_context` 检索:
18
16
  - `project_root_path`: 项目根目录绝对路径
19
17
  - `query`: 需要测试的代码/功能描述
20
18
  - 目标代码的完整实现
@@ -2,8 +2,6 @@
2
2
  description: UltraThink 深度分析(双模型并行分析 + 综合见解)
3
3
  ---
4
4
 
5
- > 调用语法见 `_config.md`
6
-
7
5
  ## 用法
8
6
  `/think <分析主题>`
9
7
 
@@ -15,7 +13,7 @@ description: UltraThink 深度分析(双模型并行分析 + 综合见解)
15
13
  ## 流程
16
14
 
17
15
  ### Phase 1: 上下文收集
18
- 1. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码:
16
+ 1. 调用 `mcp__ace-tool__search_context` 检索相关代码:
19
17
  - `project_root_path`: 项目根目录绝对路径
20
18
  - `query`: 需要深度分析的问题描述
21
19
  2. 识别分析范围和关键组件
@@ -1,52 +0,0 @@
1
- ---
2
- description: 使用 ace-tool MCP prompt-enhancer 优化 Prompt,展示原始与增强版本供确认
3
- ---
4
-
5
- ## Usage
6
- `/enhance <PROMPT>`
7
-
8
- ## Context
9
- - Original prompt: $ARGUMENTS
10
- - This command enhances prompts before execution using ace-tool's enhance_prompt.
11
-
12
- ## Your Role
13
- You are the **Prompt Enhancer** that optimizes user prompts for better AI task execution.
14
-
15
- ## Process
16
-
17
- ### Step 1: Enhance Prompt
18
- 1. Call `{{MCP_ENHANCE_TOOL}}` with:
19
- - `prompt`: The original user prompt ($ARGUMENTS)
20
- - `conversation_history`: Recent conversation history (5-10 turns)
21
- - `project_root_path`: Current project root directory (optional)
22
- 2. Extract the enhanced version
23
-
24
- ### Step 2: User Confirmation (寸止)
25
- **CRITICAL**: You MUST stop and show the enhanced prompt to the user.
26
-
27
- Display format:
28
- ```
29
- 📝 原始 Prompt:
30
- <original prompt>
31
-
32
- ✨ 增强后 Prompt:
33
- <enhanced prompt>
34
-
35
- ---
36
- **是否使用增强后的 prompt 继续执行?(Y/N)**
37
- ```
38
-
39
- Wait for user confirmation before proceeding.
40
-
41
- ### Step 3: Execute (Only after confirmation)
42
- If user confirms (Y):
43
- - Execute the enhanced prompt as the actual task
44
- - Follow appropriate workflow based on task type
45
-
46
- If user declines (N):
47
- - Ask user for modifications or use original prompt
48
-
49
- ## Notes
50
- - Always show both original and enhanced versions
51
- - Never auto-execute without user confirmation
52
- - The enhanced prompt provides better context for multi-model collaboration
@@ -1,87 +0,0 @@
1
- ---
2
- description: CCG 多模型协作系统 - 共享配置和调用规范
3
- ---
4
-
5
- ## 配置文件
6
- 路径: `~/.claude/.ccg/config.toml`
7
-
8
- ```toml
9
- [routing]
10
- mode = "smart" # smart | parallel | sequential
11
-
12
- [routing.frontend]
13
- models = ["gemini", "claude", "codex"] # 三模型并行
14
- primary = "gemini"
15
- strategy = "parallel"
16
-
17
- [routing.backend]
18
- models = ["codex", "claude", "gemini"] # 三模型并行
19
- primary = "codex"
20
- strategy = "parallel"
21
-
22
- [routing.review]
23
- models = ["codex", "gemini", "claude"] # 三模型交叉验证
24
- strategy = "parallel"
25
-
26
- [routing.prototype]
27
- models = ["codex", "gemini", "claude"] # 三模型原型生成
28
- strategy = "parallel"
29
- ```
30
-
31
- 默认值: frontend=`gemini`, backend=`codex`, prototype=`["codex","gemini","claude"]`
32
-
33
- ---
34
-
35
- ## 调用语法模板
36
-
37
- **⚠️ 重要**: 使用 `Bash` 工具调用 `codeagent-wrapper`,**不要**使用 `/collaborating-with-codex` 或 `/collaborating-with-gemini` 等旧的 Skill 方式!
38
-
39
- ### 基础模式
40
- ```bash
41
- codeagent-wrapper --backend <MODEL> - $PROJECT_DIR <<'EOF'
42
- ROLE_FILE: ~/.claude/.ccg/prompts/<model>/<role>.md
43
-
44
- <TASK>
45
- {{任务描述}}
46
-
47
- Context:
48
- {{相关代码}}
49
- </TASK>
50
-
51
- OUTPUT: {{输出格式}}
52
- EOF
53
- ```
54
-
55
- **说明**: 使用 `ROLE_FILE:` 指定提示词文件路径,让子进程自己读取,避免消耗主会话 token。
56
-
57
- ### 角色映射
58
- | 任务类型 | Codex 角色 | Gemini 角色 | Claude 角色 |
59
- |---------|-----------|-------------|-------------|
60
- | 架构/后端 | `codex/architect.md` | `gemini/analyzer.md` | `claude/architect.md` |
61
- | 前端/UI | `codex/architect.md` | `gemini/frontend.md` | `claude/architect.md` |
62
- | 分析 | `codex/analyzer.md` | `gemini/analyzer.md` | `claude/analyzer.md` |
63
- | 审查 | `codex/reviewer.md` | `gemini/reviewer.md` | `claude/reviewer.md` |
64
- | 调试 | `codex/debugger.md` | `gemini/debugger.md` | `claude/debugger.md` |
65
- | 测试 | `codex/tester.md` | `gemini/tester.md` | `claude/tester.md` |
66
- | 优化 | `codex/optimizer.md` | `gemini/optimizer.md` | `claude/optimizer.md` |
67
-
68
- ### 三模型差异化定位
69
- | 模型 | 专长领域 | 独特价值 |
70
- |------|---------|----------|
71
- | **Codex** | 后端逻辑、算法、调试 | 深度后端专业知识 |
72
- | **Gemini** | 前端 UI、CSS、组件设计 | 视觉设计和用户体验 |
73
- | **Claude** | 全栈整合、契约设计、跨层问题 | 桥接前后端视角 |
74
-
75
- ### 输出格式
76
- | 任务类型 | OUTPUT 值 |
77
- |---------|----------|
78
- | 原型生成 | `Unified Diff Patch ONLY. Strictly prohibit any actual modifications.` |
79
- | 代码审查 | `Review comments only. No code modifications.` |
80
- | 分析诊断 | `Structured analysis/diagnostic report.` |
81
-
82
- ### 执行策略
83
- | 策略 | 说明 |
84
- |------|------|
85
- | `parallel` | `run_in_background: true` 并行调用,`TaskOutput` 收集结果 |
86
- | `fallback` | 主模型失败则调用次模型 |
87
- | `round-robin` | 轮询调用 |