用途:对一个已完成的史诗做回顾,读取它留下的证据——史诗规格、故事文件、完整 diff、逐故事提交、sprint 状态、会话日志(若存在),识别单个故事看不到的缺陷,并按史诗自设的标准评判。每条发现必须带来源引用(文件、行、提交或日志);无法指认来源的结论不算发现。
两种形态:sprint 模式读 sprint-status.yaml;stories 模式读含 SPEC.md、有序 stories.yaml 和 stories/<id>-*.md 的规格目录。
主要能力:按阶段运行——Phase 1 收集证据并记录缺失;Phase 2 从聚合视图与 diff 范围审查产生发现,代码视角委托 bmad-review;Phase 3 团队讨论(可选,headless 不运行);Phase 4 生成行动项与验收判定(accepted、accepted-with-open-items、rejected);Phase 5 定稿文档并更新 sprint 状态。回顾文档即工作产物,支持中断后续跑。
用法:交互模式为默认;-H/--headless 跳过确认,-H <epic> 为面向编排的稳定接口。检测命令示例:uv run --no-cache {skill-root}/scripts/sprint_status.py detect-epic --file {implementation_artifacts}/sprint-status.yaml --epic <N>。
限制:不改代码,不自动套用修复,行动项由人决定;headless 下无法确认的假定写入 Assumptions。完整实现细节、脚本参数与文档章节以官方资料为准。