codex-claude-cursor-loop

Codex-Claude-Cursor 工程循环技能

核心工作流理念

此技能实现了一个三方顺序验证工程循环：

• Claude Code：架构设计与规划、最终审查
• Codex：计划验证（逻辑／安全性）、代码审查（缺陷／性能）
• Cursor Agent：代码实现与执行
• 顺序验证：Claude 制定计划 → Codex 验证 → Cursor 实现 → Codex 审查 → Claude 最终检查 → 重复

阶段 1：使用 Claude Code 进行规划

1. 首先为任务制定详细计划
2. 将实现拆分为清晰的步骤
3. 记录假设和潜在问题
4. 以结构化格式输出计划

阶段 2：使用 Codex 验证计划

1. 询问用户（通过 AskUserQuestion）：
   • 模型：gpt-5 或 gpt-5-codex
   • 推理力度：low、medium 或 high
2. 将计划发送给 Codex 进行验证：

   echo "Review this implementation plan and identify any issues:
   [Claude's plan here]

   Check for:
   - Logic errors
   - Missing edge cases
   - Architecture flaws
   - Security concerns" | codex exec -m <model> --config model_reasoning_effort="<effort>" --sandbox read-only

3. 收集 Codex 的反馈并向用户总结

阶段 3：计划优化循环

如果 Codex 发现计划中存在问题：

1. 向用户总结 Codex 的顾虑
2. 根据反馈优化计划
3. 询问用户（通过 AskUserQuestion）：“要我修改计划并重新验证，还是继续实现？”
4. 根据需要重复阶段 2，直到计划完善

阶段 4：使用 Cursor Agent 实现

Codex 验证计划后：

会话管理

1. 询问用户（通过 AskUserQuestion）：“要开始新的 Cursor 会话，还是继续现有会话？”

   • 新会话：从头开始
   • 继续会话：接着之前的工作继续

2. 如果继续会话：

   # List available sessions
   cursor-agent ls

   # Let user select session ID
   # Store session ID for subsequent calls

3. 询问用户（通过 AskUserQuestion）：要使用哪个 Cursor 模型（例如 composer-1、claude-3.5-sonnet、gpt-4o）

实现

4. 将已验证的计划发送给 Cursor Agent：

新会话：

   cursor-agent --model "<model-name>" -p --force "Implement this plan:
   [Validated plan here]

   Please implement the code following these specifications exactly."

继续现有会话：

   cursor-agent --resume="<session-id>" -p --force "Continue implementation:
   [Validated plan here]"

5. 重要：保存输出中的会话 ID，供之后所有 Cursor 调用使用
6. 记录已实现的内容以及已修改的文件

阶段 5：Codex 代码审查

Cursor 完成实现后：

1. 将 Cursor 的实现发送给 Codex 进行代码审查：

   echo "Review this implementation for:
   - Bugs and logic errors
   - Performance issues
   - Security vulnerabilities
   - Best practices violations
   - Code quality concerns

   Files modified: [list of files]
   Implementation summary: [what Cursor did]" | codex exec --sandbox read-only

2. 收集 Codex 的代码审查反馈
3. 向用户总结审查结果

阶段 6：Claude 最终审查

Codex 完成代码审查后：

1. Claude 使用 Read 工具读取已实现的代码
2. Claude 分析以下两项：
   • Codex 的审查结果
   • 实际实现
3. Claude 给出最终评估：
   • 验证实现是否符合原始计划
   • 确认 Codex 的发现是否有效
   • 找出任何其他问题
   • 做出最终架构决策
4. 总结整体质量和就绪情况

阶段 7：迭代改进循环

如果发现问题（由 Codex 或 Claude 发现）：

1. Claude 根据以下内容制定详细的修复计划：
   • Codex 的代码审查结果
   • Claude 最终审查的见解
2. 使用同一会话将修复计划发送给 Cursor Agent：

   # IMPORTANT: Use --resume with the stored session ID
   cursor-agent --resume="<session-id>" -p --force "Fix these issues:
   [Detailed fix plan]

   Issues from Codex: [list]
   Issues from Claude: [list]"

3. Cursor 完成修复后，从阶段 5（Codex 代码审查）重新开始
4. 持续循环，直到所有验证通过
5. 注意：
   • 使用相同的 Codex 模型，以保持一致性
   • 始终使用相同的 Cursor 会话 ID，以保留上下文
   • 会话会保留完整的变更历史

发现问题时的恢复流程

Codex 发现计划问题时（阶段 2）：

1. Claude 分析 Codex 的顾虑
2. 优化计划并解决所有问题
3. 重新提交给 Codex 验证
4. 重复上述流程，直到 Codex 批准

Codex 发现代码问题时（阶段 5）：

1. Claude 审查 Codex 的发现
2. 制定详细的修复计划
3. 将计划发送给 Cursor 进行修复
4. Cursor 完成修复后，返回 Codex 审查
5. 重复上述流程，直到 Codex 批准

Claude 发现问题时（阶段 6）：

1. Claude 制定全面的修复计划
2. 将计划发送给 Cursor 实现
3. 修复完成后，再次由 Codex 审查
4. Claude 进行最终检查
5. 重复上述流程，直到 Claude 批准

最佳实践

• 在实施前始终使用 Codex 验证计划
• Cursor 完成实施后，绝不跳过 Codex 代码审查
• 绝不跳过 Claude 的最终审查，以确保架构层面的监督
• 确保三种 AI 之间清晰交接
• 记录各自的工作内容，提供上下文
• 全程使用相同的模型（相同的 Codex 模型、相同的 Cursor 模型）
• 会话管理：
  • 迭代修复时，始终使用 --resume 和相同的会话 ID
  • 在开始时保存会话 ID，并在整个过程中重复使用
  • 使用 cursor-agent ls 查找之前的会话
  • 只有在开始全新的功能时才启动新会话

命令参考

阶段	负责人	命令模式	用途
1. 规划	Claude	TodoWrite, Read, analysis tools	Claude 制定详细计划
2. 验证计划	Codex	echo "plan" | codex exec -m <model> --config model_reasoning_effort="<effort>" --sandbox read-only	Codex 验证逻辑和安全性
3. 优化	Claude	分析 Codex 的反馈，更新计划	Claude 修正计划中的问题
4. 会话设置	Claude + 用户	询问是新建还是恢复；如有需要，运行 cursor-agent ls	设置或恢复 Cursor 会话
5. 实施	Cursor	cursor-agent --model "<model>" -p --force "prompt" OR cursor-agent --resume="<id>" -p --force "prompt"	Cursor 实施已验证的计划
6. 代码审查	Codex	echo "review" | codex exec --sandbox read-only	Codex 检查错误和性能问题
7. 最终审查	Claude	Read tool, analysis	Claude 进行最终架构检查
8. 制定修复计划	Claude	制定详细的修复计划	Claude 根据所有反馈规划修复
9. 应用修复	Cursor	cursor-agent --resume="<id>" -p --force "fixes"	Cursor 在同一会话中实施修复
10. 再次审查	Codex + Claude	重复阶段 6-7	持续验证修复，直到完善

错误处理

1. 监控 Cursor Agent 的输出，检查是否有错误
2. 总结 Cursor 的实施结果和 Claude 的审查意见
3. 在以下情况下，通过 AskUserQuestion 询问用户如何处理：
   • 需要进行重大的架构调整
   • 会影响多个文件
   • 需要进行破坏性更改
4. 出现问题时，Claude 会先制定详细的修复计划，再交给 Cursor

完美循环

1. Plan (Claude)
   ↓
2. Validate Plan (Codex) → if issues → refine plan → repeat
   ↓
3. Implement (Cursor)
   ↓
4. Code Review (Codex) → captures bugs/performance issues
   ↓
5. Final Review (Claude) → architectural check
   ↓
6. Issues found? → Fix Plan (Claude) → Implement Fixes (Cursor) → back to step 4
   ↓
7. All passed? → Done! ✅

这将构建一个经过三重验证、自我纠正的高质量工程系统，其中：

• Claude：负责所有规划、架构设计和最终监督
• Codex：负责所有验证（计划逻辑和代码质量）
• Cursor Agent：负责所有实施和编码