ccg-workflow 1.7.2 → 1.7.4
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.
- package/README.md +9 -7
- package/bin/codeagent-wrapper-darwin-amd64 +0 -0
- package/bin/codeagent-wrapper-darwin-arm64 +0 -0
- package/bin/codeagent-wrapper-linux-amd64 +0 -0
- package/bin/codeagent-wrapper-linux-arm64 +0 -0
- package/bin/codeagent-wrapper-windows-amd64.exe +0 -0
- package/bin/codeagent-wrapper-windows-arm64.exe +0 -0
- package/dist/cli.mjs +1 -1
- package/dist/index.mjs +1 -1
- package/dist/shared/{ccg-workflow.BO24M85O.mjs → ccg-workflow.B1tr28ka.mjs} +32 -31
- package/package.json +1 -1
- package/templates/commands/analyze.md +40 -57
- package/templates/commands/backend.md +37 -89
- package/templates/commands/debug.md +31 -73
- package/templates/commands/enhance.md +36 -0
- package/templates/commands/feat.md +43 -20
- package/templates/commands/frontend.md +37 -89
- package/templates/commands/optimize.md +28 -69
- package/templates/commands/review.md +29 -77
- package/templates/commands/test.md +42 -71
- package/templates/commands/workflow.md +48 -144
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 使用 ace-tool enhance_prompt 优化 Prompt,展示原始与增强版本供确认
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
## Usage
|
|
6
|
+
`/ccg:enhance <PROMPT>`
|
|
7
|
+
|
|
8
|
+
## Context
|
|
9
|
+
- Original prompt: $ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Your Role
|
|
12
|
+
You are the **Prompt Enhancer** that optimizes user prompts for better AI task execution.
|
|
13
|
+
|
|
14
|
+
## Process
|
|
15
|
+
|
|
16
|
+
### Step 1: 调用 Prompt 增强工具
|
|
17
|
+
|
|
18
|
+
调用 `mcp__ace-tool__enhance_prompt` 工具:
|
|
19
|
+
- `prompt`: 用户原始输入
|
|
20
|
+
- `conversation_history`: 最近 5-10 轮对话历史
|
|
21
|
+
- `project_root_path`: 当前项目根目录(可选)
|
|
22
|
+
|
|
23
|
+
### Step 2: 处理响应
|
|
24
|
+
|
|
25
|
+
根据工具返回的结果:
|
|
26
|
+
- **增强后的 prompt**: 展示增强版本,询问用户是否使用
|
|
27
|
+
- **`__END_CONVERSATION__`**: 停止对话,不执行任何任务
|
|
28
|
+
- **工具调用失败**: 直接使用原始 prompt
|
|
29
|
+
|
|
30
|
+
### Step 3: 执行任务
|
|
31
|
+
|
|
32
|
+
根据用户选择执行相应操作。
|
|
33
|
+
|
|
34
|
+
## Notes
|
|
35
|
+
- 支持自动语言检测(中文输入 → 中文输出)
|
|
36
|
+
- 也可通过在消息末尾添加 `-enhance` 或 `-Enhancer` 触发
|
|
@@ -6,6 +6,43 @@ description: '智能功能开发 - 自动识别输入类型,规划/讨论/实
|
|
|
6
6
|
|
|
7
7
|
$ARGUMENTS
|
|
8
8
|
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## 多模型调用规范
|
|
12
|
+
|
|
13
|
+
**调用语法**(并行用 `run_in_background: true`,串行用 `false`):
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
Bash({
|
|
17
|
+
command: "~/.claude/bin/codeagent-wrapper --backend <codex|gemini> [--resume <SESSION_ID>] - \"$PWD\" <<'EOF'
|
|
18
|
+
ROLE_FILE: <角色提示词路径>
|
|
19
|
+
<TASK>
|
|
20
|
+
需求:<增强后的需求(如未增强则用 $ARGUMENTS)>
|
|
21
|
+
上下文:<前序阶段收集的项目上下文、计划文件内容等>
|
|
22
|
+
</TASK>
|
|
23
|
+
OUTPUT: 期望输出格式
|
|
24
|
+
EOF",
|
|
25
|
+
run_in_background: true,
|
|
26
|
+
timeout: 3600000,
|
|
27
|
+
description: "简短描述"
|
|
28
|
+
})
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
**角色提示词**:
|
|
32
|
+
|
|
33
|
+
| 阶段 | Codex | Gemini |
|
|
34
|
+
|------|-------|--------|
|
|
35
|
+
| 分析 | `~/.claude/.ccg/prompts/codex/analyzer.md` | `~/.claude/.ccg/prompts/gemini/analyzer.md` |
|
|
36
|
+
| 规划 | `~/.claude/.ccg/prompts/codex/architect.md` | `~/.claude/.ccg/prompts/gemini/architect.md` |
|
|
37
|
+
| 实施 | `~/.claude/.ccg/prompts/codex/architect.md` | `~/.claude/.ccg/prompts/gemini/frontend.md` |
|
|
38
|
+
| 审查 | `~/.claude/.ccg/prompts/codex/reviewer.md` | `~/.claude/.ccg/prompts/gemini/reviewer.md` |
|
|
39
|
+
|
|
40
|
+
**会话复用**:每次调用返回 `SESSION_ID: xxx`,后续阶段用 `--resume xxx` 复用上下文。
|
|
41
|
+
|
|
42
|
+
**并行调用**:使用 `run_in_background: true` 启动,用 `TaskOutput` 等待结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
9
46
|
## 核心工作流程
|
|
10
47
|
|
|
11
48
|
### 1. 输入类型判断
|
|
@@ -24,10 +61,7 @@ $ARGUMENTS
|
|
|
24
61
|
|
|
25
62
|
#### 2.0 Prompt 增强
|
|
26
63
|
|
|
27
|
-
**如果 ace-tool MCP 可用**,调用 `mcp__ace-tool__enhance_prompt
|
|
28
|
-
- 输入原始任务描述
|
|
29
|
-
- 获取增强后的详细需求
|
|
30
|
-
- 用增强后的需求进行后续规划
|
|
64
|
+
**如果 ace-tool MCP 可用**,调用 `mcp__ace-tool__enhance_prompt`,**用增强结果替代原始 $ARGUMENTS,后续调用 Codex/Gemini 时传入增强后的需求**
|
|
31
65
|
|
|
32
66
|
#### 2.1 上下文检索
|
|
33
67
|
|
|
@@ -85,24 +119,13 @@ $ARGUMENTS
|
|
|
85
119
|
|
|
86
120
|
#### 3.3 多模型路由实施
|
|
87
121
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
**前端任务 → Gemini**:
|
|
91
|
-
- 使用 `codeagent-wrapper --backend gemini`
|
|
92
|
-
- 角色提示词:`~/.claude/.ccg/prompts/gemini/frontend.md`
|
|
93
|
-
- 输出:前端组件代码
|
|
122
|
+
按上方调用规范调用外部模型:
|
|
94
123
|
|
|
95
|
-
|
|
96
|
-
-
|
|
97
|
-
-
|
|
98
|
-
- 输出:后端 API 代码
|
|
124
|
+
- **前端任务**:调用 Gemini,使用实施提示词
|
|
125
|
+
- **后端任务**:调用 Codex,使用实施提示词
|
|
126
|
+
- **全栈任务**:并行调用 Codex + Gemini(`run_in_background: true`),用 `TaskOutput` 等待结果
|
|
99
127
|
|
|
100
|
-
|
|
101
|
-
**执行步骤**:
|
|
102
|
-
1. 在**同一个 Bash 调用**中启动两个后台进程(不加 wait,立即返回):
|
|
103
|
-
- Codex 后端 + Gemini 前端同时运行
|
|
104
|
-
2. 使用 `TaskOutput` 监控并获取结果
|
|
105
|
-
3. **⚠️ 强制规则:必须等待 TaskOutput 返回两个模型的完整结果后才能进入下一阶段,禁止跳过或提前继续!**
|
|
128
|
+
**⚠️ 强制规则:必须等待 TaskOutput 返回所有模型的完整结果后才能进入下一阶段**
|
|
106
129
|
|
|
107
130
|
#### 3.4 实施后验证
|
|
108
131
|
|
|
@@ -25,28 +25,44 @@ description: '前端专项工作流(研究→构思→计划→执行→优化
|
|
|
25
25
|
- **Codex** – 后端视角(**前端意见仅供参考**)
|
|
26
26
|
- **Claude (自己)** – 编排、计划、执行、交付
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
---
|
|
29
29
|
|
|
30
|
-
|
|
31
|
-
2. 严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转
|
|
30
|
+
## 多模型调用规范
|
|
32
31
|
|
|
33
|
-
|
|
32
|
+
**调用语法**:
|
|
34
33
|
|
|
35
|
-
|
|
34
|
+
```
|
|
35
|
+
Bash({
|
|
36
|
+
command: "~/.claude/bin/codeagent-wrapper --backend gemini [--resume <SESSION_ID>] - \"$PWD\" <<'EOF'
|
|
37
|
+
ROLE_FILE: <角色提示词路径>
|
|
38
|
+
<TASK>
|
|
39
|
+
需求:<增强后的需求(如未增强则用 $ARGUMENTS)>
|
|
40
|
+
上下文:<前序阶段收集的项目上下文、分析结果等>
|
|
41
|
+
</TASK>
|
|
42
|
+
OUTPUT: 期望输出格式
|
|
43
|
+
EOF",
|
|
44
|
+
run_in_background: false,
|
|
45
|
+
timeout: 3600000,
|
|
46
|
+
description: "简短描述"
|
|
47
|
+
})
|
|
48
|
+
```
|
|
36
49
|
|
|
37
|
-
|
|
38
|
-
# Gemini 调用(前端主力)
|
|
39
|
-
~/.claude/bin/codeagent-wrapper --backend gemini - "$PWD" <<'EOF'
|
|
40
|
-
[角色提示词内容]
|
|
50
|
+
**角色提示词**:
|
|
41
51
|
|
|
42
|
-
|
|
43
|
-
|
|
52
|
+
| 阶段 | Gemini |
|
|
53
|
+
|------|--------|
|
|
54
|
+
| 分析 | `~/.claude/.ccg/prompts/gemini/analyzer.md` |
|
|
55
|
+
| 规划 | `~/.claude/.ccg/prompts/gemini/architect.md` |
|
|
56
|
+
| 审查 | `~/.claude/.ccg/prompts/gemini/reviewer.md` |
|
|
44
57
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
58
|
+
**会话复用**:每次调用返回 `SESSION_ID: xxx`,后续阶段用 `--resume xxx` 复用上下文。阶段 2 保存 `GEMINI_SESSION`,阶段 3 和 5 使用 `--resume` 复用。
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 沟通守则
|
|
63
|
+
|
|
64
|
+
1. 响应以模式标签 `[模式:X]` 开始,初始为 `[模式:研究]`
|
|
65
|
+
2. 严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转
|
|
50
66
|
|
|
51
67
|
---
|
|
52
68
|
|
|
@@ -54,12 +70,7 @@ EOF
|
|
|
54
70
|
|
|
55
71
|
### 🔍 阶段 0:Prompt 增强(可选)
|
|
56
72
|
|
|
57
|
-
`[模式:准备]` -
|
|
58
|
-
|
|
59
|
-
**如果 ace-tool MCP 可用**,调用 `mcp__ace-tool__enhance_prompt`:
|
|
60
|
-
- 输入原始任务描述
|
|
61
|
-
- 获取增强后的详细需求
|
|
62
|
-
- 用增强后的需求替代原始 $ARGUMENTS
|
|
73
|
+
`[模式:准备]` - 如 ace-tool MCP 可用,调用 `mcp__ace-tool__enhance_prompt`,**用增强结果替代原始 $ARGUMENTS,后续调用 Gemini 时传入增强后的需求**
|
|
63
74
|
|
|
64
75
|
### 🔍 阶段 1:研究
|
|
65
76
|
|
|
@@ -72,32 +83,9 @@ EOF
|
|
|
72
83
|
|
|
73
84
|
`[模式:构思]` - Gemini 主导分析
|
|
74
85
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
```
|
|
78
|
-
Bash({
|
|
79
|
-
command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
|
|
80
|
-
ROLE_FILE: ~/.claude/.ccg/prompts/gemini/analyzer.md
|
|
86
|
+
调用 Gemini,使用分析提示词,输出 UI 可行性、推荐方案、用户体验。
|
|
81
87
|
|
|
82
|
-
|
|
83
|
-
分析以下前端需求,提供设计方案:
|
|
84
|
-
- 组件结构与状态管理
|
|
85
|
-
- 响应式策略
|
|
86
|
-
- 可访问性考虑
|
|
87
|
-
- 性能优化建议
|
|
88
|
-
|
|
89
|
-
需求:[具体任务描述]
|
|
90
|
-
</TASK>
|
|
91
|
-
|
|
92
|
-
OUTPUT: UI可行性、推荐方案、用户体验
|
|
93
|
-
EOF_GEMINI",
|
|
94
|
-
run_in_background: false,
|
|
95
|
-
timeout: 3600000,
|
|
96
|
-
description: "Gemini 前端分析"
|
|
97
|
-
})
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
**⚠️ 等待 Gemini 返回后继续**
|
|
88
|
+
**📌 保存 SESSION_ID**(`GEMINI_SESSION`)。
|
|
101
89
|
|
|
102
90
|
输出方案(至少 2 个),等待用户选择。
|
|
103
91
|
|
|
@@ -105,27 +93,7 @@ EOF_GEMINI",
|
|
|
105
93
|
|
|
106
94
|
`[模式:计划]` - Gemini 主导规划
|
|
107
95
|
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
```
|
|
111
|
-
Bash({
|
|
112
|
-
command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
|
|
113
|
-
ROLE_FILE: ~/.claude/.ccg/prompts/gemini/architect.md
|
|
114
|
-
|
|
115
|
-
<TASK>
|
|
116
|
-
规划需求: [具体任务描述]
|
|
117
|
-
Context: [项目上下文]
|
|
118
|
-
</TASK>
|
|
119
|
-
|
|
120
|
-
OUTPUT: 组件结构、UI流程、样式方案
|
|
121
|
-
EOF_GEMINI",
|
|
122
|
-
run_in_background: false,
|
|
123
|
-
timeout: 3600000,
|
|
124
|
-
description: "Gemini 前端架构规划"
|
|
125
|
-
})
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
**⚠️ 等待 Gemini 返回后继续**
|
|
96
|
+
调用 Gemini(`--resume $GEMINI_SESSION`),使用规划提示词,输出组件结构、UI流程、样式方案。
|
|
129
97
|
|
|
130
98
|
Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
131
99
|
|
|
@@ -141,27 +109,7 @@ Claude 综合规划,请求用户批准后存入 `.claude/plan/任务名.md`
|
|
|
141
109
|
|
|
142
110
|
`[模式:优化]` - Gemini 主导审查
|
|
143
111
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
```
|
|
147
|
-
Bash({
|
|
148
|
-
command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
|
|
149
|
-
ROLE_FILE: ~/.claude/.ccg/prompts/gemini/reviewer.md
|
|
150
|
-
|
|
151
|
-
<TASK>
|
|
152
|
-
审查代码: [实施的代码变更]
|
|
153
|
-
关注点: 可访问性、响应式、性能、设计一致性
|
|
154
|
-
</TASK>
|
|
155
|
-
|
|
156
|
-
OUTPUT: 审查意见
|
|
157
|
-
EOF_GEMINI",
|
|
158
|
-
run_in_background: false,
|
|
159
|
-
timeout: 3600000,
|
|
160
|
-
description: "Gemini 前端代码审查"
|
|
161
|
-
})
|
|
162
|
-
```
|
|
163
|
-
|
|
164
|
-
**⚠️ 等待 Gemini 返回后继续**
|
|
112
|
+
调用 Gemini,使用审查提示词,关注可访问性、响应式、性能、设计一致性。
|
|
165
113
|
|
|
166
114
|
整合审查意见,用户确认后执行优化。
|
|
167
115
|
|
|
@@ -6,20 +6,6 @@ description: '多模型性能优化:Codex 后端优化 + Gemini 前端优化'
|
|
|
6
6
|
|
|
7
7
|
双模型并行分析性能瓶颈,按性价比排序优化建议。
|
|
8
8
|
|
|
9
|
-
## 多模型调用语法
|
|
10
|
-
|
|
11
|
-
**必须使用 heredoc 语法调用外部模型**:
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - $PWD <<'EOF'
|
|
15
|
-
<任务内容>
|
|
16
|
-
EOF
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
> ⚠️ 禁止使用 `echo | codeagent-wrapper` 管道语法,会导致多行内容截断。
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
9
|
## 使用方法
|
|
24
10
|
|
|
25
11
|
```bash
|
|
@@ -41,18 +27,36 @@ EOF
|
|
|
41
27
|
|
|
42
28
|
---
|
|
43
29
|
|
|
30
|
+
## 多模型调用规范
|
|
31
|
+
|
|
32
|
+
**调用语法**(并行用 `run_in_background: true`):
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
Bash({
|
|
36
|
+
command: "~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - \"$PWD\" <<'EOF'
|
|
37
|
+
<TASK>
|
|
38
|
+
需求:<增强后的需求(如未增强则用 $ARGUMENTS)>
|
|
39
|
+
上下文:<目标代码、现有性能指标等>
|
|
40
|
+
</TASK>
|
|
41
|
+
OUTPUT: 性能瓶颈列表、优化方案、预期收益
|
|
42
|
+
EOF",
|
|
43
|
+
run_in_background: true,
|
|
44
|
+
timeout: 3600000,
|
|
45
|
+
description: "简短描述"
|
|
46
|
+
})
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
**并行调用**:使用 `run_in_background: true` 启动,用 `TaskOutput` 等待结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
44
53
|
## 执行工作流
|
|
45
54
|
|
|
46
55
|
**优化目标**:$ARGUMENTS
|
|
47
56
|
|
|
48
57
|
### 🔍 阶段 0:Prompt 增强(可选)
|
|
49
58
|
|
|
50
|
-
`[模式:准备]` -
|
|
51
|
-
|
|
52
|
-
**如果 ace-tool MCP 可用**,调用 `mcp__ace-tool__enhance_prompt`:
|
|
53
|
-
- 输入原始优化目标
|
|
54
|
-
- 获取增强后的详细需求
|
|
55
|
-
- 用增强后的需求替代原始 $ARGUMENTS
|
|
59
|
+
`[模式:准备]` - 如 ace-tool MCP 可用,调用 `mcp__ace-tool__enhance_prompt`,**用增强结果替代原始 $ARGUMENTS,后续调用 Codex/Gemini 时传入增强后的需求**
|
|
56
60
|
|
|
57
61
|
### 🔍 阶段 1:性能基线
|
|
58
62
|
|
|
@@ -66,54 +70,11 @@ EOF
|
|
|
66
70
|
|
|
67
71
|
`[模式:分析]`
|
|
68
72
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
|
|
73
|
-
|
|
74
|
-
**Codex 性能分析进程**:
|
|
75
|
-
```
|
|
76
|
-
Bash({
|
|
77
|
-
command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
|
|
78
|
-
[角色] 你是后端性能优化专家
|
|
79
|
-
|
|
80
|
-
[任务] 分析以下代码的后端性能问题:
|
|
81
|
-
$ARGUMENTS
|
|
82
|
-
|
|
83
|
-
[输出格式]
|
|
84
|
-
1. 性能瓶颈列表(按严重程度排序)
|
|
85
|
-
2. 每个问题的优化方案(含代码 Diff)
|
|
86
|
-
3. 预期收益评估
|
|
87
|
-
EOF_CODEX",
|
|
88
|
-
run_in_background: true,
|
|
89
|
-
timeout: 3600000,
|
|
90
|
-
description: "Codex 后端性能分析"
|
|
91
|
-
})
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
**Gemini 性能分析进程**:
|
|
95
|
-
```
|
|
96
|
-
Bash({
|
|
97
|
-
command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
|
|
98
|
-
[角色] 你是前端性能优化专家
|
|
99
|
-
|
|
100
|
-
[任务] 分析以下代码的前端性能问题:
|
|
101
|
-
$ARGUMENTS
|
|
102
|
-
|
|
103
|
-
[输出格式]
|
|
104
|
-
1. Core Web Vitals 问题列表
|
|
105
|
-
2. 每个问题的优化方案(含代码 Diff)
|
|
106
|
-
3. 预期收益评估
|
|
107
|
-
EOF_GEMINI",
|
|
108
|
-
run_in_background: true,
|
|
109
|
-
timeout: 3600000,
|
|
110
|
-
description: "Gemini 前端性能分析"
|
|
111
|
-
})
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
2. 使用 `TaskOutput` 监控并获取 2 个模型的分析结果。
|
|
73
|
+
**并行调用**(`run_in_background: true`):
|
|
74
|
+
- Codex:分析后端性能问题,输出瓶颈列表、优化方案、预期收益
|
|
75
|
+
- Gemini:分析前端性能问题(Core Web Vitals),输出瓶颈列表、优化方案、预期收益
|
|
115
76
|
|
|
116
|
-
|
|
77
|
+
用 `TaskOutput` 等待两个模型的完整结果。
|
|
117
78
|
|
|
118
79
|
### 🔀 阶段 3:优化整合
|
|
119
80
|
|
|
@@ -161,5 +122,3 @@ EOF_GEMINI",
|
|
|
161
122
|
2. **性价比优先** – 高影响 + 低难度优先
|
|
162
123
|
3. **不破坏功能** – 优化不能引入 bug
|
|
163
124
|
4. **信任规则** – 后端以 Codex 为准,前端以 Gemini 为准
|
|
164
|
-
5. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
|
|
165
|
-
6. **必须等待所有模型返回** – 禁止提前进入下一步
|
|
@@ -6,26 +6,37 @@ description: '多模型代码审查:无参数时自动审查 git diff,双模
|
|
|
6
6
|
|
|
7
7
|
双模型并行审查,交叉验证综合反馈。无参数时自动审查当前 git 变更。
|
|
8
8
|
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
**⚠️ 必须使用 heredoc 语法调用外部模型**:
|
|
9
|
+
## 使用方法
|
|
12
10
|
|
|
13
11
|
```bash
|
|
14
|
-
|
|
15
|
-
<任务内容>
|
|
16
|
-
EOF
|
|
12
|
+
/review [代码或描述]
|
|
17
13
|
```
|
|
18
14
|
|
|
15
|
+
- **无参数**:自动审查 `git diff HEAD`
|
|
16
|
+
- **有参数**:审查指定代码或描述
|
|
17
|
+
|
|
19
18
|
---
|
|
20
19
|
|
|
21
|
-
##
|
|
20
|
+
## 多模型调用规范
|
|
21
|
+
|
|
22
|
+
**调用语法**(并行用 `run_in_background: true`):
|
|
22
23
|
|
|
23
|
-
```
|
|
24
|
-
|
|
24
|
+
```
|
|
25
|
+
Bash({
|
|
26
|
+
command: "~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - \"$PWD\" <<'EOF'
|
|
27
|
+
<TASK>
|
|
28
|
+
审查以下代码变更:
|
|
29
|
+
<git diff 内容>
|
|
30
|
+
</TASK>
|
|
31
|
+
OUTPUT: 按 Critical/Major/Minor/Suggestion 分类列出问题
|
|
32
|
+
EOF",
|
|
33
|
+
run_in_background: true,
|
|
34
|
+
timeout: 3600000,
|
|
35
|
+
description: "简短描述"
|
|
36
|
+
})
|
|
25
37
|
```
|
|
26
38
|
|
|
27
|
-
|
|
28
|
-
- **有参数**:审查指定代码或描述
|
|
39
|
+
**并行调用**:使用 `run_in_background: true` 启动,用 `TaskOutput` 等待结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
29
40
|
|
|
30
41
|
---
|
|
31
42
|
|
|
@@ -35,11 +46,7 @@ EOF
|
|
|
35
46
|
|
|
36
47
|
`[模式:研究]`
|
|
37
48
|
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
git diff HEAD
|
|
41
|
-
git status --short
|
|
42
|
-
```
|
|
49
|
+
**无参数时**:执行 `git diff HEAD` 和 `git status --short`
|
|
43
50
|
|
|
44
51
|
**有参数时**:使用指定的代码/描述
|
|
45
52
|
|
|
@@ -49,64 +56,11 @@ git status --short
|
|
|
49
56
|
|
|
50
57
|
`[模式:审查]`
|
|
51
58
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
|
|
56
|
-
|
|
57
|
-
**Codex 审查进程**:
|
|
58
|
-
```
|
|
59
|
-
Bash({
|
|
60
|
-
command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
|
|
61
|
-
[角色] 后端代码审查专家
|
|
62
|
-
[任务] 审查以下代码变更
|
|
63
|
-
|
|
64
|
-
## 审查重点
|
|
65
|
-
- 安全性:注入、认证、授权
|
|
66
|
-
- 性能:N+1 查询、缓存、复杂度
|
|
67
|
-
- 错误处理:异常捕获、边界条件
|
|
68
|
-
- 可维护性:命名、结构、文档
|
|
69
|
-
|
|
70
|
-
## 待审查代码
|
|
71
|
-
<粘贴 git diff 内容>
|
|
72
|
-
|
|
73
|
-
## 输出格式
|
|
74
|
-
按 Critical/Major/Minor/Suggestion 分类列出问题
|
|
75
|
-
EOF_CODEX",
|
|
76
|
-
run_in_background: true,
|
|
77
|
-
timeout: 3600000,
|
|
78
|
-
description: "Codex 后端代码审查"
|
|
79
|
-
})
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
**Gemini 审查进程**:
|
|
83
|
-
```
|
|
84
|
-
Bash({
|
|
85
|
-
command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
|
|
86
|
-
[角色] 前端代码审查专家
|
|
87
|
-
[任务] 审查以下代码变更
|
|
88
|
-
|
|
89
|
-
## 审查重点
|
|
90
|
-
- 可访问性:ARIA、键盘导航、色彩对比
|
|
91
|
-
- 响应式:移动端适配、断点
|
|
92
|
-
- 设计一致性:组件复用、样式规范
|
|
93
|
-
- 用户体验:加载状态、错误提示
|
|
94
|
-
|
|
95
|
-
## 待审查代码
|
|
96
|
-
<粘贴 git diff 内容>
|
|
97
|
-
|
|
98
|
-
## 输出格式
|
|
99
|
-
按 Critical/Major/Minor/Suggestion 分类列出问题
|
|
100
|
-
EOF_GEMINI",
|
|
101
|
-
run_in_background: true,
|
|
102
|
-
timeout: 3600000,
|
|
103
|
-
description: "Gemini 前端代码审查"
|
|
104
|
-
})
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
2. 使用 `TaskOutput` 监控并获取 2 个模型的审查结果。
|
|
59
|
+
**并行调用**(`run_in_background: true`):
|
|
60
|
+
- Codex:审查安全性、性能、错误处理、可维护性
|
|
61
|
+
- Gemini:审查可访问性、响应式、设计一致性、用户体验
|
|
108
62
|
|
|
109
|
-
|
|
63
|
+
用 `TaskOutput` 等待两个模型的审查结果。
|
|
110
64
|
|
|
111
65
|
### 🔀 阶段 3:综合反馈
|
|
112
66
|
|
|
@@ -143,7 +97,5 @@ EOF_GEMINI",
|
|
|
143
97
|
## 关键规则
|
|
144
98
|
|
|
145
99
|
1. **无参数 = 审查 git diff** – 自动获取当前变更
|
|
146
|
-
2.
|
|
147
|
-
3.
|
|
148
|
-
4. **使用 Bash 工具的 `run_in_background: true` 参数 + `TaskOutput` 获取结果**
|
|
149
|
-
5. **必须等待所有模型返回** – 禁止提前进入下一步
|
|
100
|
+
2. **双模型交叉验证** – 后端问题以 Codex 为准,前端问题以 Gemini 为准
|
|
101
|
+
3. 外部模型对文件系统**零写入权限**
|
|
@@ -6,16 +6,6 @@ description: '多模型测试生成:智能路由 Codex 后端测试 / Gemini
|
|
|
6
6
|
|
|
7
7
|
根据代码类型智能路由,生成高质量测试用例。
|
|
8
8
|
|
|
9
|
-
## 多模型调用语法
|
|
10
|
-
|
|
11
|
-
**必须使用 heredoc 语法调用 codeagent-wrapper**:
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - [工作目录] <<'EOF'
|
|
15
|
-
<任务内容>
|
|
16
|
-
EOF
|
|
17
|
-
```
|
|
18
|
-
|
|
19
9
|
## 使用方法
|
|
20
10
|
|
|
21
11
|
```bash
|
|
@@ -37,18 +27,48 @@ EOF
|
|
|
37
27
|
|
|
38
28
|
---
|
|
39
29
|
|
|
30
|
+
## 多模型调用规范
|
|
31
|
+
|
|
32
|
+
**调用语法**(并行用 `run_in_background: true`):
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
Bash({
|
|
36
|
+
command: "~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - \"$PWD\" <<'EOF'
|
|
37
|
+
<TASK>
|
|
38
|
+
需求:为以下代码生成测试
|
|
39
|
+
<代码内容>
|
|
40
|
+
需求描述:<增强后的需求(如未增强则用 $ARGUMENTS)>
|
|
41
|
+
要求:
|
|
42
|
+
1. 使用项目现有测试框架
|
|
43
|
+
2. 覆盖正常路径、边界条件、异常处理
|
|
44
|
+
</TASK>
|
|
45
|
+
OUTPUT: 完整测试代码
|
|
46
|
+
EOF",
|
|
47
|
+
run_in_background: true,
|
|
48
|
+
timeout: 3600000,
|
|
49
|
+
description: "简短描述"
|
|
50
|
+
})
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
**智能路由**:
|
|
54
|
+
|
|
55
|
+
| 代码类型 | 路由 |
|
|
56
|
+
|---------|------|
|
|
57
|
+
| 后端 | Codex |
|
|
58
|
+
| 前端 | Gemini |
|
|
59
|
+
| 全栈 | 并行执行两者 |
|
|
60
|
+
|
|
61
|
+
**并行调用**:使用 `run_in_background: true` 启动,用 `TaskOutput` 等待结果。**必须等所有模型返回后才能进入下一阶段**。
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
40
65
|
## 执行工作流
|
|
41
66
|
|
|
42
67
|
**测试目标**:$ARGUMENTS
|
|
43
68
|
|
|
44
69
|
### 🔍 阶段 0:Prompt 增强(可选)
|
|
45
70
|
|
|
46
|
-
`[模式:准备]` -
|
|
47
|
-
|
|
48
|
-
**如果 ace-tool MCP 可用**,调用 `mcp__ace-tool__enhance_prompt`:
|
|
49
|
-
- 输入原始测试目标
|
|
50
|
-
- 获取增强后的详细测试需求
|
|
51
|
-
- 用增强后的需求替代原始 $ARGUMENTS
|
|
71
|
+
`[模式:准备]` - 如 ace-tool MCP 可用,调用 `mcp__ace-tool__enhance_prompt`,**用增强结果替代原始 $ARGUMENTS,后续调用 Codex/Gemini 时传入增强后的需求**
|
|
52
72
|
|
|
53
73
|
### 🔍 阶段 1:测试分析
|
|
54
74
|
|
|
@@ -63,60 +83,12 @@ EOF
|
|
|
63
83
|
|
|
64
84
|
`[模式:生成]`
|
|
65
85
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
| 全栈 | 并行执行 | 两者 |
|
|
71
|
-
|
|
72
|
-
**全栈代码并行调用**:
|
|
73
|
-
|
|
74
|
-
**执行步骤**:
|
|
75
|
-
1. 使用 **Bash 工具的 `run_in_background: true` 参数**启动两个后台进程:
|
|
76
|
-
|
|
77
|
-
**Codex 测试生成进程**:
|
|
78
|
-
```
|
|
79
|
-
Bash({
|
|
80
|
-
command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF_CODEX'
|
|
81
|
-
你是后端测试专家,角色提示词见 ~/.claude/.ccg/prompts/codex/tester.md
|
|
82
|
-
|
|
83
|
-
任务:为以下代码生成单元测试
|
|
84
|
-
<代码内容>
|
|
85
|
-
|
|
86
|
-
要求:
|
|
87
|
-
1. 使用项目现有测试框架
|
|
88
|
-
2. 覆盖正常路径、边界条件、异常处理
|
|
89
|
-
3. 输出完整测试代码
|
|
90
|
-
EOF_CODEX",
|
|
91
|
-
run_in_background: true,
|
|
92
|
-
timeout: 3600000,
|
|
93
|
-
description: "Codex 后端测试生成"
|
|
94
|
-
})
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
**Gemini 测试生成进程**:
|
|
98
|
-
```
|
|
99
|
-
Bash({
|
|
100
|
-
command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF_GEMINI'
|
|
101
|
-
你是前端测试专家,角色提示词见 ~/.claude/.ccg/prompts/gemini/tester.md
|
|
102
|
-
|
|
103
|
-
任务:为以下组件生成测试
|
|
104
|
-
<组件代码>
|
|
105
|
-
|
|
106
|
-
要求:
|
|
107
|
-
1. 使用项目现有测试框架
|
|
108
|
-
2. 测试渲染、交互、状态变化
|
|
109
|
-
3. 输出完整测试代码
|
|
110
|
-
EOF_GEMINI",
|
|
111
|
-
run_in_background: true,
|
|
112
|
-
timeout: 3600000,
|
|
113
|
-
description: "Gemini 前端测试生成"
|
|
114
|
-
})
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
2. 使用 `TaskOutput` 监控并获取 2 个模型的测试代码。
|
|
86
|
+
**根据代码类型路由**:
|
|
87
|
+
- 后端代码:调用 Codex 生成测试
|
|
88
|
+
- 前端代码:调用 Gemini 生成测试
|
|
89
|
+
- 全栈代码:并行调用两者(`run_in_background: true`)
|
|
118
90
|
|
|
119
|
-
|
|
91
|
+
用 `TaskOutput` 等待模型返回测试代码。
|
|
120
92
|
|
|
121
93
|
### 🔀 阶段 3:测试整合
|
|
122
94
|
|
|
@@ -168,5 +140,4 @@ EOF_GEMINI",
|
|
|
168
140
|
1. **测试行为,不测试实现** – 关注输入输出
|
|
169
141
|
2. **智能路由** – 后端测试用 Codex,前端测试用 Gemini
|
|
170
142
|
3. **复用现有模式** – 遵循项目已有的测试风格
|
|
171
|
-
4.
|
|
172
|
-
5. **必须等待所有模型返回** – 禁止提前进入下一步
|
|
143
|
+
4. 外部模型对文件系统**零写入权限**
|