Update Team

分析项目上下文，先生成“七个核心能力 + 有证据才激活的领域能力”团队画像，再将 Codex（.codex/agents/）、Claude Code（.claude/agents/）、Cursor（.cursor/agents/）三个平台对齐。读取并遵守 [team composition policy](./references/team-composition.md)。Codex Agent 使用 manifest 的固定角色模型，避免依赖父会话猜测分发；Claude Code/Cursor 保持 provider-local inherit。模型路由仍写入 .vibeRig/model-routing.yaml 记录 capability、mode、risk、fallback 与 Evidence。所有操作幂等。

Contract

单一职责：基于项目分析结果管理当前项目跨三个平台的 agent 团队。

不允许：

• 手写平台原生文件（TOML/MD）——新建/更新一律经过 agent-creator，避免三个平台的团队漂移不一致。
• 自行复制或重写插件 Agent spec（选中的 bundled Agent 由 built-in-agents 渲染）
• 更新、删除或重新定义 built-in-agents/agents.manifest.json；本 Skill 只根据 manifest 选择 core/conditional 集合并请求 built-in-agents 渲染
• 操作用户级全局 agents（~/.codex/agents/、~/.claude/agents/、~/.cursor/agents/）
• 修改 project.yaml 的 subagents 以外的任何字段
• 无正向仓库/需求/风险证据地创建 conditional agent
• 创建 CTO、product manager、white-team、final-QA 或 self-learning Agent
• 绕过 manifest 随意修改 Codex 固定角色模型，或让普通 test_engineer 同时承担需要 Sol 的 backend E2E
• 把一次任务或一个全局模型分数当成稳定路由结论
• 把 Codex 模型 slug 写入 Claude Code/Cursor 路由，或反向混用 provider 证据
• 为追求低成本绕过风险、证据保真、人工验收或交付权限 Gate
• 把 challenger/实验探索模型写入 Codex Agent；固定字段只能来自 manifest 的稳定角色默认值
• 无用户确认地删除 agent
• 在 Linear 中定义 agent——Linear agent = OAuth 应用 + 常驻 webhook 服务，不是可动态创建的实体。本 skill 只同步本地 agents 文件与项目所需的 capability 集合；issue 与 subagent 的匹配由 task-runner 执行时经 subagent-routing 现场完成
• 未经用户确认，向共享的 .cursor/mcp.json 写入或合并内容

无法定位项目根目录或 .vibeRig/project.yaml 时停止并询问。

输入

• 项目根目录 — 当前工作区或 git root，除非用户指定
• --force <name> — 强制重新生成指定 agent，即使已存在
• --only <name,...> — 只分析并处理指定 agent，不做全量
• --platforms <name,...> — 只对指定平台（codex/claude/cursor）做 diff 和渲染；默认三个平台都处理
• --remove <name> — 需要用户二次确认后删除指定 agent（所有已渲染平台的文件一并删除）
• --refresh-model-routing — 只刷新模型目录、accepted routing observations 与 .vibeRig/model-routing.yaml，不改 Agent 团队

Workflow

1. 收集上下文

来源一：.vibeRig/requirements/

find .vibeRig/requirements -type f | sort

读取所有文档，提取：

• 功能模块（前端、API、DB、CLI、基础设施等）
• 技术关键词（框架、语言、第三方服务）
• 任务类型（新功能、重构、性能优化、安全加固等）

来源二：Linear 未执行 issues（如工具可用）

查询当前项目状态为 Todo / Backlog / In Progress 的条目，提取：

• 任务类型与涉及模块
• 标签与优先级

Linear 不可用时跳过，报告中注明。

来源三：项目结构扫描（兜底）

识别 package.json、go.mod、Cargo.toml、pyproject.toml、requirements.txt 等技术栈文件及目录结构。

来源四：模型目录与 accepted routing observations

