ccg-workflow 3.0.2 → 3.0.3

package/README.md

@@ -12,8 +12,9 @@
 [![Tests](https://img.shields.io/badge/Tests-139%20passed-brightgreen.svg)]()
 [![Follow on X](https://img.shields.io/badge/X-@CCG__Workflow-black?logo=x&logoColor=white)](https://x.com/CCG_Workflow)
 ![star](https://atomgit.com/fengshao1227/ccg-workflow/star/badge.svg)
+[![Docs](https://img.shields.io/badge/Docs-ccg.fengshao1227.com-blue?style=for-the-badge&logo=readthedocs&logoColor=white)](https://ccg.fengshao1227.com/)
 
-[简体中文](./README.zh-CN.md) | English
+[简体中文](./README.zh-CN.md) | English | [**Documentation**](https://ccg.fengshao1227.com/)
 
 </div>
 
@@ -249,4 +250,4 @@ MIT
 
 ---
 
-v3.0.2 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)
+v3.0.3 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)

package/README.zh-CN.md

@@ -13,8 +13,9 @@
 [![Tests](https://img.shields.io/badge/Tests-139%20passed-brightgreen.svg)]()
 [![Follow on X](https://img.shields.io/badge/X-@CCG__Workflow-black?logo=x&logoColor=white)](https://x.com/CCG_Workflow)
 ![star](https://atomgit.com/fengshao1227/ccg-workflow/star/badge.svg)
+[![Docs](https://img.shields.io/badge/文档站-ccg.fengshao1227.com-blue?style=for-the-badge&logo=readthedocs&logoColor=white)](https://ccg.fengshao1227.com/)
 
-[简体中文](./README.zh-CN.md) | English
+[简体中文](./README.zh-CN.md) | English | [**完整文档**](https://ccg.fengshao1227.com/)
 
 </div>
 
@@ -244,4 +245,4 @@ MIT
 
 ---
 
-v3.0.2 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)
+v3.0.3 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.CGOOq1xo.mjs';
+import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.DxKAcBrr.mjs';
 import 'inquirer';
 import 'ora';
 import 'node:child_process';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.CGOOq1xo.mjs';
+export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.DxKAcBrr.mjs';
 import 'ansis';
 import 'inquirer';
 import 'ora';

package/dist/shared/{ccg-workflow.CGOOq1xo.mjs → ccg-workflow.DxKAcBrr.mjs}

@@ -10,7 +10,7 @@ import fs from 'fs-extra';
 import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 
-const version = "3.0.2";
+const version = "3.0.3";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/engine/model-router.md

@@ -46,8 +46,14 @@ Read ~/.claude/.ccg/config.toml
 | 不确定 | 双模型并行 | 各用对应 debugger |
 
 ### 实施阶段
-- 外部模型**仅提供建议**，Claude 执行所有文件修改
-- 外部模型有**零文件写入权限**
+
+**默认模式**（Claude 执行）：
+- 外部模型仅提供建议，Claude 执行所有文件修改
+
+**Codex Builder 模式**（用户选择时）：
+- backend 模型 + `$BACKEND/builder.md` — **有完整写权限**，直接写代码到文件系统
+- Claude 监控进度，审查产出，必要时接管
+- 适用于 M-L 复杂度、低中风险的明确实施任务
 
 ## 3. 调用模板
 
@@ -71,7 +77,7 @@ Bash({
 
 变量说明：
 - `$MODEL` — 选定的模型名（`codex` / `gemini` / `claude`）
-- `$ROLE` — 角色文件名（`analyzer` / `architect` / `reviewer` / `debugger` / `optimizer` / `tester`）
+- `$ROLE` — 角色文件名（`analyzer` / `architect` / `reviewer` / `debugger` / `optimizer` / `tester` / `builder`）
 - `$TASK_CONTENT` — 任务内容（需求 + 上下文）
 - `$OUTPUT_FORMAT` — 期望输出格式
 - `$SHORT_DESCRIPTION` — 简短描述（用于进度显示）

package/templates/engine/strategies/full-collaborate.md

@@ -136,19 +136,31 @@ TaskOutput({ task_id: "$FRONTEND_TASK_ID", block: true, timeout: 600000 })
   nextAction → "等待用户审批计划"
 ```
 
-**⛔ HARD STOP**：展示完整计划，并告知用户：
+**⛔ HARD STOP**：展示完整计划，并询问用户选择执行模式：
+
 ```
-审批后将使用 Agent Teams 并行实施（多个 Builder 同时写代码）。
+⛔ 计划审批 + 执行模式选择
+
+请审批以上计划，并选择谁来写代码：
+  [1] Agent Teams（Claude Builders 并行写，多文件同时进行）
+  [2] Codex（Codex 写代码，更快更便宜，Claude 监控审查）
 ```
-等待用户明确审批。未审批不可进入 Phase 4。
+
+等待用户明确审批 + 选择。未审批不可进入 Phase 4。
 
 用户确认后：`task.json: gate → null`
 
-### Phase 4: 实施（Agent Teams 并行）
+### Phase 4: 实施
 
 `[模式：执行]`
 
-**Gate check**: 用户已审批计划
+**Gate check**: 用户已审批计划 + 选择了执行模式
+
+根据用户选择的执行模式执行：
+
+---
+
+#### 模式 A: Agent Teams 并行（用户选 [1]）
 
 **⛔⛔⛔ 你的第一个动作必须是 TeamCreate。不是 Write，不是 Bash，不是 Read，是 TeamCreate。⛔⛔⛔**
 
@@ -225,6 +237,37 @@ SendMessage({ to: "reviewer", message: { type: "shutdown_request" } })
 2. 按 plan.md 中的 Layer 顺序逐文件实施
 3. 仍然遵守质量关卡
 
+---
+
+#### 模式 B: Codex 实施（用户选 [2]）
+
+**Task 更新**：`currentPhase → "4-implementation"`, `nextAction → "Codex Builder 执行 plan"`
+
+Claude 作为主导者，调用 Codex 写代码：
+
+**Step 1**: 将 plan.md 转为 Codex 可执行的任务描述（包含具体文件路径、变更说明、验证命令）
+
+**Step 2**: 调用 codeagent-wrapper + builder 角色：
+
+```
+Bash({
+  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--progress --backend codex {{GEMINI_MODEL_FLAG}}- \"$WORKDIR\" <<'CODEAGENT_EOF'\nROLE_FILE: ~/.claude/.ccg/prompts/codex/builder.md\n<TASK>\n按以下计划实施，逐个任务完成并验证。\n\n{plan.md 完整内容，包含文件路径、具体变更、验证命令}\n</TASK>\nOUTPUT: Execution Report (每个 task 的 PASS/FAIL + 变更文件列表)\nCODEAGENT_EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "Codex Builder: 执行实施计划"
+})
+```
+
+**Step 3**: 等待 Codex 完成，读取执行报告
+
+**Step 4**: Claude 审查产出：
+1. `git diff` 检查所有变更
+2. 确认变更在 plan 范围内（scope check）
+3. 如有小问题（<10 行）→ Claude 直接修复
+4. 如有大问题 → 再次调用 Codex 修复，或切换到 Claude 自己写
+
+**降级**：如果 Codex 返回错误或超时 → 告知用户 "Codex 执行失败，切换到 Agent Teams" → 按模式 A 执行
+
 ### Phase 5: 迭代审查 [required · Ralph Loop]
 
 `[模式：优化]`

package/templates/engine/strategies/guided-develop.md

@@ -145,7 +145,17 @@ TaskOutput({ task_id: "<id>", block: true, timeout: 600000 })
   nextAction → "等待用户审批计划"
 ```
 
-**⛔ HARD STOP**：展示计划，等待用户确认后才能进入 Phase 5。
+**⛔ HARD STOP**：展示计划，并询问用户选择执行模式：
+
+```
+⛔ 计划审批 + 执行模式选择
+
+请审批以上计划，并选择谁来写代码：
+  [1] Claude 自己写（精细控制，逐步实施）
+  [2] Codex（Codex 写代码，更快更便宜，Claude 监控审查）
+```
+
+等待用户明确审批 + 选择。
 
 用户确认后：
 ```
@@ -154,11 +164,27 @@ TaskOutput({ task_id: "<id>", block: true, timeout: 600000 })
 
 ### Phase 5: 实施
 
+根据用户选择的执行模式：
+
+#### 模式 A: Claude 自己写（用户选 [1]）
+
 1. 严格按计划执行
 2. 遵循项目现有代码规范
 3. 每完成一个主要步骤，简要报告进度
 4. 遇到计划外的问题时告知用户，不自行扩大范围
 
+#### 模式 B: Codex 实施（用户选 [2]）
+
+Claude 作为主导者调用 Codex 写代码：
+
+1. 将 plan.md 转为 Codex 可执行的任务描述
+2. 调用 codeagent-wrapper + builder 角色（参考 model-router.md 调用模板，`$ROLE = builder`）
+3. 等待 Codex 完成，读取执行报告
+4. `git diff` 审查产出，确认在 plan 范围内
+5. 小问题 Claude 直接修复，大问题再调 Codex 或切换模式 A
+
+**降级**：Codex 失败/超时 → 切换到模式 A
+
 **Task 更新**：`currentPhase → "5-implement"`, `nextAction → "按计划执行实施"`
 
 ### Phase 6: 迭代审查 [Ralph Loop]

package/templates/prompts/codex/builder.md

@@ -0,0 +1,61 @@
+# Codex Role: Builder (Implementation Agent)
+
+> For: /ccg:go strategies Phase 4/5 (execution), when user selects Codex as executor
+
+You are an implementation engineer. Claude has already planned the work — your job is to **write the code** exactly as specified in the plan.
+
+## PERMISSIONS
+
+- **FULL file system write permission** - You CAN and SHOULD create/modify/delete files
+- **FULL shell access** - You CAN run tests, linters, build commands
+- You operate in the project working directory provided
+
+## Execution Rules
+
+1. **Read context first** — Before writing, read all files referenced in the plan to understand existing patterns
+2. **Follow the plan exactly** — Do not add features, refactor, or "improve" things not in the plan
+3. **One task at a time** — Complete each task fully before moving to the next
+4. **Validate after each task** — Run the specified test/lint command after each change
+5. **Fix validation failures** — If a test fails after your change, fix it (max 3 attempts per task)
+6. **Stay in scope** — Only modify files listed in the plan. If you discover a necessary change outside scope, note it in your output but do NOT make it
+7. **Report progress** — After each task, output a status line
+
+## Output Format
+
+After completing all tasks, output a summary:
+
+```
+## Execution Report
+
+### Task 1: [description]
+- Status: PASS / FAIL
+- Files changed: [list]
+- Validation: [command] → [pass/fail]
+
+### Task 2: [description]
+- Status: PASS / FAIL
+- Files changed: [list]
+- Validation: [command] → [pass/fail]
+
+---
+OVERALL: [PASS/FAIL]
+Total files changed: [N]
+All validations passed: [yes/no]
+```
+
+## What NOT to Do
+
+- ❌ Do NOT refactor code outside the plan scope
+- ❌ Do NOT add comments explaining your changes
+- ❌ Do NOT install new dependencies unless the plan explicitly says to
+- ❌ Do NOT modify test files unless the plan explicitly includes them
+- ❌ Do NOT ask questions — if the plan is ambiguous, make the simplest choice that satisfies the spec
+
+## .context Awareness
+
+If the project has a `.context/` directory:
+1. Read `.context/prefs/coding-style.md` before writing code — follow those conventions
+2. Follow all coding conventions defined in prefs/
+
+If the project has `.ccg/spec/`:
+1. Read relevant spec files — follow those coding standards