一次框架迁移
一次对 DWP 为之而生的工作的示范演示:一次横跨数十个文件、历时数小时的迁移——长到一个没有引导的代理会丢失头绪。
目标
One big change → ordered, gated tasks
Without a plan
Big migration ✗ Build fails
As a Deep Work Plan
- Task 1
- Task 2
- Task 3
- Task 4
- Task 5
“在整个服务范围内,把数据层从遗留的 ORM 迁移到新的 ORM。”
没有计划时
一个代理不断编辑模型,直到它的上下文被半成品的改动填满,忘记自己已经转换过哪些调用点,并让构建一片飘红、却没有任何关于剩下什么的记录。恢复意味着要从一份聊天日志中重建它自己的思路。
作为一份 Deep Work Plan
/dwp-create 把目标分解为原子化、有序的任务,每项都带有验收标准与验证关卡:
- 在旧 ORM 之外引入新 ORM(无行为变更;关卡:构建 + 测试通过)。
- 迁移模块 A 的模型与调用点(关卡:模块 A 测试通过)。
- 逐模块重复,每个一项任务——每项任务后记录进展。
- 移除遗留的 ORM 及其垫片(关卡:不再有任何引用;完整套件通过)。
- 更新文档与各模块的 README。
/dwp-execute 按顺序运行这些任务,在每一道通过的关卡后提交,并更新 PROGRESS.md。若上下文窗口在中途被重置,/dwp-resume 会从磁盘读取计划与进展,并在下一项未勾选的任务处继续。
成果
这次迁移以一系列小而可审阅、逐个经过验证的提交落地——并能在中断中存续,因为是计划、而非对话,才是事实来源。