用途:为工作收尾提供结构化流程,分两种意图——完成里程碑(Ship)或中途暂停(Handoff)。Ship 会生成含统计数据的回顾并归档里程碑;Handoff 会压缩当前状态,便于后续会话无缝恢复。
适用时机:里程碑所有阶段完成、byterover-progress 提示可完成、需要中途暂停稍后继续、开始新里程碑周期前、冲刺或开发周期结束时。
前置条件:先运行 brv status;若出错,需让用户在 brv 终端解决,详见 byterover 技能的 TROUBLESHOOTING.md。
主要流程:
- 确定意图:询问用户是完成里程碑还是暂停工作。
- 飞行前审计(仅 Ship):用 brv query 查询当前里程碑、需求、路线图、已完成阶段摘要及待办事项;检查阶段是否全部完成、有无关键待办,并运行项目测试(如 npm test、pytest)。
- 回顾与统计(仅 Ship):用 git log、git diff 统计提交与文件变更,用 brv query 提取各阶段成果并展示回顾。
- 项目演进与归档(仅 Ship):迁移需求状态、更新项目描述、记录技术债与关键决策,用 brv curate 存储里程碑记录,可选创建 git tag(需先询问用户)。
- 工作交接(仅 Pause):收集位置、已完成、剩余、决策、阻塞与下一步动作,用 brv curate 压缩存储交接内容。
完成提示:Ship 完成后提示运行 byterover-milestone 规划下一里程碑;Pause 后提示运行 byterover-progress 恢复。
重要规则:发布前须验证阶段完成与测试通过;成果描述要具体;跟踪需求状态;交接须可恢复;git tag 可选不强制;里程碑记录永久保存;每次 curate 最多 5 个文件;绝不读取密钥文件;关键上下文存储后用 brv curate view <logId> 验证。