wrap-up 用于用户必须立即离开的场景,把会话自身及子代理正在进行的工作转化为“已固化的完成项”或“决策完整的交接”,尽量不丢进度。它优先考虑耗时而非打磨,默认目标约五分钟完成;若存在 $ARGUMENTS,会将其作为用户截止时间或离开说明,明确的截止时间会覆盖默认预算。单代理会话跳过 Worker Wind-Down,直接对会话自身进行中的工作套用同样规则。
冻结阶段立即执行:不启动新的子代理、批次或范围;把排队或未开始的工作重新归类为交接中的剩余工作;停止向新文件或子系统扩展,只完成当前编辑以免文件残缺;不启动新的长时间验证,未验证的声明记录为未验证。
Worker Wind-Down 阶段:用宿主代理列表枚举活跃子代理,并通过对应消息工具(Claude Code 用 SendMessage,Codex CLI 用原生子代理消息工具)向每个可消息的 worker 发送收尾指令:完成最小安全单元、不新开工作、跳过剩余验证并报告已运行与已跳过内容,回复字段包括 status、summary、changed files、verification、remaining work、risks/blockers。给可消息 worker 两到三分钟软截止时间;截止时间只限制等待时长,绝不作为取消 worker 的许可。截止时仍活跃的 worker 记为 active-unsettled,保留其代理、子进程与监视器,记录其范围与超时条件,不重建结果、不启动替代工作。
固化阶段:用 git status --short 和 git diff --stat 盘点工作树,按 wrap-up 报告将变更映射到工作流并分类为 completed、partial 或 untouched。排除 active-unsettled 范围,不将其纳入验证、暂存或提交。遵循会话现有提交策略:已授权提交时,将每个已完成且已验证的工作流作为独立小提交提交;部分工作保持未提交但在交接中完整描述;不运行可能卷入无关或并发工作的全树 git 命令,也不提交半应用变更。
交接阶段:综合自身工作与所有 wrap-up 报告,形成状态图,说明完成了什么、部分工作进展到何处(以稳定路径和符号定位而非行号)、剩余内容、未验证声明与已知阻塞。调用 task-handoff 技能($task-handoff),默认一个交接;仅当剩余工作流结果或负责人独立时才用协调式交接。若该技能不可用,则在最终报告中给出同样决策完整的内容。对每个 active-unsettled worker,将其结算与结果核对设为恢复编辑的前置条件。最后以 “### 🏁 Wrap-up — session parked” 开头,紧凑报告已完成工作流及其提交 OID、部分工作流停止点、active-unsettled worker 的结算条件、task-handoff 报告中的交接命令原文,以及始终存在的风险行(无则为 none)。