用途:在功能的所有必需子任务完成后,关闭实现工作流,对已接受设计、实际代码与测试、持久文档、决策和必需验证做唯一一次最终对账,并安全交付,避免交付后产生 Git 记账提交。
主要能力:通过 dstack ctl feature finish-workstream、claim-closeout、scaffold-reconciliation 完成收尾;对账真实行为与文档,确认测试覆盖外部可观察行为、不变量、失败处理和回归边界;对最终用户/运维、开发者/评审、未来智能体/审计者三类文档影响面逐一核对。文档只描述计划/已实现内容、原因和方式,不得含临时工作流状态或 ID。每个对账脚手架段落须有实质内容或写 Not applicable — <具体原因>,占位符、重复/缺失标题、不支持的本地链接会在收尾变更前失败。
使用方式:显式传入选定的已授权功能根目录,省略仅在其注册的功能工作树中安全。输入模式为 ready(默认)、pr 或 merge。运行仓库完整/发布验证,并在任何修复或 rebase 后审查完整候选 diff;若必需检查失败、超时、被中断、范围错误、意外跳过必需测试或替代为更弱覆盖,报告确切命令、范围与结果,并在 finish-closeout 或交付前停止。修正实质发现、重跑受影响检查,仅提交真实代码/文档变更并带收尾 Bead 页脚。随后运行 dstack ctl docs validate 与 feature finish-closeout。交付:ready 模式运行 delivery inspect 并保持根目录打开;pr 模式运行 pr-preflight,从完整提交序列和聚合 diff 起草标题/正文,获得用户批准后保存正文并用 --title 与 --body-file 重跑 preflight,再推送/创建 PR 并运行 delivery register-pr --pr-number <n>,后续调用运行 delivery finalize-pr;merge 模式运行 delivery merge。
限制:控制器要求线性祖先、PR 基态同步、工作树干净、无临时文档违规。交付前允许 rebase、amend 和终端修复提交;最终终端页脚必须可达,收尾后提交须带该页脚。文档只属于此最终对账。正常交付期间 Beads 终结不得改动已交付 Git 状态或创建记账提交。失败或错误交付后经用户明确授权的恢复是独立的原生 Git 操作。