用途：codex-cli-best-practice 是一个参考型仓库与技能指南，演示如何利用 Codex CLI 的高级特性完成从 vibe coding 到 agentic engineering 的实践，重点覆盖子智能体、技能、MCP 服务器、端到端工作流、配置分层、钩子、记忆、插件市场等。
主要能力：子智能体以 .codex/agents/<name>.toml 定义角色与模型，支持并行编排；技能放在 .agents/skills/<name>/SKILL.md，含 YAML frontmatter 与 scripts、references、assets 结构；MCP 服务器在 .codex/config.toml 的 [mcp_servers.*] 中配置，可接外部工具；典型工作流为 Agent → Skill → Output，例如 @weather-agent 取数后由 $weather-svg-creator 生成卡片。配置还覆盖 features（memories、codex_hooks、fast_mode）、approval_policy、sandbox、model、memories 与 developer_instructions；hooks.json 可在编辑、Shell、提交前后注入脚本；插件通过 plugin marketplace 与 .codex-plugin/plugin.json 管理。
使用方式：先安装 Codex CLI（需 Codex Pro 订阅），如 brew install --cask codex-cli，再从 https://developers.openai.com/codex/cli 下载；克隆仓库后 codex init 初始化。调用示例：codex 后输入 @weather-agent Get Dubai weather in Celsius；显式调用技能用 Use $weather-svg-creator ...，也可按描述隐式触发。MCP 用 codex mcp list/add/get/login 管理；斜杠命令包括 /plan、/fast on|off|status、/review、/status、/mcp、/agent、/skills、/plugins、/memories use|reset。需设置 OPENAI_API_KEY，可选 CODEX_HOME、GITHUB_TOKEN。
适用场景与限制：适合希望系统化掌握 Codex CLI 配置、子智能体与技能编排的开发者。仓库同时给出故障排查（子智能体未识别、技能未触发、MCP 连接失败、钩子未执行、记忆不持久、审批过严）。资料未提供具体定价、性能数据或平台兼容性细节，需以官方文档 https://developers.openai.com/codex/overview 为准。