Codex

---
name: codex
description: 代码执行主力，所有代码变更通过此技能
mcp_tool: codex
---

# Codex Skill

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

## 核心原则

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

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

## 使用场景

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

## 调用方式

### 基本调用
```bash
codex "任务描述" [工作目录]
codex "重构 @src/auth.ts 添加JWT验证"
```

### HEREDOC语法（推荐复杂任务）
```bash
codex - <<'EOF'
实现用户认证模块：
1. 创建登录API端点
2. 添加JWT token生成
3. 实现密码哈希
EOF
```

### 并行执行
```bash
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审查)

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

## 自我修复循环

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

## 代码质量标准

### 必须
- TypeScript 无 `any`
- 完整错误处理
- 输入验证

### 避免
- 过度抽象
- 防御性过度设计
- 魔法数字/硬编码

## 降级策略

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

## 注意

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