ccg-workflow 1.0.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.
- package/LICENSE +21 -0
- package/README.md +434 -0
- package/bin/ccg.mjs +2 -0
- 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-windows-amd64.exe +0 -0
- package/dist/cli.d.mts +1 -0
- package/dist/cli.d.ts +1 -0
- package/dist/cli.mjs +97 -0
- package/dist/index.d.mts +134 -0
- package/dist/index.d.ts +134 -0
- package/dist/index.mjs +10 -0
- package/dist/shared/ccg-workflow.D_RkPyZ0.mjs +1117 -0
- package/package.json +63 -0
- package/prompts/claude/analyzer.md +59 -0
- package/prompts/claude/architect.md +54 -0
- package/prompts/claude/debugger.md +71 -0
- package/prompts/claude/optimizer.md +73 -0
- package/prompts/claude/reviewer.md +63 -0
- package/prompts/claude/tester.md +69 -0
- package/prompts/codex/analyzer.md +50 -0
- package/prompts/codex/architect.md +46 -0
- package/prompts/codex/debugger.md +66 -0
- package/prompts/codex/optimizer.md +74 -0
- package/prompts/codex/reviewer.md +66 -0
- package/prompts/codex/tester.md +55 -0
- package/prompts/gemini/analyzer.md +53 -0
- package/prompts/gemini/debugger.md +70 -0
- package/prompts/gemini/frontend.md +56 -0
- package/prompts/gemini/optimizer.md +77 -0
- package/prompts/gemini/reviewer.md +73 -0
- package/prompts/gemini/tester.md +61 -0
- package/templates/commands/_config.md +85 -0
- package/templates/commands/analyze.md +73 -0
- package/templates/commands/backend.md +81 -0
- package/templates/commands/bugfix.md +55 -0
- package/templates/commands/clean-branches.md +102 -0
- package/templates/commands/code.md +169 -0
- package/templates/commands/commit.md +158 -0
- package/templates/commands/debug.md +104 -0
- package/templates/commands/dev.md +153 -0
- package/templates/commands/enhance.md +49 -0
- package/templates/commands/frontend.md +80 -0
- package/templates/commands/init.md +53 -0
- package/templates/commands/optimize.md +69 -0
- package/templates/commands/review.md +85 -0
- package/templates/commands/rollback.md +90 -0
- package/templates/commands/test.md +53 -0
- package/templates/commands/think.md +73 -0
- package/templates/commands/worktree.md +276 -0
- package/templates/prompts/claude/analyzer.md +59 -0
- package/templates/prompts/claude/architect.md +54 -0
- package/templates/prompts/claude/debugger.md +71 -0
- package/templates/prompts/claude/optimizer.md +73 -0
- package/templates/prompts/claude/reviewer.md +63 -0
- package/templates/prompts/claude/tester.md +69 -0
- package/templates/prompts/codex/analyzer.md +50 -0
- package/templates/prompts/codex/architect.md +46 -0
- package/templates/prompts/codex/debugger.md +66 -0
- package/templates/prompts/codex/optimizer.md +74 -0
- package/templates/prompts/codex/reviewer.md +66 -0
- package/templates/prompts/codex/tester.md +55 -0
- package/templates/prompts/gemini/analyzer.md +53 -0
- package/templates/prompts/gemini/debugger.md +70 -0
- package/templates/prompts/gemini/frontend.md +56 -0
- package/templates/prompts/gemini/optimizer.md +77 -0
- package/templates/prompts/gemini/reviewer.md +73 -0
- package/templates/prompts/gemini/tester.md +61 -0
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 完整6阶段多模型协作工作流(Prompt增强 → 上下文检索 → 多模型分析 → 原型生成 → 代码实施 → 审计交付)
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
> 调用语法见 `_config.md`
|
|
6
|
+
|
|
7
|
+
## 用法
|
|
8
|
+
`/dev <功能描述>`
|
|
9
|
+
|
|
10
|
+
## 上下文
|
|
11
|
+
- 要实现的功能: $ARGUMENTS
|
|
12
|
+
- 此命令触发完整的 6 阶段多模型协作工作流
|
|
13
|
+
- 根据 `~/.ccg/config.toml` 配置路由模型
|
|
14
|
+
|
|
15
|
+
## 配置
|
|
16
|
+
**首先读取 `~/.ccg/config.toml` 获取模型路由配置**:
|
|
17
|
+
```toml
|
|
18
|
+
[routing]
|
|
19
|
+
mode = "smart" # smart | parallel | sequential
|
|
20
|
+
|
|
21
|
+
[routing.frontend]
|
|
22
|
+
models = ["gemini", "claude", "codex"] # 三模型并行
|
|
23
|
+
primary = "gemini"
|
|
24
|
+
strategy = "parallel"
|
|
25
|
+
|
|
26
|
+
[routing.backend]
|
|
27
|
+
models = ["codex", "claude", "gemini"] # 三模型并行
|
|
28
|
+
primary = "codex"
|
|
29
|
+
strategy = "parallel"
|
|
30
|
+
|
|
31
|
+
[routing.review]
|
|
32
|
+
models = ["codex", "gemini", "claude"] # 三模型交叉验证
|
|
33
|
+
strategy = "parallel"
|
|
34
|
+
|
|
35
|
+
[routing.prototype]
|
|
36
|
+
models = ["codex", "gemini", "claude"] # 三模型原型生成
|
|
37
|
+
strategy = "parallel"
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## 你的角色
|
|
41
|
+
你是**编排者**,协调三模型协作系统。你指挥:
|
|
42
|
+
1. **ace-tool** – 用于 Prompt 增强和代码库上下文检索
|
|
43
|
+
2. **Codex** – 后端逻辑、算法、调试专家
|
|
44
|
+
3. **Gemini** – 前端 UI/UX、视觉设计专家
|
|
45
|
+
4. **Claude (子进程)** – 全栈整合、契约设计、跨层问题
|
|
46
|
+
5. **Claude (自己)** – 编排、重构、最终交付
|
|
47
|
+
|
|
48
|
+
## 流程
|
|
49
|
+
|
|
50
|
+
### 阶段 0: 读取配置 + Prompt 增强
|
|
51
|
+
1. **读取 `~/.ccg/config.toml`** 获取模型路由配置
|
|
52
|
+
2. 如果配置不存在,使用默认值:frontend=gemini, backend=codex
|
|
53
|
+
3. 调用 `mcp__ace-tool__enhance_prompt` 优化原始需求
|
|
54
|
+
4. 向用户展示原始和增强后的 prompt:
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
📝 原始需求:
|
|
58
|
+
<原始需求>
|
|
59
|
+
|
|
60
|
+
✨ 增强后需求:
|
|
61
|
+
<增强后需求>
|
|
62
|
+
|
|
63
|
+
🔧 模型配置:
|
|
64
|
+
- 前端模型: <routing.frontend.models>
|
|
65
|
+
- 后端模型: <routing.backend.models>
|
|
66
|
+
- 协作模式: <routing.mode>
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
**使用增强后的需求继续?(Y/N)**
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
5. **强制停止**: 等待用户确认
|
|
73
|
+
- 如果 Y: 后续阶段使用增强后的 prompt
|
|
74
|
+
- 如果 N: 使用原始 prompt 或要求修改
|
|
75
|
+
|
|
76
|
+
### 阶段 1: 上下文检索
|
|
77
|
+
1. 调用 `mcp__ace-tool__search_context` 获取(增强后的)需求相关代码
|
|
78
|
+
2. 识别所有相关文件、类、函数和依赖
|
|
79
|
+
3. 如需求仍不清晰,提出澄清问题
|
|
80
|
+
|
|
81
|
+
### 阶段 2: 多模型分析
|
|
82
|
+
|
|
83
|
+
**根据配置并行调用模型进行分析**(使用 `run_in_background: true` 非阻塞执行):
|
|
84
|
+
|
|
85
|
+
根据 `routing.backend.models` 和 `routing.frontend.models` 动态生成调用:
|
|
86
|
+
- **后端模型**: 使用 `analyzer` 角色,输出实现方案
|
|
87
|
+
- **前端模型**: 使用 `analyzer` 角色,输出实现方案
|
|
88
|
+
|
|
89
|
+
然后使用 `TaskOutput` 获取所有任务的结果,交叉验证后综合方案。
|
|
90
|
+
|
|
91
|
+
**强制停止**: 询问用户 **"是否继续执行此方案?(Y/N)"** 并等待确认
|
|
92
|
+
|
|
93
|
+
### 阶段 3: 原型生成
|
|
94
|
+
|
|
95
|
+
**三模型并行生成原型**(使用 `run_in_background: true`):
|
|
96
|
+
|
|
97
|
+
根据 `routing.prototype.models` 配置,同时调用三个模型:
|
|
98
|
+
- **Codex** + `architect` 角色 → 后端架构视角的原型
|
|
99
|
+
- **Gemini** + `frontend` 角色 → 前端 UI 视角的原型
|
|
100
|
+
- **Claude** + `architect` 角色 → 全栈整合视角的原型
|
|
101
|
+
|
|
102
|
+
输出: `Unified Diff Patch ONLY`
|
|
103
|
+
|
|
104
|
+
使用 `TaskOutput` 收集三个模型的结果。
|
|
105
|
+
|
|
106
|
+
**三模型差异化价值**:
|
|
107
|
+
| 模型 | 专注点 | 独特贡献 |
|
|
108
|
+
|------|--------|----------|
|
|
109
|
+
| Codex | 后端逻辑、算法 | 深度后端专业知识 |
|
|
110
|
+
| Gemini | 前端 UI、样式 | 视觉设计和用户体验 |
|
|
111
|
+
| Claude | 全栈整合、契约 | 桥接前后端视角 |
|
|
112
|
+
|
|
113
|
+
### 阶段 4: 代码实施
|
|
114
|
+
1. 将三个原型视为"脏原型" – 仅作参考
|
|
115
|
+
2. **交叉验证三模型结果,集各家所长**:
|
|
116
|
+
- Codex 的后端逻辑优势
|
|
117
|
+
- Gemini 的前端设计优势
|
|
118
|
+
- Claude 的整合视角优势
|
|
119
|
+
3. 重构为干净的生产级代码
|
|
120
|
+
4. 验证变更不会引入副作用
|
|
121
|
+
|
|
122
|
+
### 阶段 5: 审计与交付
|
|
123
|
+
|
|
124
|
+
**三模型并行代码审查**(使用 `run_in_background: true`):
|
|
125
|
+
|
|
126
|
+
根据 `routing.review.models` 配置调用所有模型:
|
|
127
|
+
- **Codex** + `reviewer` 角色 → 安全性、性能、错误处理
|
|
128
|
+
- **Gemini** + `reviewer` 角色 → 可访问性、响应式设计、设计一致性
|
|
129
|
+
- **Claude** + `reviewer` 角色 → 集成正确性、契约一致性、可维护性
|
|
130
|
+
|
|
131
|
+
输出: `Review comments only`
|
|
132
|
+
|
|
133
|
+
使用 `TaskOutput` 获取所有审查结果,整合三方反馈后修正并交付。
|
|
134
|
+
|
|
135
|
+
## 输出格式
|
|
136
|
+
1. **配置信息** – 使用的模型和路由策略
|
|
137
|
+
2. **增强后需求** – 优化后的 prompt (阶段 0)
|
|
138
|
+
3. **上下文摘要** – 识别的相关代码元素
|
|
139
|
+
4. **实施方案** – 含模型路由的逐步方案
|
|
140
|
+
5. **代码变更** – 生产级实现
|
|
141
|
+
6. **审计报告** – 审查反馈和修正
|
|
142
|
+
7. **后续步骤** – 部署或跟进操作
|
|
143
|
+
|
|
144
|
+
## 关键规则
|
|
145
|
+
- 未经用户批准不得跳过任何阶段
|
|
146
|
+
- **首先读取 `~/.ccg/config.toml` 获取模型配置**
|
|
147
|
+
- **阶段 0 的 prompt 增强是强制性的** – 必须先展示增强后的 prompt
|
|
148
|
+
- 始终要求外部模型输出 Unified Diff Patch
|
|
149
|
+
- 外部模型对文件系统**零写入权限**
|
|
150
|
+
- 实时向用户报告当前阶段和下一阶段
|
|
151
|
+
- 使用 HEREDOC 语法 (`<<'EOF'`) 避免 shell 转义问题
|
|
152
|
+
- **三模型并行调用使用 `run_in_background: true`** 避免阻塞
|
|
153
|
+
- **三模型结果需交叉验证,集各家所长**
|
|
@@ -0,0 +1,49 @@
|
|
|
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__ace-tool__enhance_prompt` with the original prompt
|
|
19
|
+
2. Extract the enhanced version
|
|
20
|
+
|
|
21
|
+
### Step 2: User Confirmation (寸止)
|
|
22
|
+
**CRITICAL**: You MUST stop and show the enhanced prompt to the user.
|
|
23
|
+
|
|
24
|
+
Display format:
|
|
25
|
+
```
|
|
26
|
+
📝 原始 Prompt:
|
|
27
|
+
<original prompt>
|
|
28
|
+
|
|
29
|
+
✨ 增强后 Prompt:
|
|
30
|
+
<enhanced prompt>
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
**是否使用增强后的 prompt 继续执行?(Y/N)**
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Wait for user confirmation before proceeding.
|
|
37
|
+
|
|
38
|
+
### Step 3: Execute (Only after confirmation)
|
|
39
|
+
If user confirms (Y):
|
|
40
|
+
- Execute the enhanced prompt as the actual task
|
|
41
|
+
- Follow appropriate workflow based on task type
|
|
42
|
+
|
|
43
|
+
If user declines (N):
|
|
44
|
+
- Ask user for modifications or use original prompt
|
|
45
|
+
|
|
46
|
+
## Notes
|
|
47
|
+
- Always show both original and enhanced versions
|
|
48
|
+
- Never auto-execute without user confirmation
|
|
49
|
+
- The enhanced prompt provides better context for multi-model collaboration
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 前端/UI/样式任务,自动路由到配置的前端模型进行原型生成和审计
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
> 调用语法见 `_config.md`
|
|
6
|
+
|
|
7
|
+
## 用法
|
|
8
|
+
`/frontend <UI_TASK_DESCRIPTION>`
|
|
9
|
+
|
|
10
|
+
## 上下文
|
|
11
|
+
- Frontend/UI task to implement: $ARGUMENTS
|
|
12
|
+
- This command routes to your configured frontend models.
|
|
13
|
+
- Default authority for CSS, React, Vue, and visual design.
|
|
14
|
+
|
|
15
|
+
## 配置
|
|
16
|
+
**首先读取 `~/.ccg/config.toml` 获取模型路由配置**:
|
|
17
|
+
```toml
|
|
18
|
+
[routing.frontend]
|
|
19
|
+
models = ["gemini", "codex"] # 用户配置的前端模型列表
|
|
20
|
+
primary = "gemini" # 主模型
|
|
21
|
+
strategy = "parallel" # 路由策略: parallel | fallback | round-robin
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## 你的角色
|
|
25
|
+
You are the **Frontend Orchestrator** specializing in UI/UX implementation. You coordinate:
|
|
26
|
+
1. **ace-tool** – for retrieving existing frontend code and components
|
|
27
|
+
2. **Configured Frontend Models** – for generating CSS/React/Vue prototypes
|
|
28
|
+
3. **Claude (Self)** – for refactoring prototypes into production code
|
|
29
|
+
|
|
30
|
+
## 流程
|
|
31
|
+
|
|
32
|
+
### Step 1: 读取配置
|
|
33
|
+
1. Read `~/.ccg/config.toml` to get frontend model configuration
|
|
34
|
+
2. Identify which models to use based on `routing.frontend.models`
|
|
35
|
+
3. If config doesn't exist, default to `gemini`
|
|
36
|
+
|
|
37
|
+
### Step 2: 上下文检索
|
|
38
|
+
1. Call `mcp__ace-tool__search_context` to find existing UI components, styles, and patterns
|
|
39
|
+
2. Identify the design system, component library, and styling conventions in use
|
|
40
|
+
|
|
41
|
+
### Step 3: 模型原型生成
|
|
42
|
+
|
|
43
|
+
**根据配置的 strategy 执行**:
|
|
44
|
+
- **parallel**: 同时调用所有配置的前端模型,综合结果
|
|
45
|
+
- **fallback**: 调用主模型,失败则调用次模型
|
|
46
|
+
- **round-robin**: 轮询调用
|
|
47
|
+
|
|
48
|
+
遍历 `routing.frontend.models`,为每个模型发送调用:
|
|
49
|
+
- **Gemini**: 使用 `frontend` 角色
|
|
50
|
+
- **Codex**: 使用 `architect` 角色(Codex 无专门前端角色)
|
|
51
|
+
- 输出: `Unified Diff Patch ONLY`
|
|
52
|
+
|
|
53
|
+
**如果 strategy = parallel 且有多个模型**:
|
|
54
|
+
使用 `run_in_background: true` 并行调用所有模型,然后用 `TaskOutput` 收集结果。
|
|
55
|
+
|
|
56
|
+
### Step 4: 重构与实施
|
|
57
|
+
1. Review model prototype(s) as "dirty prototype"
|
|
58
|
+
2. If multiple models, cross-validate and select best patterns
|
|
59
|
+
3. Refactor into clean, maintainable code
|
|
60
|
+
4. Ensure consistency with existing components
|
|
61
|
+
|
|
62
|
+
### Step 5: 审计
|
|
63
|
+
|
|
64
|
+
Call configured frontend model(s) to review the final implementation:
|
|
65
|
+
- 使用 `reviewer` 角色
|
|
66
|
+
- 审查内容: accessibility, responsiveness, design consistency
|
|
67
|
+
- 输出: `Review comments only`
|
|
68
|
+
|
|
69
|
+
## 输出格式
|
|
70
|
+
1. **Configuration** – models and strategy being used
|
|
71
|
+
2. **Component Analysis** – existing patterns and design system
|
|
72
|
+
3. **Model Prototype(s)** – raw prototypes from configured models
|
|
73
|
+
4. **Refined Implementation** – production-ready UI code
|
|
74
|
+
5. **Audit Feedback** – accessibility and design review
|
|
75
|
+
|
|
76
|
+
## 注意事项
|
|
77
|
+
- Gemini context limit: < 32k tokens
|
|
78
|
+
- Read `~/.ccg/config.toml` at start of execution
|
|
79
|
+
- Always request Unified Diff Patch format
|
|
80
|
+
- Use HEREDOC syntax (`<<'EOF'`) to avoid shell escaping issues
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 初始化项目 AI 上下文,生成/更新根级与模块级 CLAUDE.md 索引
|
|
3
|
+
allowed-tools: Read(**), Write(CLAUDE.md, **/CLAUDE.md)
|
|
4
|
+
argument-hint: <项目摘要或名称>
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 用法
|
|
8
|
+
|
|
9
|
+
`/init-project <项目摘要或名称>`
|
|
10
|
+
|
|
11
|
+
## 目标
|
|
12
|
+
|
|
13
|
+
以"根级简明 + 模块级详尽"的混合策略初始化项目 AI 上下文:
|
|
14
|
+
|
|
15
|
+
- 在仓库根生成/更新 `CLAUDE.md`(高层愿景、架构总览、模块索引、全局规范)。
|
|
16
|
+
- 在识别的各模块目录生成/更新本地 `CLAUDE.md`(接口、依赖、入口、测试、关键文件等)。
|
|
17
|
+
- ✨ **为了提升可读性,会在根 `CLAUDE.md` 中自动生成 Mermaid 结构图,并为每个模块 `CLAUDE.md` 添加导航面包屑**。
|
|
18
|
+
|
|
19
|
+
## 编排说明
|
|
20
|
+
|
|
21
|
+
**步骤 1**:调用 `get-current-datetime` 子智能体获取当前时间戳。
|
|
22
|
+
|
|
23
|
+
**步骤 2**:调用一次 `init-architect` 子智能体,输入:
|
|
24
|
+
|
|
25
|
+
- `project_summary`: $ARGUMENTS
|
|
26
|
+
- `current_timestamp`: (来自步骤1的时间戳)
|
|
27
|
+
|
|
28
|
+
## 执行策略(由 Agent 自适应决定,不需要用户传参)
|
|
29
|
+
|
|
30
|
+
- **阶段 A:全仓清点(轻量)**
|
|
31
|
+
快速统计文件与目录,识别模块根(package.json、pyproject.toml、go.mod、apps/_、packages/_、services/\* 等)。
|
|
32
|
+
- **阶段 B:模块优先扫描(中等)**
|
|
33
|
+
对每个模块做"入口/接口/依赖/测试/数据模型/质量工具"的定点读取与样本抽取。
|
|
34
|
+
- **阶段 C:深度补捞(按需)**
|
|
35
|
+
若仓库较小或模块规模较小,则扩大读取面;若较大,则对高风险/高价值路径分批追加扫描。
|
|
36
|
+
- **覆盖率度量与可续跑**
|
|
37
|
+
输出"已扫描文件数 / 估算总文件数、已覆盖模块占比、被忽略/跳过原因",并列出"建议下一步深挖的子路径"。重复运行 `/init-project` 时按上次索引做**增量更新**与**断点续扫**。
|
|
38
|
+
|
|
39
|
+
## 安全与边界
|
|
40
|
+
|
|
41
|
+
- 只读/写文档与索引,不改源代码。
|
|
42
|
+
- 默认忽略常见生成物与二进制大文件。
|
|
43
|
+
- 结果在主对话打印"摘要",全文写入仓库。
|
|
44
|
+
|
|
45
|
+
## 输出要求
|
|
46
|
+
|
|
47
|
+
- 在主对话中打印"初始化结果摘要",包含:
|
|
48
|
+
- 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览。
|
|
49
|
+
- 识别的模块数量及其路径列表。
|
|
50
|
+
- 每个模块 `CLAUDE.md` 的生成/更新情况。
|
|
51
|
+
- ✨ **明确提及"已生成 Mermaid 结构图"和"已为 N 个模块添加导航面包屑"**。
|
|
52
|
+
- 覆盖率与主要缺口。
|
|
53
|
+
- 若未读全:说明"为何到此为止",并列出**推荐的下一步**(例如"建议优先补扫:packages/auth/src/controllers")。
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 多模型性能优化(Codex 后端优化 + Gemini 前端优化)
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
> 调用语法见 `_config.md`
|
|
6
|
+
|
|
7
|
+
## 用法
|
|
8
|
+
`/optimize <优化目标>`
|
|
9
|
+
|
|
10
|
+
## 上下文
|
|
11
|
+
- 优化目标: $ARGUMENTS
|
|
12
|
+
- Codex 专注后端性能(数据库、算法、缓存)
|
|
13
|
+
- Gemini 专注前端性能(渲染、加载、交互)
|
|
14
|
+
|
|
15
|
+
## 流程
|
|
16
|
+
|
|
17
|
+
### Phase 1: 性能基线分析
|
|
18
|
+
1. 调用 `mcp__ace-tool__search_context` 检索目标代码
|
|
19
|
+
2. 识别性能关键路径
|
|
20
|
+
3. 收集现有指标(如有):
|
|
21
|
+
- 后端: 响应时间、查询耗时、内存占用
|
|
22
|
+
- 前端: LCP、FID、CLS、Bundle Size
|
|
23
|
+
|
|
24
|
+
### Phase 2: 并行性能分析
|
|
25
|
+
**同时调用**(`run_in_background: true`):
|
|
26
|
+
- **Codex** + `optimizer` 角色 → 后端性能分析
|
|
27
|
+
- **Gemini** + `optimizer` 角色 → 前端性能分析
|
|
28
|
+
|
|
29
|
+
输出: `Analysis report + Unified Diff Patch for optimizations`
|
|
30
|
+
|
|
31
|
+
### Phase 3: 优化整合
|
|
32
|
+
1. 收集双模型分析(`TaskOutput`)
|
|
33
|
+
2. **优先级排序**:按影响程度 × 实施难度 计算性价比
|
|
34
|
+
3. Claude 重构优化代码
|
|
35
|
+
|
|
36
|
+
### Phase 4: 实施优化
|
|
37
|
+
1. 按优先级实施
|
|
38
|
+
2. 确保不破坏现有功能
|
|
39
|
+
3. 添加必要的性能监控
|
|
40
|
+
|
|
41
|
+
### Phase 5: 验证
|
|
42
|
+
1. 运行性能测试(如有)
|
|
43
|
+
2. 对比优化前后指标
|
|
44
|
+
3. 双模型审查优化效果
|
|
45
|
+
|
|
46
|
+
## 性能指标参考
|
|
47
|
+
|
|
48
|
+
### 后端
|
|
49
|
+
| 指标 | 良好 | 需优化 | 严重 |
|
|
50
|
+
|------|------|--------|------|
|
|
51
|
+
| API 响应 | <100ms | 100-500ms | >500ms |
|
|
52
|
+
| 数据库查询 | <50ms | 50-200ms | >200ms |
|
|
53
|
+
|
|
54
|
+
### 前端 (Core Web Vitals)
|
|
55
|
+
| 指标 | 良好 | 需改进 | 差 |
|
|
56
|
+
|------|------|--------|-----|
|
|
57
|
+
| LCP | <2.5s | 2.5-4s | >4s |
|
|
58
|
+
| FID | <100ms | 100-300ms | >300ms |
|
|
59
|
+
| CLS | <0.1 | 0.1-0.25 | >0.25 |
|
|
60
|
+
|
|
61
|
+
## 常见优化模式
|
|
62
|
+
**后端**: N+1 查询→批量加载、缺少索引→复合索引、重复计算→缓存、同步阻塞→异步
|
|
63
|
+
**前端**: 大 Bundle→代码分割、频繁重渲染→memo、大列表→虚拟滚动、未优化图片→WebP/懒加载
|
|
64
|
+
|
|
65
|
+
## 关键原则
|
|
66
|
+
1. **先测量后优化** - 没有数据不盲目优化
|
|
67
|
+
2. **性价比优先** - 高影响 + 低难度优先
|
|
68
|
+
3. **不破坏功能** - 优化不能引入 bug
|
|
69
|
+
4. **可观测性** - 添加监控便于持续优化
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 多模型代码审查(根据配置并行),无参数时自动审查 git diff
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
> 调用语法见 `_config.md`
|
|
6
|
+
|
|
7
|
+
## 用法
|
|
8
|
+
`/review [CODE_OR_DESCRIPTION]`
|
|
9
|
+
|
|
10
|
+
## 上下文
|
|
11
|
+
- Arguments: $ARGUMENTS
|
|
12
|
+
- This command triggers multi-model code review based on your configuration.
|
|
13
|
+
- Configured models review simultaneously for comprehensive feedback.
|
|
14
|
+
|
|
15
|
+
## 配置
|
|
16
|
+
**首先读取 `~/.ccg/config.toml` 获取审查模型配置**:
|
|
17
|
+
```toml
|
|
18
|
+
[routing.review]
|
|
19
|
+
models = ["codex", "gemini"] # 用户配置的审查模型列表
|
|
20
|
+
strategy = "parallel" # 始终并行执行
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## 行为
|
|
24
|
+
- **No arguments**: Automatically review current git changes (staged + unstaged)
|
|
25
|
+
- **With arguments**: Review specified code or description
|
|
26
|
+
|
|
27
|
+
## 你的角色
|
|
28
|
+
You are the **Code Review Coordinator** orchestrating multi-model review. You direct:
|
|
29
|
+
1. **ace-tool** – for retrieving code context
|
|
30
|
+
2. **Configured Review Models** – for comprehensive code review
|
|
31
|
+
3. **Claude (Self)** – for synthesizing feedback and recommendations
|
|
32
|
+
|
|
33
|
+
## 流程
|
|
34
|
+
|
|
35
|
+
### Step 1: 读取配置 + 获取待审查代码
|
|
36
|
+
|
|
37
|
+
1. **读取 `~/.ccg/config.toml`** 获取 `routing.review.models`
|
|
38
|
+
2. 如果配置不存在,默认使用 `["codex", "gemini"]`
|
|
39
|
+
|
|
40
|
+
**If no arguments provided**, run git commands to get current changes:
|
|
41
|
+
```bash
|
|
42
|
+
# Get staged and unstaged changes
|
|
43
|
+
git diff HEAD
|
|
44
|
+
git status --short
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
**If arguments provided**, use the specified code/description.
|
|
48
|
+
|
|
49
|
+
Then call `mcp__ace-tool__search_context` to get related context.
|
|
50
|
+
|
|
51
|
+
### Step 2: 并行审查
|
|
52
|
+
|
|
53
|
+
**并行调用所有配置的审查模型**(使用 `run_in_background: true` 非阻塞执行):
|
|
54
|
+
|
|
55
|
+
遍历 `routing.review.models`,为每个模型发送调用:
|
|
56
|
+
- 使用 `reviewer` 角色
|
|
57
|
+
- 输出: `Review comments only. No code modifications.`
|
|
58
|
+
|
|
59
|
+
### Step 3: 综合反馈
|
|
60
|
+
使用 `TaskOutput` 获取所有任务的结果,然后:
|
|
61
|
+
1. Collect feedback from all configured models
|
|
62
|
+
2. Categorize by severity (Critical, Major, Minor, Suggestion)
|
|
63
|
+
3. Remove duplicate concerns
|
|
64
|
+
4. Cross-validate findings across models
|
|
65
|
+
5. Prioritize actionable items
|
|
66
|
+
|
|
67
|
+
### Step 4: 呈现审查结果
|
|
68
|
+
Provide unified review report to user with recommendations.
|
|
69
|
+
|
|
70
|
+
## 输出格式
|
|
71
|
+
1. **Configuration** – models used for review
|
|
72
|
+
2. **Review Summary** – overall assessment
|
|
73
|
+
3. **Critical Issues** – must fix before merge
|
|
74
|
+
4. **Major Issues** – should fix
|
|
75
|
+
5. **Minor Issues** – nice to fix
|
|
76
|
+
6. **Suggestions** – optional improvements
|
|
77
|
+
7. **Recommended Actions** – prioritized fix list
|
|
78
|
+
|
|
79
|
+
## 注意事项
|
|
80
|
+
- **首先读取 `~/.ccg/config.toml` 获取审查模型配置**
|
|
81
|
+
- **No arguments** = auto-review git changes (`git diff HEAD`)
|
|
82
|
+
- **With arguments** = review specified content
|
|
83
|
+
- **Use `run_in_background: true` for parallel execution** to avoid blocking
|
|
84
|
+
- 多模型结果交叉验证,综合反馈
|
|
85
|
+
- Use HEREDOC syntax (`<<'EOF'`) to avoid shell escaping issues
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 交互式回滚 Git 分支到历史版本;列分支、列版本、二次确认后执行 reset / revert
|
|
3
|
+
allowed-tools: Read(**), Exec(git fetch, git branch, git tag, git log, git reflog, git checkout, git reset, git revert, git switch), Write()
|
|
4
|
+
argument-hint: [--branch <branch>] [--target <rev>] [--mode reset|revert] [--depth <n>] [--dry-run] [--yes]
|
|
5
|
+
# examples:
|
|
6
|
+
# - /git-rollback # 全交互模式,dry‑run
|
|
7
|
+
# - /git-rollback --branch dev # 直接选 dev,其他交互
|
|
8
|
+
# - /git-rollback --branch dev --target v1.2.0 --mode reset --yes
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Claude Command: Git Rollback
|
|
12
|
+
|
|
13
|
+
**目的**:安全、可视地将指定分支回滚到旧版本。
|
|
14
|
+
默认处于 **只读预览 (`--dry-run`)**;真正执行需加 `--yes` 或在交互中确认。
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# 纯交互:列出分支 → 选分支 → 列最近 20 个版本 → 选目标 → 选择 reset 或 revert → 二次确认
|
|
22
|
+
/git-rollback
|
|
23
|
+
|
|
24
|
+
# 指定分支,其他交互
|
|
25
|
+
/git-rollback --branch feature/calculator
|
|
26
|
+
|
|
27
|
+
# 指定分支与目标 commit,并用 hard‑reset 一键执行(危险)
|
|
28
|
+
/git-rollback --branch main --target 1a2b3c4d --mode reset --yes
|
|
29
|
+
|
|
30
|
+
# 只想生成 revert 提交(非破坏式回滚),预览即可
|
|
31
|
+
/git-rollback --branch release/v2.1 --target v2.0.5 --mode revert --dry-run
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Options
|
|
35
|
+
|
|
36
|
+
| 选项 | 说明 |
|
|
37
|
+
| ---------------------- | ---------------------------------------------------------------------------------- |
|
|
38
|
+
| `--branch <branch>` | 要回滚的分支;缺省时交互选择。 |
|
|
39
|
+
| `--target <rev>` | 目标版本(commit Hash、Tag、reflog 引用都行);缺省时交互选择近 `--depth` 条记录。 |
|
|
40
|
+
| `--mode reset\|revert` | `reset`:硬回滚历史;`revert`:生成反向提交保持历史完整。默认询问。 |
|
|
41
|
+
| `--depth <n>` | 在交互模式下列出最近 n 个版本(默认 20)。 |
|
|
42
|
+
| `--dry-run` | **默认开启**,只预览即将执行的命令。 |
|
|
43
|
+
| `--yes` | 跳过所有确认直接执行,适合 CI/CD 脚本。 |
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 交互流程
|
|
48
|
+
|
|
49
|
+
1. **同步远端** → `git fetch --all --prune`
|
|
50
|
+
2. **列分支** → `git branch -a`(本地+远端,过滤受保护分支)
|
|
51
|
+
3. **选分支** → 用户输入或传参
|
|
52
|
+
4. **列版本** → `git log --oneline -n <depth>` + `git tag --merged` + `git reflog -n <depth>`
|
|
53
|
+
5. **选目标** → 用户输入 commit hash / tag
|
|
54
|
+
6. **选模式** → `reset` 或 `revert`
|
|
55
|
+
7. **最终确认** (除非 `--yes`)
|
|
56
|
+
8. **执行回滚**
|
|
57
|
+
- `reset`:`git switch <branch> && git reset --hard <target>`
|
|
58
|
+
- `revert`:`git switch <branch> && git revert --no-edit <target>..HEAD`
|
|
59
|
+
9. **推送建议** → 提示是否 `git push --force-with-lease`(reset)或普通 `git push`(revert)
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 安全护栏
|
|
64
|
+
|
|
65
|
+
- **备份**:执行前自动在 reflog 中记录当前 HEAD,可用 `git switch -c backup/<timestamp>` 恢复。
|
|
66
|
+
- **保护分支**:如检测到 `main` / `master` / `production` 等受保护分支且开启 `reset` 模式,将要求额外确认。
|
|
67
|
+
- **--dry-run 默认开启**:防止误操作。
|
|
68
|
+
- **--force 禁止**:不提供 `--force`;如需强推,请手动输入 `git push --force-with-lease`。
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## 适用场景示例
|
|
73
|
+
|
|
74
|
+
| 场景 | 调用示例 |
|
|
75
|
+
| ----------------------------------------------- | ---------------------------------------------------------------- |
|
|
76
|
+
| 热修补丁上线后发现 bug,需要回到 Tag `v1.2.0` | `/git-rollback --branch release/v1 --target v1.2.0 --mode reset` |
|
|
77
|
+
| 运维同事误推了 debug 日志提交,需要生成反向提交 | `/git-rollback --branch main --target 3f2e7c9 --mode revert` |
|
|
78
|
+
| 调研历史 bug,引导新人浏览分支历史 | `/git-rollback` (全交互,dry‑run) |
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 注意
|
|
83
|
+
|
|
84
|
+
1. **reset vs revert**
|
|
85
|
+
- **reset** 会改变历史,需要强推并可能影响其他协作者,谨慎使用。
|
|
86
|
+
- **revert** 更安全,生成新提交保留历史,但会增加一次记录。
|
|
87
|
+
2. **嵌入式仓库** 常有大体积二进制文件;回滚前请确保 LFS/子模块状态一致。
|
|
88
|
+
3. 若仓库启用了 CI 强制校验,回滚后可能自动触发流水线;确认管控策略以免误部署旧版本。
|
|
89
|
+
|
|
90
|
+
---
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 多模型测试生成(Codex 后端测试 + Gemini 前端测试)
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
> 调用语法见 `_config.md`
|
|
6
|
+
|
|
7
|
+
## 用法
|
|
8
|
+
`/test <测试目标>`
|
|
9
|
+
|
|
10
|
+
## 上下文
|
|
11
|
+
- 测试目标: $ARGUMENTS
|
|
12
|
+
- Codex 生成后端测试,Gemini 生成前端测试
|
|
13
|
+
|
|
14
|
+
## 流程
|
|
15
|
+
|
|
16
|
+
### Phase 1: 测试分析
|
|
17
|
+
1. 调用 `mcp__ace-tool__search_context` 检索:
|
|
18
|
+
- 目标代码的完整实现
|
|
19
|
+
- 现有测试文件和测试框架
|
|
20
|
+
- 项目测试配置(jest.config, pytest.ini 等)
|
|
21
|
+
2. 识别代码类型:前端组件 / 后端逻辑 / 全栈
|
|
22
|
+
3. 评估当前测试覆盖率和缺口
|
|
23
|
+
|
|
24
|
+
### Phase 2: 智能路由测试生成
|
|
25
|
+
| 代码类型 | 路由 | 角色 |
|
|
26
|
+
|---------|------|------|
|
|
27
|
+
| 后端 | Codex | `tester` |
|
|
28
|
+
| 前端 | Gemini | `tester` |
|
|
29
|
+
| 全栈 | 并行执行 | 两者 |
|
|
30
|
+
|
|
31
|
+
输出: `Unified Diff Patch for test files ONLY`
|
|
32
|
+
|
|
33
|
+
### Phase 3: 测试整合
|
|
34
|
+
1. 收集模型输出(`TaskOutput`)
|
|
35
|
+
2. Claude 重构:统一风格、确保命名一致、优化结构、移除冗余
|
|
36
|
+
|
|
37
|
+
### Phase 4: 测试验证
|
|
38
|
+
1. 运行生成的测试
|
|
39
|
+
2. 检查通过率
|
|
40
|
+
3. 如有失败,分析原因并修复
|
|
41
|
+
|
|
42
|
+
## 测试策略金字塔
|
|
43
|
+
```
|
|
44
|
+
/\ E2E (10%)
|
|
45
|
+
/--\ Integration (20%)
|
|
46
|
+
/----\ Unit (70%)
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## 关键原则
|
|
50
|
+
1. **测试行为,不测试实现** - 关注输入输出
|
|
51
|
+
2. **智能路由** - 后端测试用 Codex,前端测试用 Gemini
|
|
52
|
+
3. **复用现有模式** - 遵循项目已有的测试风格
|
|
53
|
+
4. **覆盖优先级** - 先覆盖关键路径和高风险代码
|