# claude-codex-workflow

**Repository Path**: scedm/claude-codex-workflow

## Basic Information

- **Project Name**: claude-codex-workflow
- **Description**: Claude-Codex Workflow  一个 Bash 编排工具，协调 Claude Code 和 Codex CLI 交替执行的 4 步流水线：PLAN (Claude) → QA REVIEW (Codex) → IMPLEMENT (Clau
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-06
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cross-model-workflow

跨模型 AI 编排工具，协调 **Claude Code** 和 **Codex CLI** 交替执行的 4 步流水线：

```
PLAN (Claude) → QA REVIEW (Codex) → IMPLEMENT (Claude) → VERIFY (Codex)
```

跨模型模式让每个 AI 的输出都由另一个模型审查，减少单一模型的盲点。

![workflow](docs/diagrams/workflow-flat-icon.svg)

## 前置条件

```bash
# 检查依赖是否已安装
which claude npx jq

# 缺少时安装：
#   claude  — https://docs.anthropic.com/en/docs/claude-code
#   npx     — 随 Node.js 安装 (https://nodejs.org)
#   jq      — macOS: brew install jq / Linux: apt install jq
```

## 快速开始

```bash
# 启动新工作流
./pipeline.sh start add-user-auth

# 查看状态
./pipeline.sh status

# 失败后恢复
./pipeline.sh resume
```

## 命令速查

```bash
./pipeline.sh start <功能名>                     # 交互式规划（Claude 会提问）
./pipeline.sh start <功能名> --non-interactive    # 全自动，无用户交互
./pipeline.sh resume                              # 从下一个未完成步骤继续
./pipeline.sh status                              # 查看各步骤状态
./pipeline.sh step <plan|qa|implement|verify>     # 运行指定步骤
./pipeline.sh step <步骤> --force                 # 强制重跑已完成的步骤
./pipeline.sh start <功能名> --dry-run            # 预览模式，不实际执行
./pipeline.sh reset                               # 清除状态，保留计划文件
./pipeline.sh clean                               # 清除所有文件
```

## 架构

```
pipeline.sh (入口，CLI 参数解析，步骤调度)
  ├── lib/utils.sh    — 日志、依赖检查、名称校验
  ├── lib/state.sh    — state.json 管理、信号文件、步骤生命周期
  └── lib/prompts.sh  — 4 个流水线步骤的提示词模板
```

### 数据流

1. **PLAN** 创建 `plans/<功能名>.md`（分阶段计划，每阶段有相关的任务列表及测试关卡）
2. **QA REVIEW** (Codex) 读取计划，插入 "Codex Finding" 章节 — 只增不改
3. **IMPLEMENT** (Claude) 逐阶段实现到 `build/<功能名>/`，每阶段运行测试关卡
4. **VERIFY** (Codex) 对照计划检查代码库，生成验证报告

## 示例项目

- [matrix-rain/](matrix-rain/) — 黑客帝国数字雨特效（HTML5 Canvas）
- [login-html/](login-html/) — 登录页面（HTML/CSS/JS）

## 测试

```bash
# 运行集成测试（使用 --dry-run，无需安装 claude 或 npx）
bash tests/run_tests.sh
```




## 许可证

MIT License