Codex Skill

代码执行的主要方法。Claude负责规划验证，Codex负责实际执行。

核心原则

"First, solve the problem. Then, write the code." — John Johnson

遵循KISS原则：写最少的代码解决问题。

使用场景

• 任何代码编写、修改、删除
• 测试编写和执行（用户要求时）
• 大规模重构
• 文件操作

调用方式

基本调用

codex "任务描述" [工作目录]
codex "重构 @src/auth.ts 添加JWT验证"

HEREDOC语法（推荐复杂任务）

codex - <<'EOF'
实现用户认证模块：
1. 创建登录API端点
2. 添加JWT token生成
3. 实现密码哈希
EOF

并行执行

codex --parallel <<'EOF'
---TASK---
id: backend_api
workdir: /project/backend
---CONTENT---
实现 /api/users 端点

---TASK---
id: frontend_ui
workdir: /project/frontend
dependencies: backend_api
---CONTENT---
创建Users页面
EOF

执行前自检 (Linus审查)

- [ ] 数据结构是最简的吗？
- [ ] 是否有不必要的抽象？
- [ ] 命名准确反映本质？
- [ ] 函数<50行，组件<200行？
- [ ] 完整的错误处理？

自我修复循环

Execute → Fail? → Analyze → Fix → Retry (max 3)
                                    ↓
                           寸止: 请求人工介入

代码质量标准

必须

• TypeScript 无 any
• 完整错误处理
• 输入验证

避免

• 过度抽象
• 防御性过度设计
• 魔法数字/硬编码

降级策略

1. Codex是首选执行方法
2. 失败时重试一次
3. 连续两次失败 → 记录CODEX_FALLBACK → Claude直接执行
4. 下一任务重新尝试Codex

注意

默认静默执行：除非用户明确要求，不自动运行测试/编译