让 AI 先写实施计划再动手

superpowers 核心技能 · writing-plans

一句话: 设计定了也别急着写代码. 先让 AI 出一份"换个不懂你项目的人也能照做"的实施计划.

场景: 给后台加"导出月度对账单"

财务要个功能: 后台点一下, 导出某月对账单 Excel(订单号, 金额, 手续费, 退款, 净收入). 涉及 查订单库 -> 算手续费 -> 生成 Excel -> 加下载接口 好几步. 直接让 AI"写个导出对账单", 它容易漏掉退款冲减, 或把手续费算错, 来回返工.

怎么对 AI 说

要可执行的计划, 不要泛泛步骤:

用 writing-plans 给"导出月度对账单 Excel"写实施计划:
精确到改哪个文件哪几行, 每步带完整代码, 跑什么命令, 预期输出. 先给我看计划, 别写实现.

审计划按四个字挑刺: DRY, YAGNI, TDD, 勤提交. 看到"算一下手续费"这种含糊话, 让它写成可照抄的代码和测试用例.

它会怎么跟你走

它把"导出对账单"拆成一串小步: 写"查某月订单"的测试 -> 实现 -> 写"手续费计算(含退款冲减)"的测试 -> 实现 -> 生成 Excel -> 加下载接口 -> 各自提交. 每步标明改哪个文件, 完整代码, 跑什么命令, 预期输出. 计划落到 docs/plans 文档. 写完它问你: 本会话用子代理执行, 还是另开会话.

一句话记住

writing-plans = 让 AI 先把活儿拆成"照着敲就行"的步骤清单. 像"导出对账单"这种多步骤功能, 先让它把每步的文件/代码/口径写清, 看到含糊话就打回.