Files
Agent-System/.doc/ops/templates/session-close-checklist.md
T
weichen fed87ad14b feat(governance): enforce managed worktrees and scoped agent operations
Consolidate approved policies and add local lease, document CAS, commit, candidate and environment gates. Preserve conservative recovery and cleanup limits.
2026-09-21 14:41:40 +00:00

2.3 KiB
Raw Blame History

会话结束与任务收口清单

每次结束会话或切换 Agent 使用;不要求为了结束会话完成未授权的实施、部署或推送。小任务可将检查结果并入主文档。

状态与证据

  • 主文档状态符合实际:planned | in_progress | blocked | done | cancelled;只有授权范围内验收满足才 done。
  • 分别记录 review_state、integration_state、deployment、cleanup、remote_sync;代码已合入但部署 failed 不报交付完成。
  • 验证范围按 验证契约;保存实际命令、SHA、环境、结果和缺项,敏感材料最小化/脱敏。
  • 本次影响、关联文档、剩余工作/接管条件在主文档或 handoff 中可恢复。

认领、集成与环境

  • CURRENT 增量更新为实际状态;保留活跃/阻塞/待集成/待清理事项,只有已终态且无后续阻塞的认领转历史。
  • 所持执行租约、mutex 与槽位按实际操作结束释放;共享环境 E2E 未结束不释放。异常退出按操作规范核查进程与恢复,不仅修改 Markdown。
  • 本地提交、dev 合入、实际运行版本、远端同步分别有证据;未合入/未部署记录原因,文档可记 deployment=not_required。
  • 仅用户已授权同步远端时完成 push;未授权记 remote_sync=not_requested。

清理与归档

  • 按 操作规范 核对 dev 祖先、验收、文件/唯一 ignored 证据、进程、保护项;普通 remove/-d 拒绝则保留,不强删。
  • cleanup 未完成时有 cleanup_owner、保留原因、证据位置、可观测复查触发;owner 退出后由独立集成/维护执行者复查。
  • 可再生缓存与唯一证据分开处理;唯一日志/截图已持久保存,不能仅留下即将删除的路径。
  • 只有 done/cancelled 任务归档;移动时修复相对链接并保留历史。未完成任务保留原状态,不为归档改 done。
  • 仅模块声明变化时更新 FEATURE-MATRIX,仅 blocker 变化时更新 gap-matrix;CURRENT 焦点最多 3 条。
  • 实现与相应证据形成可解释、可验证、可回退的逻辑提交;无三大主干直接开发提交。