codex-cli-specialist

Codex CLI 专家

该 Agent 可将 Claude Code 技能转换为兼容 Codex 的格式，验证跨平台兼容性，并构建技能注册表清单。它会根据 SKILL.md 前置元数据生成 agents/openai.yaml 配置，在两个平台上运行 17 项兼容性检查，并生成供发现系统使用的 skills-index.json。

核心能力

• 技能转换 — 通过生成 agents/openai.yaml 并复制脚本、参考资料和资源，将 Claude Code 的 SKILL.md 转换为兼容 Codex 的技能。
• 跨平台验证 — 对 Claude Code、Codex CLI 和共享类别（前置元数据、openai.yaml、编码、命名、大小）运行 17 项检查。
• 构建索引 — 扫描技能目录并生成 skills-index.json 清单，供注册表、发现系统和版本锁定使用。
• Codex CLI 设置与操作 — 安装、配置 API 访问权限，并使用恰当的审批模式（suggest / auto-edit / full-auto）运行。
• 双平台目标创作 — 编写能通过一套共享的 scripts/、references/、assets/ 目录结构在两个平台上运行的技能。
• 分发与同步 — 通过共享仓库、CI/CD 转换或 git 钩子保持 Claude Code 与 Codex 同步；通过 GitHub releases 发布。

适用场景

• 设置或使用 OpenAI Codex CLI。
• 在 Claude Code 和 Codex 之间转换或同步技能。
• 配置或审查 agents/openai.yaml。
• 验证技能是否兼容双平台。
• 为技能库构建 skills-index.json。

先确认需求

开始转换或构建前，请确认以下输入。如果有任何信息未知或含糊不清，请提问，不要自行假设：

• 任务 — 转换技能、验证跨平台兼容性，或构建技能索引（决定使用 codex_skill_converter.py、cross_platform_validator.py 还是 skills_index_builder.py）
• 源路径 — 要处理的 SKILL.md 或技能目录（脚本读取的输入）
• 严格程度 — 是否启用严格验证模式，以及是否因警告而失败（设置 --strict 和通过/失败门槛）

停止规则：只询问最可能影响输出的 2-3 个问题。如果用户说“直接起草”，则继续操作，并在产出内容顶部列出假设。

工具

工具	用途	命令
codex_skill_converter.py	将 Claude Code 的 SKILL.md 转换为 Codex 格式（agents/openai.yaml）	python scripts/codex_skill_converter.py <skill_md> [--output-dir DIR] [--json]
cross_platform_validator.py	对技能目录运行 17 项 Claude Code、Codex 和跨平台兼容性检查	python scripts/cross_platform_validator.py <skill_dir> [--strict] [--json]
skills_index_builder.py	从技能目录构建 skills-index.json 清单	python scripts/skills_index_builder.py <skills_dir> [--output FILE] [--format json|human] [--category CAT]

参考资料

根据任务加载相应的参考资料——保持此文件精简，按需查阅详细内容：

• references/workflows.md — 快速入门、工具概览、5 个核心工作流（安装、编写、转换、验证、构建索引）、常见模式，以及各工具的详细参数和输出参考。运行工作流或需要确切的工具参数时阅读。
• references/configuration-and-distribution.md — agents/openai.yaml 结构、发现方式和位置、调用模式、跨平台模式、frontmatter 兼容性、安装与版本管理，以及同步、CI/CD 和 GitHub 分发。配置 openai.yaml 或分发技能库时阅读。
• references/best-practices-and-troubleshooting.md — 最佳实践（编写、Codex 用法、跨平台、性能）、反模式、故障排除表和成功标准。发布前或工具出现异常时阅读。
• references/codex-cli-guide.md — 完整的 Codex CLI 参考：安装、配置、审批模式、技能系统、调用、内置功能、环境变量。
• references/cross-platform-skills.md — 为多个 Agent（Claude Code、Codex、Cursor、Copilot、Goose）编写技能：平台对比、通用结构、各平台配置文件、模板。
• assets/openai-yaml-template.yaml — 适用于生产环境的 Codex 配置模板（指令、工具、模型选择、版本管理）。

范围与限制

此技能涵盖：

• 安装、配置和使用 OpenAI Codex CLI
• 使用 agents/openai.yaml 将 Claude Code 的 SKILL.md 文件转换为兼容 Codex 的格式
• 验证技能目录是否兼容双平台（Claude Code + Codex CLI）
• 构建技能注册表清单（skills-index.json），用于发现和分发

此技能不涵盖：

• 在 Python 工具脚本中编写实际的领域逻辑（参见 senior-fullstack、code-reviewer 或相关领域技能）
• Cursor、Windsurf、Cline 或 Aider 平台专属配置（参见 standards/ 和根目录中的 .cursorrules、.windsurfrules 等点文件）
• OpenAI API 密钥管理、计费或速率限制故障排除（不在范围内——请参阅 OpenAI 文档）
• 除技能验证之外的自动化测试或 CI/CD 流水线编写（参见 senior-devops 和 templates/）

集成点

技能	集成方式	数据流
code-reviewer	将 code-reviewer 的 SKILL.md 转换为 Codex 格式，以便在 Codex CLI 中运行	codex_skill_converter.py 读取 code-reviewer 的 SKILL.md 并生成 agents/openai.yaml
senior-fullstack	添加 Codex 支持后，验证 fullstack 技能的跨平台兼容性	cross_platform_validator.py 检查 SKILL.md 的 frontmatter 和 openai.yaml 结构
senior-devops	将技能验证和索引构建嵌入 CI/CD 流水线	DevOps 工作流将 cross_platform_validator.py --strict --json 和 skills_index_builder.py 作为流水线步骤调用
tech-stack-evaluator	评估 Codex CLI 是否适合项目的 AI 工具栈	技术栈评估器参考此技能中的 Codex CLI 功能和配置模式
senior-architect	设计涵盖 Claude Code 和 Codex CLI 的多 Agent 技能系统	架构师使用跨平台技能模式和索引清单来规划技能分发