编程 Agent 的 Plan-First 工作流：避免「改完才发现没做完」

Chat 编程快起来很快——直到它不快了。

你提一个需求，Agent 直接跳进文件里一通修改，然后甩给你一堆改动和一个耸肩。两场会话撞上同一批路径，自动合并要么让人胆战心惊，要么需要全程盯着以至于你根本离不开键盘。

我想要另一种形态：

模糊的目标进来 → 经过 review 的 PR 出去——只有真正需要你的时候才出现。

没有共识的"完成"定义——Agent 优化的是"改了多少文件"，而不是"接受了什么结果"。

并行工作没有隔离——改动重叠，合并痛苦。

不受信任的自动化——静默合并比不合并更糟。

Loomwright 的做法

Loomwright 是一个 Claude Code 插件（不是 Cursor 原生插件）。Marketplace id 是 atelier，plugin id 是 loomwright。

Launch Pad 先写一份简报（可行性、文件影响、子任务），再让 Supervisor 动仓库。

Workers 在 git worktree 中运行；重叠的文件等待；合并保持有序。

默认行为：停在一个经过 review 的 PR 上——不会静默发布。

可选的 --auto-merge 仅在信任 gate 后面才会启用。

/setup
/autonomous "the next thing your users can feel"

完成的标志：/setup 打印一张模块状态表（所有项都是可选的）。/autonomous 会问几个探索性问题，把简报保存到 .supervisor/jobs/pending/，在 worktree 中完成工作，最后以一个 AUTONOMOUS_RUN 总结和一个待 open 的 PR 结束——它永远不会自己合并。

网站：https://vikashruhilgit.github.io/loomwright-site/ GitHub：https://github.com/vikashruhilgit/loomwright

我仍然不确定的地方

很好奇大家都是怎么处理的：

Review gate 应该对照简报的验收标准做 diff，还是保持基于存在性/测试的方式？

信任是否应该是路径感知的（auth/payments/migrations 永远手动）？

如果你也遇到过同样的墙，我很想听听最让你头疼的失败模式：没有计划、合并冲突、还是不受信任的自动合并。目前大致规模是：14 个 agent 角色、21 个斜杠命令、41 个 skill、24 个质量 hook。

claude plugin marketplace add vikashruhilgit/loomwright
claude plugin install loomwright@atelier
claude plugin list   # loomwright@atelier, Status: ✔ enabled