用途
prod-readiness 用于评估发布就绪度或执行上线前审查。它并行启动 5 个专项审查智能体,每个智能体将发现写入专用报告文件,最终汇总为一份带执行摘要、阻塞项和修复计划的优先级生产就绪报告。
主要能力
该技能通过 TeamCreate + Task 并行启动 5 个智能体,团队名称为 prod-review-<YYYYMMDD>:
- security-auditor → REVIEW_SECURITY.md:检查 OWASP Top 10、RBAC 缺口、输入验证、密钥、认证流程、Webhook 安全。
- test-coverage-analyst → REVIEW_TESTING.md:检查未覆盖的关键路径、总是通过的测试、缺失的错误路径测试、不稳定模式。
- performance-infra → REVIEW_PERFORMANCE.md:检查 N+1 查询、无界查询、缺失索引、内存泄漏、优雅关闭、限流。
- observability-analyst → REVIEW_OBSERVABILITY.md:检查未处理的 rejection、日志中的 PII、错误响应一致性、结构化日志、健康端点。
- code-quality → REVIEW_QUALITY.md:检查死代码、循环依赖、TODO/FIXME 密度、包边界违规、类型安全缺口。
每个智能体按 [CRITICAL|HIGH|MEDIUM|LOW] 格式输出发现,并附带文件:行号与建议修复。
使用方式
预检(启动智能体前必须运行)
git status --short # 必须干净 git log --oneline -5 # 确认近期工作已提交 npx vitest run --reporter=dot 2>&1 | tail -5 # 必须为绿色
如果测试失败:警告用户,在基线变绿之前不要继续。
监控智能体
ls -la REVIEW_.md # 确认文件正在写入 wc -l REVIEW_.md # 跟踪进度
如果某个智能体 2 分钟内没有更新文件,发送检查消息。
汇总
在所有 5 个 REVIEW_*.md 存在后运行。使用 node scripts/summarize-review-reports.js 或手动汇总为 PRODUCTION_READINESS_REPORT.md,结构包括:执行摘要、质量门结果、关键阻塞项、高优先级、中优先级、低优先级/技术债。每项包含 [CATEGORY] 标题、文件:行号、风险、工作量(S/M/L)、修复建议。
最终质量门
npx vitest run --reporter=dot 2>&1 | tail -10 cd apps/api && npx tsc --noEmit 2>&1 | tail -5 npm audit --audit-level=high 2>&1 | tail -10
将结果追加到报告。
提交与关闭
git add REVIEW_*.md PRODUCTION_READINESS_REPORT.md git commit -m "docs(review): production readiness report $(date +%Y-%m-%d)
Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com"
关闭所有智能体,清理团队。
参数
- (空)— 完整审查
- --quick — 跳过 performance 和 code-quality 智能体,聚焦安全与测试覆盖
- --security-only — 仅启动 security-auditor
- --no-commit — 生成报告但不提交
适用场景
- 需要全面评估发布准备度。
- 执行上线前审查。
限制与禁止事项
不要在以下情况加载:
- 用户只想要一个狭窄的审查(改用相关专项技能)。
- 代码库处于实现中途且基线已知损坏。
- 任务是修复问题而非评估就绪度。
绝不要:
- 在工作树脏时运行——未提交的更改意味着智能体发现无法映射到稳定提交,发现不可复现,报告失去可追溯性。
- 在基线失败时运行——红色测试套件无法区分既有失败与审查发现;始终先确认基线为绿色。
- 在所有 5 个智能体完成写入前汇总——部分汇总会产生遗漏整个维度的报告;来自慢速智能体的 CRITICAL 发现会被埋入 LOW 积压。
- 让智能体写入同一文件——每个智能体有自己的 REVIEW_*.md;共享文件会产生交错、无法解析的输出。
- 在未清理的情况下提交上一次运行的 REVIEW_*.md 文件——先前会话的陈旧发现与新发现混合会产生误导性的严重性分布。
- 在没有文件:行号引用的情况下将问题评为 CRITICAL——不可追溯的 CRITICAL 会造成审查疲劳,并像模糊的 LOW 一样被降级。
补充说明
各智能体的详细检查清单与提示词已在资料中给出,涵盖安全、测试覆盖、性能与基础设施、可观测性、代码质量五个维度,具体检查项与输出格式见上文主要能力部分。