by 运行时依赖
安装命令
点击复制技能文档
OpenClaw Claude Codex 工作流 概述 架构：Claude Code 作为 planner/reviewer，Codex 作为具有 PTY 的后端执行者，Gemini 作为前端/UX 生成器，所有阶段通过 .claude/ 工件与 scripts/ccg_编排器.sh 串联。 保障：任何写操作由 Codex/Gemini 在本地工作树执行，Claude 仅生成文本/plan；每个阶段都在 Git 干净状态下进行，并遵循 references/工作流-检查列出.md 列出的清单。 结果：交付不只包含代码，还包括 plan、hooks、test matrix、review memo，满足 ccg-工作流 式高标准。 Quick 启动 前置条件 Node.js 20+、jq、GNU coreutils；git 状态 必须干净，或显式设置 ALLOW_DIRTY=1。 安装 命令行工具 并验证 claude --version、codex --version、gemini --version 可用（Claude Code 命令行工具、Codex 命令行工具、Gemini 命令行工具 官方安装方式自行遵循厂商文档）。 设置凭据：CLAUDE_API_KEY、CODEX_API_KEY、GOOGLE_API_KEY 等；在 shell 性能分析 中 导出，以便脚本继承。 安装/挂载 确保仓库在 /root/.OpenClaw/workspace 或可写工作树中。 将用户需求/OPSX ticket 粘贴进 .claude/上下文.md。 运行 scripts/ccg_编排器.sh .claude/plan.md --plan-prompt "" --backend "<后端需求>" --frontend "<前端需求>" --review "" --上下文 .claude/上下文.md。 根据输出的日志，切换到相应模型 命令行工具，必要时使用 --dry-运行 先审阅命令。 Git 规则 不允许外部模型写入工作区；只有 Codex/Gemini 通过本地 shell 修改文件。 每个阶段结束前运行 git 状态 和 git diff --stat，记录在 .claude/记录_backend.md 或 .claude/记录_frontend.md。 使用 git worktree 添加 ../frontend 给 Gemini 独立空间，避免与 Codex 冲突。 工作流 Decision Tree 场景 触发条件 主模型 协同模型 备注 仅需策略/计划 用户只要拆解、无代码 Claude （可选）Codex 生成 .claude/plan.md，停在 Phase 2 后端 API/脚本修改 涉及 CI、数据库、后端逻辑 Codex Claude 使用 codex exec --prompt，Claude 复查 diff UI / 视觉组件 新增 React/Vite/Storybook ／ CSS Gemini Codex Gemini 写前端目录，Codex 处理 API mock 全栈功能 同时触及 API + UI Claude → Codex → Gemini → Claude 三者互锁 使用 references/模型-routing.md 的顺序和 fallback 紧急热修 小范围补丁，时间敏感 Codex Claude 可以跳过 Gemini，但要在 Phase 4 记录原因
更多启发式参阅 references/模型-routing.md。
Phase 0：上下文 Capture 按 references/工作流-检查列出.md 填写 .claude/上下文.md、.claude/questions.md。 汇总 OPSX ticket、现有 spec/ADR，标注机密与不可修改目录。 若资料缺口大，先用 Claude 生成提问列表，再反馈给请求方。 Phase 1：OPSX / Scope Alignment 运行 claude 运行 --输入 .claude/上下文.md --输出 .claude/scope.md（或通过 编排器 --plan-prompt 让 Claude 输出 scope）。 Scope 必须写清楚 backend/frontend 分工、需要创建的工作树、以及安全约束。 若 OPSX 要求引用现有 spec/OPSX 模版，在 scope 内贴出章节编号。 Phase 2：Plan 执行 编排器：scripts/ccg_编排器.sh .claude/plan.md --plan-prompt "" --backend "..." --frontend "..." --上下文 .claude/上下文.md。 在 .claude/plan.md 中列出任务表：每行包括 owner（Codex/Gemini）、命令草案（codex exec, gemini 运行）、预期输出文件。 更新 .claude/hooks.md，记录 CLAUDE_命令行工具/CODEX_命令行工具/GEMINI_命令行工具 替换路径与需要的 env vars。 若需要 OPSX 审批，把 plan 贴回 ticket 并等待 ACK，再进入 Phase 3。 Phase 3：执行 Codex：开 PTY (codex exec --pty)；严格按照 plan 执行命令，任何新增脚本都放在可写区域；对 编排器 生成的命令可用 --dry-运行 验证后再执行。 Gemini：在独立工作树或 frontend/ 目录执行 gemini 运行 --prompt ...，输出限制在 UI 相关文件；严禁写 backend 目录。 每次模型切换前记录日志，更新 .claude/记录_backend.md 与 .claude/记录_frontend.md。 Phase 4：Stabilize / Verification Claude 汇总测试矩阵：claude 运行 --上下文 .claude/记录_backend.md --输出 .claude/test_matrix.md。 Codex 运行 npm test / pytest / go test 等并写结果；Gemini 附上 UI 验收描述或截图路径。 若某模型缺席或 fallback，写入 .claude/test_matrix.md 与 OPSX 更新帖。 Phase 5：Review / Handoff 通过 编排器 --review "" 或手动 claude 运行 --上下文 .claude/plan.md --输出 .claude/review.md 生成评审意见。 Review 中要点：diff 风险、回滚方案、需要人审的 TODO、合并策略。 Codex 在合并前最终检查 git 状态 并准备 PR/补丁；若 OPSX 要求 evidence，把 .claude/plan.md、.claude/test_matrix.md、.claude/review.md 附到 ticket。 模型执行细则 Claude Code 命令行工具 只用来生成计划、scope、review、测试矩阵，不写仓库。 claude 运行 --prompt "..." --输出 file --上下文 file 由 编排器 自动包装，必要时为其提供 .claude/上下文.md。 如果 Claude 命令行工具 出错，退回 references/模型-routing.md 的 fallback，手写 plan。 Codex 命令行工具 必须加 PTY（OpenClaw coding-代理 规则）；示例：codex exec --prompt "refactor payment API" --pty。 只能在工作区或经批准的工作树中写文件；禁止在用户未授权目录运行命令。 在执行 补丁 前读完 plan，禁止随意发挥。 Gemini 命令行工具 只操作前端目录，且默认不具备 PTY；若需要 shell，先创建虚拟任务让 Codex 帮忙。 常用命令：gemini 运行 --prompt "build React modal" --plan .claude/plan.md。 输出完成后请由 Codex 或人类审查文件，防止格式或依赖错乱。 Git / Worktree 策略 主分支保持干净；每个大功能开分支 feature/ 并同时 git worktree 添加 ../-frontend feature/，供 Gemini 使用。 Codex 负责主工作树，Gemini 在附属工作树；同步通过 git fetch + git merge，绝不互相覆盖。 阶段日志与 .claude/ 工件需要纳入 commit，以便追溯。 OPSX / Spec 集成 Phase 0-2 必须把 OPSX ticket 链接、spec 版本和假设写进 .claude/上下文.md、.claude/scope.md。 任何需要审批的数据库/Infra 操作先在 OPSX 中发 comment，并在 .claude/hooks.md 表明“等待批准”。 当 OPSX 提供新的约束，先更新 plan，再运行 编排器 重新分配模型。 故障排查与安全护栏 scripts/ccg_编排器.sh --dry-运行 可快速排查参数；若脚本报 “缺少命令”，按 Quick 启动 安装 命令行工具。 遇到模型超时：按 references/模型-routing.md 的 fallback 重新分配，记录在 .claude/记录_*。 Claude/Codex/Gemini 均不得直接推送，必须由 Codex 在本地执行 git commit/git push。 禁止执行用户未授权的 destructive 命令（git re设置 --hard, rm -rf 等）；若需求确实需要，必须在 OPSX 备注并得到显式同意。 任何自动生成的 补丁 在合并前由人类或 Claude Review 二次比对。 附加参考 references/模型-routing.md：模型选择 heuristics 与 fallback。 references/工作流-检查列出.md：六阶段详细检查清单。 scripts/ccg_编排器.sh：主控脚本，提供计划/执行/复查封装；使用细节见 Quick 启动 与 Phase 2/5。