一晚上自主重构项目
The operator can wake up to reviewable PR-sized refactor slices instead of a single giant autonomous diff.
案例背景
这个案例解决的是无人值守重构的风险:长时间 agent 容易把 cleanup、行为改变、发现的新问题和过期计划混成一个大 diff。
LoopX 的公开证据不是某个私有夜间截图,而是 todo lifecycle、successor/supersede、validation writeback 和 review-packet 这些已经在仓库里有文档和 smoke 的控制面。`todo-lifecycle-cli-smoke.py` 里能看到 successor、supersede、handoff 和 self-merge 的完整回归覆盖。
仓库证据
无人值守 refactor 可以拆成 PR-sized slice。
loop、todo follow-up、supersede、PR-sized slices
`docs/lark-kanban-control-plane-adapter.md` 明确 real successor 使用 `todo complete --next-*`,replacement 或 narrower split 使用 `todo supersede --next-agent-todo`。
`docs/heartbeat-automation-prompt.md` 要求非平凡完成创建 successor todo 或写 no-follow-up rationale。
`examples/todo-lifecycle-cli-smoke.py` 覆盖 `--next-agent-todo` successor、`todo supersede`、claim 继承、handoff successor、same-agent handoff rejection 和 side-agent self-merge evidence。
`loopx review-packet` 把当前 open todo、claimed_by 和 handoff 状态打包成 reviewer 可读的 packet。
LoopX 行为
- 1当前 refactor slice 必须是可 review 的单位,不把整夜发现都塞进一个 PR。
- 2发现的新工作写成 follow-up todo;路线变了就 supersede 旧 todo。
- 3每个 slice 用 focused validation 或文档/contract smoke 证明,而不是依赖原始 agent trace。
- 4大范围或风险不清楚的 slice 不自合并,进入 review handoff。
用户看到什么
用户可以让重构跑过夜,但早上看到的是一组有边界的 review 单元和剩余 todo,而不是一个不可 review 的巨型改动。
项目可以继续快,但 review 面仍是人能处理的粒度。
仓库来源
docs/lark-kanban-control-plane-adapter.mdheartbeat prompt contractdocs/heartbeat-automation-prompt.mdtodo lifecycle smokeexamples/todo-lifecycle-cli-smoke.pycase narrativedocs/showcases/cases/0623-overnight-project-refactor.md证据边界. Public-safe pattern case only; no private screenshots, raw chats, internal planning notes, local paths, credentials, raw logs, or unpublished project artifacts.