ccg-workflow/templates/commands/code.md

description

description
三模型代码生成（Codex + Gemini + Claude 并行原型，集各家所长）

调用语法见 _config.md

用法

/code <功能描述>

上下文

• 功能描述: $ARGUMENTS
• 三模型并行生成原型，编排者集各家所长
• 生成的原型经 Claude (编排者) 重构为生产级代码

工作流程

Phase 1: 需求分析

1. 调用 mcp__ace-tool__search_context 检索:
   • project_root_path: 项目根目录绝对路径
   • query: 功能需求的自然语言描述
   • 相关模块和文件结构
   • 现有代码模式和风格
   • 依赖和接口定义
2. 分析任务类型：
   • 前端: UI 组件、样式、用户交互
   • 后端: API、业务逻辑、数据库操作
   • 全栈: 同时涉及前后端

Phase 2: 三模型并行原型生成

同时调用三个模型（run_in_background: true）：

调用方式: 使用 Bash 工具调用 codeagent-wrapper

# Codex 后端架构原型
codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
ROLE_FILE: ~/.claude/prompts/ccg/codex/architect.md

<TASK>
生成原型: {{功能需求}}
Context: {{从 ace-tool 获取的相关代码}}
</TASK>

OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
EOF

# Gemini 前端 UI 原型
codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
ROLE_FILE: ~/.claude/prompts/ccg/gemini/frontend.md

<TASK>
生成原型: {{功能需求}}
Context: {{从 ace-tool 获取的相关代码}}
</TASK>

OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
EOF

# Claude 全栈整合原型
codeagent-wrapper --backend claude - $PROJECT_DIR <<'EOF'
ROLE_FILE: ~/.claude/prompts/ccg/claude/architect.md

<TASK>
生成原型: {{功能需求}}
Context: {{从 ace-tool 获取的相关代码}}
</TASK>

OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.
EOF

1. Codex + architect 角色 → 后端架构视角
2. Gemini + frontend 角色 → 前端 UI 视角
3. Claude + architect 角色 → 全栈整合视角

三模型差异化价值：

模型	专注点	独特贡献
Codex	后端逻辑、算法、API	深度后端专业知识
Gemini	前端 UI、样式、交互	视觉设计和用户体验
Claude	全栈整合、契约设计	桥接前后端视角

定义清晰的接口契约：

API Contract:
- Endpoint: POST /api/xxx
- Request: { field1: string, field2: number }
- Response: { data: T, error?: string }

Phase 3: 原型整合

1. 收集三个模型输出（使用 TaskOutput）
2. 将 Unified Diff 视为"脏原型"
3. 交叉验证，集各家所长：
   • Codex 的后端逻辑和 API 设计
   • Gemini 的前端组件和 UI 交互
   • Claude 的整合视角和契约一致性
4. Claude (编排者) 重构：
   • 统一代码风格
   • 确保前后端接口一致
   • 优化实现细节
   • 移除冗余代码

Phase 4: 代码实施

1. 应用重构后的代码
2. 确保不破坏现有功能
3. 验证编译/类型检查通过

Phase 5: 三模型审查

并行启动审查（run_in_background: true）：

调用方式: 使用 Bash 工具调用 codeagent-wrapper

# Codex 安全性审查
codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
ROLE_FILE: ~/.claude/prompts/ccg/codex/reviewer.md

<TASK>
审查代码: {{实施的代码变更}}
关注点: 安全性、性能、错误处理
</TASK>

OUTPUT: Review comments with specific line references.
EOF

# Gemini 设计审查
codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
ROLE_FILE: ~/.claude/prompts/ccg/gemini/reviewer.md

<TASK>
审查代码: {{实施的代码变更}}
关注点: 可访问性、响应式设计、设计一致性
</TASK>

OUTPUT: Review comments with specific line references.
EOF

# Claude 集成审查
codeagent-wrapper --backend claude - $PROJECT_DIR <<'EOF'
ROLE_FILE: ~/.claude/prompts/ccg/claude/reviewer.md

<TASK>
审查代码: {{实施的代码变更}}
关注点: 集成正确性、契约一致性
</TASK>

OUTPUT: Review comments with specific line references.
EOF

• Codex + reviewer 角色 → 安全性、性能、错误处理
• Gemini + reviewer 角色 → 可访问性、响应式、设计一致性
• Claude + reviewer 角色 → 集成正确性、契约一致性

Phase 6: 修正与交付

1. 综合三模型审查意见
2. 修正发现的问题
3. 最终交付

输出格式

## 🚀 Code: <功能描述>

### Phase 1: 需求分析
- 任务类型: [前端/后端/全栈]
- 相关文件: <文件列表>
- 现有模式: <识别的模式>

### Phase 2: 代码生成
#### Codex 原型 (后端视角)
<Unified Diff 摘要>

#### Gemini 原型 (前端视角)
<Unified Diff 摘要>

#### Claude 原型 (全栈视角)
<Unified Diff 摘要>

### Phase 3: 整合重构
<重构说明>

### Phase 4: 实施
<变更文件列表>

### Phase 5: 审查
#### Codex 审查 (安全/性能)
- <审查意见 1>
- <审查意见 2>

#### Gemini 审查 (可访问性/设计)
- <审查意见 1>
- <审查意见 2>

#### Claude 审查 (集成/契约)
- <审查意见 1>
- <审查意见 2>

### Phase 6: 交付
✅ 实施完成
- 新增文件: X
- 修改文件: Y
- 代码行数: +N / -M

任务类型检测

关键词	类型	路由
component, UI, style, CSS, React, Vue	前端	Gemini
API, endpoint, database, auth, backend	后端	Codex
full-stack, 全栈, 页面+接口	全栈	并行

代码质量标准

前端代码 (Gemini 专注)

• TypeScript 类型完整
• 响应式设计
• 无障碍属性
• 加载/错误状态
• 遵循设计系统

后端代码 (Codex 专注)

• 输入验证
• 错误处理
• 安全检查
• 查询优化
• API 一致性

全栈整合 (Claude 专注)

• 前后端接口一致
• 类型定义共享
• 错误码统一
• 契约文档完整

关键原则

1. 三模型并行 - 同时获取三个视角的原型
2. 集各家所长 - 交叉验证，取最优方案
3. 接口优先 - 先定义 API 契约
4. 编排者重构 - 原型需要 Claude (编排者) 整合
5. 三重审查 - 代码必须经过三模型审查