Nexus: Skill for Claude Code

Skill：test-release（自动化测试发布）

1. 业务用途

将修复后的代码通过受控流程发布上线：创建发布（自动发起人工审批，强制回滚计划）→ 自动化测试 → 灰度验证 → 确认上线；验证失败自动回滚（记录回滚目标版本与原因）。对应 8 步闭环的"结果验证"与"审批与回滚"环节。

2. 输入输出 Schema

输入：

{ 发布任务: { task_id, description: 变更摘要 + 缺陷 ID 列表 },
  版本建议: { version: string, previous_version: string } }

输出：

{ 发布: { release_id, version, status, approval_id },
  测试结果: { 构建: ok|failed, 单测: { 通过, 失败 }, 集成测试: ok|failed },
  验证结论: { 结果: live|failed|rolled_back, 证据: string, rollback: { target_version, reason }? } }

3. 调用触发条件

• manager 创建"发布任务"（依赖修复任务完成）
• 灰度/线上监控发现异常需要回滚（可直接 rollback_release）

4. 依赖工具

工具	用途
create_release	创建发布（默认自动发起 high 风险审批，状态 pending_approval）
update_release	状态流转：testing → verifying → live/failed（服务端强制审批门禁）
rollback_release	失败回滚：记录 target_version/reason，置 rolled_back（幂等保护）
list_approvals	轮询审批结果
list_releases	发布历史核对（版本唯一性）
客户端原生能力	构建、单元/集成测试执行、灰度流量操作

5. 失败重试 / 降级机制

• 测试失败 / 灰度验证失败 → update_release(status="failed") → rollback_release(reason=...)（自动回滚，全链路审计）
• 审批被拒 → 报告 manager，不强行发布；调整方案后重新 create_release
• 审批超时 → 提醒用户，保持 pending_approval，不自动放行
• 降级：无灰度环境 → 以自动化测试为准 live，并在交付消息中标注"未做灰度验证"

6. 安全权限边界

• ✅ 允许：create_release / update_release / rollback_release / list_approvals
• ❌ 禁止：approve_request / reject_request（发布审批只能人工执行，服务端有门禁双重保证）
• ⚠️ 版本唯一性由服务端强制（重复版本拒绝创建）
• ⚠️ 回滚是安全操作必须有 reason；回滚动作本身写入审计日志（谁/何时/为什么/回滚到哪）

7. 多场景复用价值

• 软件发布管理（本场景）
• 灰度发布与回滚（任何服务上线流程）
• 配置变更发布（配置灰度 + 自动回滚 — 配置治理方向）
• 依赖升级验证（自动化测试前置的依赖变更发布）

8. 与多 Agent 协作链路

fixer-agent ──修复交付──▶ devflow-manager ──发布任务──▶ release-agent
release-agent ──审批请求──▶ devflow-manager ──展示──▶ 用户（人工审批）
release-agent ──live/failed──▶ devflow-manager ──复盘任务──▶ retro-agent

发布状态机 + 审批门禁 + 回滚语义是"结果验证"与"审批与回滚"两个闭环环节的工程支撑。