2026-06-23 · repository-refactor

一晚上自主重构项目

长时间无值守重构能拆成适中 PR,而不是一个不可 review 大改。

The operator can wake up to reviewable PR-sized refactor slices instead of a single giant autonomous diff.

refactorPR slicestodo evidence
LoopX 一晚上自主重构项目 loop public safe pattern case goal / trigger todo / gate / evidence public outcome
01

案例背景

这个案例解决的是无人值守重构的风险:长时间 agent 容易把 cleanup、行为改变、发现的新问题和过期计划混成一个大 diff。

LoopX 的公开证据不是某个私有夜间截图,而是 todo lifecycle、successor/supersede、validation writeback 和 review-packet 这些已经在仓库里有文档和 smoke 的控制面。`todo-lifecycle-cli-smoke.py` 里能看到 successor、supersede、handoff 和 self-merge 的完整回归覆盖。

02

仓库证据

证明点

无人值守 refactor 可以拆成 PR-sized slice。

LoopX 介入

loop、todo follow-up、supersede、PR-sized slices

1一次一个 PR-sized slice
3successor/supersede/handoff 路线
1宽风险 review gate
0巨型 diff 目标
successor path

`docs/lark-kanban-control-plane-adapter.md` 明确 real successor 使用 `todo complete --next-*`,replacement 或 narrower split 使用 `todo supersede --next-agent-todo`。

side-agent completion

`docs/heartbeat-automation-prompt.md` 要求非平凡完成创建 successor todo 或写 no-follow-up rationale。

CLI validation

`examples/todo-lifecycle-cli-smoke.py` 覆盖 `--next-agent-todo` successor、`todo supersede`、claim 继承、handoff successor、same-agent handoff rejection 和 side-agent self-merge evidence。

review shape

`loopx review-packet` 把当前 open todo、claimed_by 和 handoff 状态打包成 reviewer 可读的 packet。

03

LoopX 行为

04

用户看到什么

用户可以让重构跑过夜,但早上看到的是一组有边界的 review 单元和剩余 todo,而不是一个不可 review 的巨型改动。

项目可以继续快,但 review 面仍是人能处理的粒度。

05

仓库来源

证据边界. Public-safe pattern case only; no private screenshots, raw chats, internal planning notes, local paths, credentials, raw logs, or unpublished project artifacts.