SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场milestone-review

milestone-review

部署与运维

查看项目

更新于 10-15 15:05

技能介绍

用途

Milestone Review 用于在开发检查点或截止日期前，对某一里程碑的整体进度做结构性审查。它回答的问题不是“代码写得怎么样”，而是“这个里程碑现在是否按计划达成、有哪些功能完成、有多少阻塞、质量指标如何、能否按期交付”。审查结果帮助团队决定是否继续（go/no-go）、是否缩减范围或如何调整下一个冲刺。

主要能力

  1. 输入完备性检查：技能首先列出它需要读取的输入（数据文件、既有报告、性能分析输出、测试结果、注册表、源代码等），逐项标记为 FOUND 或 ABSENT。任何一个章节所需输入缺失时，该章节一律标为 NOT ASSESSED — NO DATA，不做估算、不从相邻产物推断，也不留空单元格让别人代填。若所有必需输入都缺失，整体裁定为 NOT ASSESSED。技能明确指出：NOT ASSESSED 是一种成功的输出，是“没有数据”情况下的正确答案。

  2. 里程碑与冲刺数据加载：从 production/milestones/ 读取里程碑定义（存在时）；参数为 current 时取最近修改的里程碑文件，但会跳过以 -review.md 结尾的文件，避免把上次审查误当作定义。由于该目录通常由 .claude/docs/templates/milestone-definition.md 手工创建，多数项目可能没有定义文件，此时技能会明说并仅依据冲刺报告审查，不虚构定义。之后对 production/sprints/ 中属于该里程碑的冲刺报告做聚合扫描，按既定的标题模式抓取 Sprint Goal、Capacity、Tasks、Carryover、Risks、Progress、Burndown Assessment、Emerging Risks、Definition of Done 等段落，而不是整篇读取。

  3. 受阻故事处理：受阻故事不在冲刺报告的扫描段落中，技能会到 production/sprint-status.yaml 读取 status: blocked 的故事及其 blocker 字段，并对 production/epics/**/story-*.md 做一次 grep 查找状态为 Blocked 的故事。每个受阻故事归入其所属 epic 的功能下，并附上阻塞原因。若既无故事文件也无 sprint-status.yaml，则受阻表与受阻计数标为 NOT ASSESSED — NO DATA，而不是零。

  4. 代码与质量扫描：扫描 TODO、FIXME、HACK 标记以识别未完成工作；按严重程度统计 production/qa/bugs/ 中的未解决缺陷（用一次 grep 抓取 Severity 与 Status 行）；检查 production/risk-register/ 风险登记（同样是手工维护的模板文件，缺失属正常，会注明而非静默跳过风险评估）。

  5. 审查报告生成：输出结构包括 Overview（目标日期、当前日期、剩余天数、已完成冲刺数）、Feature Completeness（Fully Complete / Partially Complete / Blocked / Not Started 四类表格）、Quality Metrics（S1/S2/S3 未解决缺陷、测试覆盖率、性能是否在预算内）、Code Health（TODO/FIXME/HACK 计数、关键技术债）、Risk Assessment、Velocity Analysis（计划 vs 完成、趋势、按当前速度的剩余工作调整估算）、Scope Recommendations（Protect / At Risk / Cut Candidates）、Go/No-Go Assessment 与 Action Items 表格。

  6. 制片人风险评估（PR-MILESTONE 门禁）：按 review mode 分流。solo 模式跳过并注明；lean 模式跳过（注明不是 PHASE-GATE）；full 模式正常生成，通过 Agent 调用门禁 PR-MILESTONE，传入里程碑名称与目标日期、当前完成百分比、受阻故事数、速度数据、候选裁剪清单，并将制片人结论（ON TRACK / AT RISK / OFF TRACK）内联呈现在 Go/No-Go 章节中。若结论为 OFF TRACK，会先询问用户选择接受 NO-GO、覆盖为 CONDITIONAL GO 还是先解决阻塞停止；若为 AT RISK，则询问 Go/No-Go 章节如何框定（CONDITIONAL GO / NO-GO / GO）；若为 NOT ASSESSED，会指明缺失输入，不得据此推荐 GO。技能规定不得在 OFF TRACK 下给出 GO，只有在用户明确选择覆盖时才可给出 CONDITIONAL GO。

使用方式

该技能以斜杠命令形式调用，参数为里程碑名称，或使用 current 指代当前里程碑。运行完成后，技能会先把报告呈现给用户，再询问“是否写入 production/milestones/[milestone-name]-review.md”。用户同意则写入文件（必要时创建目录），裁定为 COMPLETE；拒绝则停止，裁定为 BLOCKED。后续步骤建议：若该里程碑标志开发阶段边界，可运行 /gate-check 获取正式阶段门禁裁定；可运行 /sprint-plan 依据范围建议调整下一个冲刺（在 workflow: minimal 下没有冲刺，则改为调整 brief 的构建顺序）。

适用场景

  • 里程碑检查点或截止日期前的进度评审。
  • 需要判断项目是否可以继续、是否需缩减范围或延迟交付时。
  • 需要一份包含完成度、质量、风险、速度与行动项的结构化审查文档时。

限制与注意事项

  • 审查严格依赖已有输入产物。里程碑定义、风险登记等目录通常没有技能自动写入，缺失是常态。
  • 缺失输入不会被估算或推断：相关章节一律 NOT ASSESSED — NO DATA，且不得据此推荐 GO。
  • 报告中的审查模式、自动化行为、门禁定义分别参考 .claude/docs/config-resolution.md、.claude/docs/automation-modes.md、.claude/docs/director-gates.md 及其子文件。
  • 该技能面向 claude-code-game-studios 工作流，具体配置项取值需以项目内的配置文件为准；本介绍未提供的收费、价格、平台与版本信息，暂未提供。