AgentSkillsCN

codex

代码执行的核心技能，所有代码变更均通过此技能完成。

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

Codex Skill

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

使用场景

  • •任何代码编写、修改、删除
  • •测试编写和执行
  • •大规模重构
  • •文件操作

调用方式

基本调用

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

HEREDOC语法（推荐复杂任务）

bash
codex - <<'EOF'
实现用户认证模块：
1. 创建登录API端点
2. 添加JWT token生成
3. 实现密码哈希
4. 编写单元测试（仅用户要求时）
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

并行任务格式

字段说明
---TASK---任务块开始
id唯一任务标识
workdir工作目录（可选）
dependencies依赖任务ID（可选）
---CONTENT---任务内容开始

会话管理

bash
# 首次任务
codex "添加表单验证"
# 输出: SESSION_ID: 019a7247...

# 恢复会话继续
codex resume 019a7247... - <<'EOF'
为每个验证规则添加错误消息
EOF

自我修复循环

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

降级策略

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

代码质量标准

  • •TypeScript 无 any
  • •函数 <50行
  • •组件 <200行
  • •完整错误处理
  • •输入验证

注意

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