SuperAPI AI 工具集

pm-closure-validation

办公与效率

查看项目

更新于 10-16 08:27

技能介绍

用途

pm-closure-validation 是一个 PM(产品负责人 / 发布经理)收尾验证技能,作为增量关闭前的最终质量闸门。它通过一套严格的三道门(3-gate)验证流程,确保增量在关闭前达到质量标准。

适用时机包括:

  • 验证增量是否具备关闭条件
  • 检查所有任务是否完成(按 P1、P2、P3 优先级)
  • 核实测试覆盖率与测试通过情况
  • 确保文档已更新(CLAUDE.md、README.md、CHANGELOG.md)
  • 检测范围蔓延(实现过程中新增的额外任务)
  • 在关闭增量前获得 PM 批准
  • 理解增量完成的质量门标准

主要能力

该技能以产品负责人 / 发布经理角色运作,确保增量交付三方面价值:业务价值(所有关键任务完成)、质量(测试通过、无回归)、知识留存(文档已更新)。它会在批准关闭前验证全部三道门。

验证工作流

第 1 步:加载增量上下文

需要读取以下文件:

Read: .specweave/increments/{id}/spec.md
Read: .specweave/increments/{id}/plan.md
Read: .specweave/increments/{id}/tasks.md  # Tests embedded in tasks.md

第 2 步:验证门 1 — 任务完成

检查清单:

  • 所有 P1(关键)任务已完成
  • 所有 P2(重要)任务已完成,或已附原因延期
  • P3(锦上添花)任务已完成、延期或移入待办
  • 没有处于“阻塞”状态的任务
  • 每个任务的验收标准均已满足

第 3 步:验证门 2 — 测试通过

检查清单:

  • 所有测试套件通过(无失败)
  • 测试覆盖率达到目标(关键路径默认 80%+)
  • E2E 测试通过(如存在 UI)
  • 没有未记录说明的跳过测试
  • 测试用例与 spec.md 中的验收标准一致

该步骤会要求用户运行测试并分享结果:

npm test                # Run all tests
npm run test:coverage   # Check coverage

第 4 步:验证门 3 — 文档已更新

检查清单:

  • CLAUDE.md 已更新新功能
  • README.md 已更新使用示例
  • CHANGELOG.md 已更新(如公共 API 变更)
  • API 文档已重新生成(如适用)
  • 内联代码文档完整
  • 没有对旧代码的过时引用

该步骤会扫描文件:

Read: CLAUDE.md
Read: README.md
Read: CHANGELOG.md
Grep: Search for references to new features

第 5 步:PM 决策

如果三道门全部通过,输出“READY TO CLOSE”,汇总交付的业务价值、已满足的验收标准,并给出后续步骤(更新增量状态、设置完成日期、生成完成报告、将延期的 P2 任务转入待办、更新活文档)。

如果任意一道门失败,输出“NOT READY TO CLOSE”,列出阻塞项、修复所需预估工时与行动计划,增量状态保持 in-progress。

范围蔓延检测

当 tasks.md 中的任务数显著多于原计划时触发。技能会对比原始计划(spec.md)与当前状态(tasks.md),列出实现期间新增的任务,并提供选项:

  • A)接受范围增长,带全部任务关闭
  • B)将新任务移入下一个增量,按原任务数关闭
  • C)拆分为两个增量(推荐)

并给出最佳实践:若新任务带来明确价值可接受范围增长;若范围翻倍或三倍则拆分为两个增量;记录经验教训以改进未来估算。

验证模板

技能为三道门分别提供输出模板:

  • 门 1:任务完成模板(按优先级统计完成比例、列出未完成的 P1 任务与延期的 P2 任务)
  • 门 2:测试通过模板(单元/集成/E2E 通过数、覆盖率、失败详情与修复建议)
  • 门 3:文档模板(各文档状态与更新或缺失详情)

使用方式

该技能在 /sw:done 之前使用,用于验证增量是否就绪。相关命令包括:

  • /sw:done {increment-id} — 触发 PM 收尾验证
  • /sw:status {increment-id} — 查看增量状态
  • /sw:validate {increment-id} — 运行验证检查
  • /sw:check-tests {increment-id} — 验证测试覆盖率

相关技能包括:increment-planner(创建含验收标准的 spec.md)、test-aware-planner(生成内嵌测试的 tasks.md)、architect(设计技术方案 plan.md)。

适用场景

适用于采用 SpecWeave 增量工作流的项目,在增量关闭前由 PM 角色执行最终质量把关,尤其适合需要同时保证任务完成度、测试质量与文档同步的团队。

限制与最佳实践

  • 三道门必须全部通过,无例外,质量不可妥协。
  • 反馈需具体:包含文件路径、行号、具体测试失败与修复预估工时。
  • 工时估算参考:小修复 < 1 小时,中等修复 1-3 小时,大修复 4-8 小时。
  • 需尽早检测范围蔓延。
  • 批准关闭时需记录业务价值。
  • 开始工作前应检查项目特定的经验记录(原文在此处截断,具体内容暂未提供)。