用途:基于项目分析结果管理当前项目的 .codex/agents/ 团队,把 Codex agent 团队与推理结果对齐。适用场景为需要更新 agent 团队、增删 agent、重新分析项目时。操作幂等,已存在且推理仍需要的 agent 直接跳过。
主要能力与用法:输入项目根目录(当前工作区或 git root,除非用户指定);支持 --force <name> 强制重新生成指定 agent,--only <name,...> 只分析并处理指定 agent,--remove <name> 经用户二次确认后删除指定 agent。工作流先收集上下文,来源包括 .vibeRig/requirements/ 文档(提取功能模块、技术关键词、任务类型)、Linear 未执行 issues(Todo/Backlog/In Progress,Linear 不可用时跳过并注明)、项目结构扫描(package.json、go.mod、Cargo.toml、pyproject.toml、requirements.txt 等)。随后推理所需 agent 角色并写出依据,对当前团队做 diff,分为待创建、跳过、建议删除三类,再执行创建/更新(调用 agent-creator,传入名称、职责、sandbox_mode、技术栈与依据)并仅在修改 subagents 字段的前提下更新 project.yaml。
限制:单一职责,不允许复制插件基线 agents(由 vb-init 负责)、操作 ~/.codex/agents/ 全局 agents、修改 project.yaml 中 subagents 以外的字段、无推理依据创建 agent、无用户确认删除 agent;无法定位项目根目录或 .vibeRig/project.yaml 时应停止并询问。执行后会进行校验并输出报告。具体细节以原始资料为准。