用途：为 Codex 编写、校验、安装和测试可复用的自定义子代理角色，角色以独立 TOML 文件形式存在。运行时委派策略由 $subspawn 负责，本技能专注于角色创作与生命周期管理。
主要能力：可选择全局个人角色目录 ~/.codex/agents、受信任仓库下的项目级目录 .codex/agents，或显式指定的自定义目录；从 templates/agents/、内置模板包或自定义窄角色中选择模板；通过 scripts/subagent_creator.py 执行 list、status、plan-sync、install、validate、render、diff、sync、prune、backup、doctor、smoke 等确定性工作流。生成后必须校验 TOML 文件再交付。
使用方式：命令路径相对技能目录解析，例如 python3 scripts/subagent_creator.py list、list --packs、doctor --project-dir .、status --pack core --project-dir . --include-extra、plan-sync --pack core --target global --include-extra、install reviewer repo_explorer --target global --dry-run、pack install core --target project --project-dir . --dry-run、diff、sync、prune、backup、validate ~/.codex/agents、smoke --pack docs。仅在有意替换角色时使用 --overwrite；更新已安装模板优先用 sync（默认备份被覆盖文件）；目标不明确时先 --dry-run；大范围更新前用 status --include-extra 与 plan-sync；prune 默认仅演练，需 --confirm 才执行。
默认约定：角色名与文件名用 snake_case；检索与机械盘点用 gpt-5.6-terra，判断、实现、规划与综合用 gpt-5.6-sol；推理默认 medium，复杂决策用 high，Terra max 仅用于独立对抗性校验；避免遮蔽 Codex 内置角色（default、worker、explorer），除非用户明确要求覆盖；沙箱遵循最小权限，reviewer、仓库探索、文档与 CI 分诊角色只读，仅运行测试、调试浏览器或实现修复的角色可 workspace-write；工具默认继承父级工具与 MCP 服务器。模板默认禁止嵌套子代理、保留父级边界、脱敏密钥，并以稳定分段结构返回证据。
模板包：core（常规委派基线角色）、docs（通用文档、OpenAI 文档、Context7 与依赖研究）、review（PR/代码审查辅助通道，含误报校验）、audit（安全、运行时、依赖、性能与文档审计）、ops（CI、发布、环境与校验）。可用 pack list 或 list --packs 查看具体成员。创建新角色族、调整模型策略或添加 MCP/服务器专属配置前，先阅读 references/authoring-guide.md；围绕内置代理搭建 PR 审查或审计编排流程前，先阅读 references/workflow-recipes.md。
限制：资料未提供收费、价格、平台支持范围与效果数据；实际运行行为需配合 $subspawn 严格 rendezvous 指引。