用途:Slate v2 AR 工作流中的交付/就绪检查技能,帮助把 AR 工作整理为可评审或可提交的状态。它不等同于“提交所有内容”,除非用户明确要求提交。
主要能力:加载 slate-ar 与 slate-ar-finalize;默认无参数路径先运行 finalize 预览,判断保留的 AR 证据还是当前树评审才是真实评审单元;若当前树是真实单元且脏状态阻塞 finalize,则走 pre-commit 评审路径;报告推荐评审单元;在用户要求 ship、review、commit 或脏当前树需要提交前信心时运行证明门禁;在提交/PR 前对未提交当前树运行 autoreview;仅在证明/评审足够干净或明确阻塞并接受残余风险时暂停并显示 READY TO COMMIT;用自然语言请求提交批准。
使用方式:直接运行 slate-ar-ship 即可,无需记忆 current-tree、review 或 commit current-tree 参数。允许运行非变更性就绪工作(finalize 预览、当前树 finalize 预览、聚焦门禁、autoreview),但未经用户明确要求不得提交、建分支、清理、推送或开 PR。必须让操作者留在源分支(通常 v2),不得创建 autoresearch-review/* 分支。READY TO COMMIT 后,简短确认如 yes、go、commit、ok 即视为继续同一流程的明确批准,覆盖提交已评审的当前树工作及重跑当前树就绪预览,但不批准建评审分支、推送、PR、分支清理或破坏性清理。
适用场景:当前树 finalize 适用于有用工作被打包、修正或回滚在保留 AR 包之外,分支有许多有意纳入评审的未保留提交,或保留包 finalize 会隐藏真实评审单元时。默认流程中当前树 finalize 仅指 finalize-current-tree --exclude-session-artifacts 的预览/就绪,不运行 finalize-autoresearch.mjs <plan>,除非用户明确要求创建评审分支。
限制:提交前将脏文件分类为评审单元文件与 AR 会话产物(autoresearch.、autoresearch.research/**、dashboard 导出、生成的 finalize 临时文件),finalize 默认排除会话产物。提交已评审当前树工作,不包含 AR 会话产物,除非用户明确要求。若未提交会话产物会使源分支在评审单元提交后仍脏,则先 stash 再重跑当前树 finalize 并报告,不得删除。提交后不得创建 autoresearch-review/ 评审分支,除非用户明确要求。推送与 PR 仍需 finalize 后用户明确批准。交接时报告推荐评审单元、finalize 警告、门禁与 autoreview 状态、READY TO COMMIT、提交/就绪预览后是否仍需推送/PR 批准、阻塞项或残余风险。