Codex Skill
代码执行的主要方法。Claude负责规划验证,Codex负责实际执行。
使用场景
- 任何代码编写、修改、删除
- 测试编写和执行
- 大规模重构
- 文件操作
调用方式
基本调用
codex "任务描述" [工作目录]
codex "重构 @src/auth.ts 添加JWT验证"
HEREDOC语法(推荐复杂任务)
codex - <<'EOF'
实现用户认证模块:
1. 创建登录API端点
2. 添加JWT token生成
3. 实现密码哈希
4. 编写单元测试(仅用户要求时)
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
并行任务格式
| 字段 | 说明 |
|------|------|
| ---TASK--- | 任务块开始 |
| id | 唯一任务标识 |
| workdir | 工作目录(可选) |
| dependencies | 依赖任务ID(可选) |
| ---CONTENT--- | 任务内容开始 |
会话管理
# 首次任务
codex "添加表单验证"
# 输出: SESSION_ID: 019a7247...
# 恢复会话继续
codex resume 019a7247... - <<'EOF'
为每个验证规则添加错误消息
EOF
自我修复循环
Execute → Fail? → Analyze → Fix → Retry (max 3)
↓
寸止: 请求人工介入
降级策略
- Codex是首选执行方法
- 失败时重试一次
- 连续两次失败 → 记录CODEX_FALLBACK → Claude直接执行
- 下一任务重新尝试Codex
代码质量标准
- TypeScript 无
any - 函数 <50行
- 组件 <200行
- 完整错误处理
- 输入验证
注意
默认静默执行:除非用户明确要求,不自动运行测试/编译