[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75834":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":12,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":8,"pushedAt":8,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":12,"lastSyncTime":24,"discoverSource":25},75834,"claude-codex-teamwork","UIengF\u002Fclaude-codex-teamwork","UIengF",null,"Python",151,9,2,1,0,40,3,false,"main",true,[],"2026-06-12 02:03:36","# Claude-Codex 对等协作系统\n\n[English](README.en.md)\n\nClaude Code 与 Codex CLI 的对等协作框架。Claude 负责架构设计、代码审查和用户沟通；Codex 负责编码实现、测试调试。通过共享任务板和状态机协议保持同步。\n\n## 更新记录\n\n### 2026-05-13\n- **\u002Fteammate 硬执行规则** — 修复 `\u002Fteammate` 不调用 skill 的问题。CLAUDE.md 新增关键词触发列表和不可跳过的 preflight 检查点。SKILL.md 重写为 STRICT EXECUTION CHECKLIST。\n\n### 2026-05-12\n- **Arena 模式** — 启动多个 Codex 实例，分配动态角色（架构师、批评者、务实者）进行自主辩论；Claude 只审查最终报告\n- **并行协作** — 多个独立 Codex 任务并发执行，支持依赖感知\n- **WebUI 任务板** — 可视化仪表盘，查看任务板历史\n\n完整变更记录见 [CHANGELOG.md](CHANGELOG.md)。\n\n## 安装\n\n### 前置条件\n\n- Python 3.12+\n- 已安装 [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) 和 [Codex CLI](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex)\n\n### 一键安装\n\n```bash\n# 克隆并安装\ngit clone https:\u002F\u002Fgithub.com\u002FUIengF\u002Fclaude-codex-teamwork.git \u002Ftmp\u002Fclaude-codex-teamwork\npython \u002Ftmp\u002Fclaude-codex-teamwork\u002Fscripts\u002Finstall.py\n```\n\n安装脚本会将文件复制到 `~\u002F.claude\u002F`（scripts、prompts、skills、CLAUDE.md）。如果 `settings.json` 不存在，会创建模板文件——请在其中设置你的 API token。\n\n### 验证\n\n```bash\n# P0 启动诊断：检查关键文件、任务板、命令依赖和可写目录\npython ~\u002F.claude\u002Fskills\u002Fteammate\u002Fscripts\u002Fstartup_diagnostics.py\n\n# 运行 teammate 单元测试\ncd ~\u002F.claude\u002Fskills\u002Fteammate\u002Fscripts && python -m pytest -v\n```\n\n### 给 agent 的指引\n\n如果你是一个正在阅读本文档的 agent：克隆仓库，运行 `scripts\u002Finstall.py`，然后阅读 `skills\u002Fteammate\u002FSKILL.md` 获取完整协议。工作流入口是 `scripts\u002Fcodex_workflow.py`，支持 `serial --intent \u003Cimplement|fix|refactor|test|research>`、`parallel`、`max` 和 `arena` 模式。旧命令 `implement`\u002F`fix`\u002F`refactor`\u002F`research`\u002F`test` 仍兼容但会输出 deprecation warning。\n\n## 核心概念\n\n| 概念 | 作用 |\n|------|------|\n| **任务板** | 唯一事实源：目标、任务、通信日志、共享上下文、下一步行动者 |\n| **状态机** | 5 个状态（PLAN → EXECUTE → REVIEW → BLOCKED → PLAN_CHANGE）控制写权限 |\n| **Next Actor** | 防止双写——只有被指定的一方才能修改任务板 |\n| **结构化交接** | 每轮协作必须包含：已完成、待处理、决策、涉及文件 |\n| **咨询通道** | Codex 阻塞时可以向 Claude 提问，Claude 回复后继续执行 |\n\n## 先选模式\n\n| 模式 | 什么时候用 | 工作方式 |\n|------|-----------|---------|\n| **Max** | 大规模重构、深度研究、高风险架构设计 | Claude 与 Codex 并行制定计划（PLAN Phase），对比方案、协商分歧，然后 Codex 逐步执行（Execute Phase）。完整的计划协商循环。 |\n| **串行** | 单任务、修 bug、小重构（默认） | Claude 将单个任务分派给 Codex，审查结果后展示给用户。线性流程。 |\n| **Arena** | 复杂设计决策，需要多角度评估 | Claude 分配动态角色（架构师、批评者、务实者等），启动多个 Codex 实例自主辩论。阻断异议需要证据支持。Claude 审查最终共识报告。 |\n| **并行** | 多个互不冲突的独立子任务 | Claude 将工作拆解为带 `depends_on` 和 `write_scope` 的计划，将独立任务分派给并发 Codex 实例。按拓扑序执行。 |\n\nagent 会根据任务复杂度自动选择模式。你也可以明确指定。\n\n## 架构设计\n\n### 状态机\n\n```mermaid\nstateDiagram-v2\n    [*] --> PLAN\n    PLAN --> EXECUTE\n    PLAN --> BLOCKED\n    EXECUTE --> REVIEW\n    EXECUTE --> BLOCKED\n    EXECUTE --> PLAN_CHANGE\n    REVIEW --> PLAN\n    REVIEW --> EXECUTE\n    REVIEW --> BLOCKED\n    BLOCKED --> PLAN\n    PLAN_CHANGE --> PLAN\n    PLAN_CHANGE --> EXECUTE\n```\n\n各状态写权限：\n\n| 状态 | 任务板 | 步骤 | 工作区 |\n|------|--------|------|--------|\n| PLAN | 双方可写 | 双方可写 | 不可写 |\n| EXECUTE | Claude | Codex | Codex |\n| REVIEW | Claude | 不可写 | 不可写 |\n| BLOCKED | 双方可写 | 不可写 | 不可写 |\n| PLAN_CHANGE | 双方可写 | 不可写 | 不可写 |\n\n### 协作流程\n\n```mermaid\nsequenceDiagram\n    participant U as 用户\n    participant C as Claude\n    participant B as 任务板\n    participant X as Codex\n    U->>C: 提交任务\n    C->>B: 写入计划，设置 Next Actor\n    C->>X: 分派（codex_workflow.py）\n    X->>X: 编码 \u002F 测试 \u002F 调试\n    X->>B: 写入交接，更新状态\n    X-->>C: 阻塞时咨询\n    C-->>X: 回复，继续执行\n    C->>B: 审查结果，设置 Next Actor\n    C->>U: 展示结果\n```\n\n### 辩论模式（Arena）\n\n```mermaid\nsequenceDiagram\n    participant C as Claude\n    participant A1 as 架构师\n    participant A2 as 批评者\n    participant A3 as 务实者\n    C->>A1: 任务 + 角色 prompt\n    C->>A2: 任务 + 角色 prompt\n    C->>A3: 任务 + 角色 prompt\n    A1->>A1: 第 1 轮：立场分析\n    A2->>A2: 第 1 轮：质疑对手\n    A3->>A3: 第 1 轮：务实评估\n    Note over A1,A3: 阶段快照写入\n    A1->>A1: 第 2 轮：修订 + 回应\n    A2->>A2: 第 2 轮：修订 + 回应\n    A3->>A3: 第 2 轮：修订 + 回应\n    Note over C: Coordinator 合并报告\n    C->>C: 审查共识 + 少数意见\n```\n\n## 高级功能\n\n- **Plan JSON** — 用 `task_id`、`template`、`write_scope`、`depends_on` 定义子任务，支持并行调度。\n- **咨询通道** — `check_inbox.py` 读取 Codex 咨询；`respond_codex.py` 回复并恢复执行。\n- **历史查询** — `query_board.py` 按需查询任务板：`--last 5`、`--direction claude`、`--search \"parser\"`。\n- **其他选项** — `--dry-run`（预览 prompt）、`--output`（保存结果）、`--zh`（中文模板）。\n\n## 文件结构\n\n```\nskills\u002Fteammate\u002F           核心协作系统\n  SKILL.md                 协议规范与完整文档\n  scripts\u002F\n    arena.py               多 Agent 辩论（Arena Mode）\n    parallel_scheduler.py  依赖感知的并行调度\n    sync_task_board.py     任务板原子读写\n    state_machine.py       5 状态协议引擎\n    consult_claude.py      Codex→Claude 咨询通道\n    query_board.py         任务板历史查询\n    startup_diagnostics.py P0 启动诊断\n    preflight.py           前置检查点\n  templates\u002F               交接和步骤的 prompt 模板\n\nskills\u002Fcodex\u002F              Codex 端配置\n  SKILL.md                 Codex 行为规范\n  scripts\u002Fask_codex.sh     分派脚本\n\nscripts\u002F                   共享工作流脚本\n  codex_workflow.py        工作流入口（串行 \u002F 并行 \u002F 辩论）\n  compose_prompt.py        Prompt 模板组装\n  check_inbox.py           Inbox 检查\n  respond_codex.py         回复 Codex 咨询\n  file_lock.py             跨平台文件锁\n\nprompts\u002F                   Prompt 模板（implement, fix, refactor, test, research）\n```\n\n## 测试\n\n```bash\ncd skills\u002Fteammate\u002Fscripts && python -m pytest -v\n```\n","Claude-Codex 对等协作系统是一个基于Python的框架，旨在通过Claude和Codex之间的协作提高软件开发效率。该项目利用了Claude在架构设计、代码审查及用户沟通方面的优势与Codex在编码实现、测试调试上的能力，通过共享任务板和状态机协议确保双方同步。它支持多种工作模式，如串行处理单个任务、并行执行独立子任务、Arena模式下的多角度评估以及Max模式的大规模重构或研究，适用于从简单到复杂的各种开发场景。此外，项目提供了详细的安装指南和验证步骤，便于开发者快速上手使用。","2026-06-11 03:53:27","CREATED_QUERY"]