用途：安装或刷新 superRA 的命名 Codex 智能体（superra_implementer、superra_reviewer），它们由 agents/ 中的规范角色说明生成。插件提供共享技能，本技能负责把命名智能体安装到 .codex/agents/ 或 ~/.codex/agents/。
适用时机：刚安装 superRA Codex 插件后；缺少 superra_implementer 或 superra_reviewer 时；agents/implementer.md 或 agents/reviewer.md 变更、需要刷新 Codex 智能体 TOML 时；需要在仅仓库安装与跨仓库安装之间选择时。
作用域选择：全局作用域 ~/.codex/agents/，适合在其他仓库工作，是普通终端用户配置；项目作用域 .codex/agents/，适合在本仓库开发或测试 superRA，仅在此仓库可用。若尚未决定，可用提问工具询问。
使用方式：先确认 Codex 中已有 superRA 技能；若本仓库直接在 Codex 打开，.agents/skills/ 符号链接可覆盖仓库级发现；若从其他仓库使用插件，需先安装插件。然后选择作用域，并将工作目录设为该技能目录（不要相对当前工作目录解析脚本），运行：python3 scripts/sync_codex_agents.py --scope global 或 python3 scripts/sync_codex_agents.py --scope project。若脚本报告未管理的冲突文件，应停止并询问后再覆盖，仅在用户明确批准后使用 --force 重跑：python3 scripts/sync_codex_agents.py --scope global --force。
验证：全局生成 ~/.codex/agents/superra_implementer.toml 与 ~/.codex/agents/superra_reviewer.toml；项目生成 .codex/agents/superra_implementer.toml 与 .codex/agents/superra_reviewer.toml。若智能体发现未刷新，重启 Codex 或开启新会话。贡献者验证可在技能目录运行 python3 scripts/sync_codex_agents.py --scope project --check。
限制：命名智能体依赖父会话中可用的 superRA 技能，若技能缺失需先安装或启用插件；规范角色说明仍位于 agents/implementer.md 与 agents/reviewer.md，生成的 TOML 由其派生，不应手工编辑，除非有意破坏同步模型。