• 读取当前平台真实可用的模型目录与支持的 reasoning 档位；目录可见但实际认证拒绝的模型标为 unavailable；
• 读取 .vibeRig/model-routing.yaml（若存在）、近期 retrospective 中的 routing_observations，以及 [bundled model prior](../subagent-routing/assets/model-capability-prior.json)；
• 只比较同 provider、平台、task family、风险、Completion Oracle、证据保真度和主要 Skill/policy 版本的样本；
• 价格不可见时保留 token、缓存和耗时，不推测美元或 credits；
• 读取 [adaptive model routing](../subagent-routing/references/model-routing.md) 的 promotion、demotion 与 exploration 规则。

2. 形成可审计团队画像

读取 built-in-agents/agents.manifest.json 和 [team composition policy](./references/team-composition.md)：

1. 无条件选择 researcher、implementation、testengineer、codereview、qa、security_auditor、integrator 七个 core Agent。
2. 只在收集到具体正向证据时激活 conditional Agent；后端 E2E TC/contract 必须激活 backende2eengineer，不得交给普通 test_engineer。在 conditionalAgents.<agent> 下记录 {evidence[], reason}。
3. architectureredteam 只因 L3，或带不可逆/公共契约/安全边界/数据丢失信号的 L2 激活；普通多文件任务不能触发。
4. 不再需要但已存在或被定制的 Agent 进入 preserved/dormant；未经确认不删除。
5. 按 [team-profile.schema.json](./assets/team-profile.schema.json) 生成字节稳定的 .vibeRig/team-profile.yaml。
6. conditionalAgents 必须是以 manifest Agent name 为 key 的对象，而不是数组；结构上保证一个 capability 只有一个激活记录。

每个 conditional 推荐需说明依据（来自哪个来源、对应什么能力）：

• 每个推荐角色需说明依据（来自哪个来源、对应什么任务）
• 示例推理：

- requirements 有 DB 迁移文档 + Linear 有数据库相关 issue → 激活 dataarchitect - Linear 有安全类 issue → 推荐 securityauditor - 项目有 frontend/ 目录 + requirements 提及 UI → 激活 frontendarchitect；有用户可见交互证据时再激活 uiuxdesign - 大量 Bug 类 issue → 使用 core implementation + qa，只有现有能力无法覆盖且有重复专项需求时才创建项目特有角色 - 跨模块集成任务 → 使用 core integrator

3. 推理 capability × mode × risk 模型画像

先确定 capability 和单次调用 mode，再为每个平台建立任务族路由。至少覆盖：

• overall/orchestration：Terra/low；跨模块歧义升级 Sol/medium；
• research/bounded：Luna/low，多来源综合升级 Terra/low；
• implementation/bounded-issue：Luna/low，跨模块升级 Terra/medium，重复策略失败升级 Sol/medium；
• test_engineer/unit-contract-integration：Luna/low，复杂 fixture/边界升级 Terra/medium；
• backende2eengineer/backend-e2e-authoring：Sol/low，Terra/low 仅作为显式 fallback；
• code_review 和 qa：Terra/low，Gate 或冲突证据时 Sol/medium；
• integrator：Terra/medium，契约冲突时 Sol/medium；
• security_auditor：Sol/medium，可信高影响攻击路径时 Sol/high；
• domain architect：Terra/medium，不可逆/分布式设计升级 Sol/medium；
• architectureredteam：Sol/high，仅 exploit，不探索。

每条路由写明：默认 model/reasoning、challenger 或 fallback、confidence、accepted sample count、quality floor、探索资格和升级信号。保持锯齿状画像，不生成“最强模型”总榜。

Codex 缺少项目实测时可使用 bundled prior；Claude Code/Cursor 没有 provider-specific accepted evidence 时保持 inherit，不得借用 Codex 排名。少于 5 个可比样本为 experimental；只有满足 model-routing promotion 规则才更新默认。

4. Diff 当前团队

对每个目标平台分别检查：

ls .codex/agents/*.toml 2>/dev/null
ls .claude/agents/*.md 2>/dev/null
ls .cursor/agents/*.md 2>/dev/null

对每个推理出的 agent 名称，按 (agent, 平台) 组合建立三个列表：

• 待创建 — 推理需要但该平台目录中不存在对应文件
• 跳过 — 已存在且推理仍需要（--force 则移入待更新）
• 建议删除 — 某平台已存在该 agent 文件，但推理判断整个团队不再需要这个角色

先读取 built-in-agents/agents.manifest.json。七个 core Agent 永不进入“建议删除”。未被本轮激活的 conditional Agent 不应在全新项目中物化；已经存在的 conditional Agent 进入 preserved/dormant，不自动删除。manifest 外真正的项目 Agent 才由本 Skill 通过 agent-creator 创建或更新。

5. 执行变更

bundled core/conditional 创建或升级：把团队画像选出的 manifest Agent 精确列表传给 built-in-agents --only；不得复制 JSON spec 或手写原生文件。

项目特有角色创建/更新：对每个 manifest 外待创建/待更新的 agent，调用 agent-creator，传入：

• agent 名称与职责
• 读写权限（对应 sandbox_mode/tools/readonly）
• 项目技术栈与推理依据（用于调优 mission/scope 内容）
• targets：该 agent 在本轮缺失或需要更新的平台列表（不要求 agent-creator 重新渲染已跳过的平台）

Bundled portable spec 保留 model: inherit，但渲染 Codex 时必须应用 manifest 的 platformModelDefaults.codex：Luna 用于 research/implementation/ordinary tests，Terra 用于 review/QA/integration/domain，Sol 用于 backend E2E/security/red-team。Claude Code/Cursor 没有自身 policy 时仍渲染为 inherit。不得把 challenger 或 Codex slug 写入其他 provider。

若该 agent 需要 MCP 服务器且目标平台包含 Cursor：先渲染 agent 文件本身（不含 MCP 字段），MCP 服务器是否合并进共享的 .cursor/mcp.json 单独询问用户，不在本步骤自动执行。

建议删除：列出建议删除的 agent 及理由，等待用户确认后执行。

--remove <name>：确认后删除该 agent 在所有已渲染平台下的文件（.codex/agents/<name>.toml、.claude/agents/<name>.md、.cursor/agents/<name>.md），并从 project.yaml 移除对应 key。

6. 更新 project.yaml subagents 段

subagents 只允许四个固定偏好键：defaultresearch、defaultqa、defaultsecurityaudit、default_review。只有当本轮创建/删除影响这四种默认能力时才修改对应值；实现、集成、测试编写、架构或领域 Agent 均由 subagent-routing 现场发现，不为它们增加配置键。

7. 更新模型路由派生文件

按 [model-routing-profile.schema.json](./assets/model-routing-profile.schema.json) 生成或刷新 .vibeRig/model-routing.yaml：

• catalogFingerprint 绑定当前平台目录；
• policyFingerprint 绑定模型 prior、路由协议和相关 Skill 版本；
• sources 记录使用的 accepted event IDs 和 prior version；
• route 只含聚合统计和决策，不复制敏感 prompt、代码或用户数据；
• source、catalog 或 policy 未变化时保持字节稳定；
• 出现 invalidation signal 时降低 confidence 或回退到 inherit/bundled prior，不静默沿用过期排名。
• 每条 route 必须显式写 risk（单一等级或有界 risk band）；route identity 至少包含 capability、mode/taskFamily、risk 和 reasoningEffort，禁止只有 agent 名称的单维路由。
• backend E2E authoring 必须路由到独立的 backende2eengineer；不得因为 E2E 使用 Sol 而把普通 test_engineer 升级到 Sol。

该文件是可重建缓存，不是人工验收、模型可用性或成本事实的权威来源。原始 accepted retrospective observations 才是证据。

8. 输出报告

分析依据：
  - requirements/: 发现前端模块、API 层、DB 迁移需求
  - Linear: 8 个待执行 issue（3 个 UI、2 个 API、1 个安全）
  - 项目结构: Go 后端 + React 前端

团队画像：
  core               → researcher, implementation, test_engineer, code_review, qa, security_auditor, integrator
  conditional active → backend_architect, frontend_architect, data_architect, uiux_design
  conditional absent → backend_e2e_engineer, reliability_engineer, architecture_red_team

Agent 团队变更（按平台）：
  frontend_architect → codex: 新建 | claude: 新建 | cursor: 新建（依据：Linear UI issue ×3 + frontend/）
  uiux_design        → codex: 新建 | claude: 新建 | cursor: 新建（依据：requirements/ui.md 有用户可见交互）
  security_auditor → codex: 跳过（已存在） | claude: 新建 | cursor: 新建
  data_architect   → codex: 新建 | claude: 新建 | cursor: 新建（依据：requirements/db-migration.md）
  old_agent_xyz    → 建议删除（无对应任务，请确认 y/n）

汇总：7 个文件新建，1 个跳过，1 个待确认删除

模型路由：
  overall             → codex: gpt-5.6-terra/low（provisional，来源：prior + accepted ×4）
  bounded-intake      → codex: gpt-5.6-luna/low（experimental，10% eligible exploration）
  bounded-implement    → codex: gpt-5.6-luna/low（跨模块升级 Terra/medium）
  unit-contract-test  → codex: gpt-5.6-luna/low
  backend-e2e-author  → codex/backend_e2e_engineer: gpt-5.6-sol/low（Terra/low explicit fallback）
  accept-deliver      → codex: gpt-5.6-terra/low（exploit only）
  Codex Agent files   → Luna/ Terra/ Sol fixed by role
  claude/cursor       → inherit（无 provider-specific accepted evidence）

Validation

# 新建的 agent 文件存在（按平台）
ls .codex/agents/ .claude/agents/ .cursor/agents/ 2>/dev/null

# Codex: 无不支持的自定义字段
grep -En "^\[skills\]|^recommended_skills|^scope\s*=|^inputs\s*=|^boundaries" \
  .codex/agents/*.toml && echo "INVALID FIELDS" || echo "ok"

# Codex: 每个 Agent 的固定模型符合 manifest
grep -H '^model = ' .codex/agents/*.toml

# 用 VibeRig 自带校验器检查 Codex 固定模型及 Claude/Cursor provider 隔离
node <viberig-root>/scripts/validate-rendered-agent-models.mjs \
  --root . --agents <selected-agent-csv> --platforms codex,claude,cursor

# Cursor: 不应出现按 agent 分配的 MCP 字段
grep -En "^mcp_servers|^mcpServers" .cursor/agents/*.md 2>/dev/null && echo "UNSUPPORTED MCP FIELD" || echo "ok"

# project.yaml subagents 已更新
grep "subagents" .vibeRig/project.yaml

# 团队画像符合 core/conditional 契约
grep -E "coreAgents|conditionalAgents|manifestFingerprint|policyFingerprint" .vibeRig/team-profile.yaml

# 模型路由派生文件符合 schema 所需字段
grep -E "catalogFingerprint|policyFingerprint|taskFamily|qualityFloor" .vibeRig/model-routing.yaml

• 每个新建 agent 在其目标平台都有对应文件，且有推理依据
• 七个 core Agent 全部存在；conditional Agent 均有正向 evidence，不因猜测创建
• .vibeRig/team-profile.yaml 通过 schema，记录 manifest/policy fingerprint 和 preserved Agent
• 无 agent 被静默删除
• project.yaml subagents 与最终团队一致
• 报告包含每个 (agent, 平台) 组合的动作与依据
• 涉及 MCP 的 agent 在 Cursor 上未写入不支持字段，.cursor/mcp.json 合并仅在用户确认后进行
• Linear 不可用时报告中已注明
• 模型画像按 provider/platform/task family 分开，没有全局排行榜。
• Codex Agent 文件包含 manifest 固定模型；Claude Code/Cursor 保持 provider-local inherit。
• testengineer 固定 Luna 且拒绝 backend E2E；backende2e_engineer 独立固定 Sol。
• 路由包含 capability + mode/taskFamily + risk；fallback 不静默改写 Agent 文件。
• .vibeRig/model-routing.yaml 绑定 catalog、policy 与 accepted sources，可由原始 Evidence 重建。
• challenger 只用于符合安全条件的低风险探索；accept/security/不可逆操作没有在线探索。
• 不可见价格没有被估算或伪造成成本事实。