延伸自 流程是怎么变重的:从 Superpowers 到三套框架
· 约 5 分钟
三套框架各管什么:Superpowers 的设计和计划,GSD 与 gstack
4 月三套框架一起用时各管一段。Superpowers 留下设计和计划两类文档,设计只定规则和边界,计划拆成任务、每步先写会失败的测试;GSD 管会话之间的进度;gstack 后来只留在浏览器测试和设计复查里。
本文回答的问题
三套框架当时各管哪一段,设计和计划具体怎么写?
主线第 1 篇写到,4 月我把 Superpowers、GSD 和 gstack 叠在一起用。这篇分开写三套各管哪一段,以及 Superpowers 的设计和计划当时具体怎么写。
三套各管一段
Superpowers 管的是从需求到实现这一段:先澄清需求、写设计,再拆计划、按计划执行。我从 3 月前后开始用它。主线里那个实习项目,3 月 26 日到 4 月 15 日在仓库里留下了 25 份文档:设计 11 份,计划目录里 13 份,另有一份单独的说明。4 月 15 日以后,这个目录里没有再出现新的设计和计划。
GSD(项目名 get-shit-done)管的是会话之间的进度。它用 STATE、CONTEXT 等文件记下做到哪、定了什么,换了会话照着这些文件接着做;研究、规划和执行交给子代理。我装的是 1.34.2 版,光子代理定义就有 24 个,研究、规划、执行、验证、代码审查、UI 审查各有专门的一个。5 月 7 日清理掉它留下的文件以后,就没再用过。
gstack 把开发拆成规划、审查、测试、发布等环节,每个环节都有专门的 Skill,测试时用真实的浏览器检查流程能不能走通。Superpowers 和 GSD 停掉以后,它只留在浏览器测试、设计复查这类场景里。
设计只定规则和边界
按当时(3 月 24 日版)的 brainstorming 模板,设计写在动手前,设计没经我同意之前不写代码。模板列的要点是架构、组件、数据流、错误处理和测试。
那 11 份设计没有照这几项分节,没有一份用架构、组件这类小标题。拿一份讲新统计规则的设计来说,13 节从背景、目标写起,接着是什么情况下启用、不启用时怎么处理、规则怎么定义、缺考和异常怎么算、排名和展示口径、导入要求和命名约束,最后是兼容边界、测试范围和实施边界。整份没有一段代码,写的都是规则怎么定、边界划在哪。11 份里出现最多的小标题是“背景”和“目标”,其次是“这次要解决什么”和“这次不做什么”。
计划拆到每一步
设计定下来,再写计划。writing-plans 模板要求计划开头写目标、思路和技术栈,下面拆成 Task 1、Task 2……每个任务先列要动的文件,再分成 2 到 5 分钟一步的小步,每步给出完整的代码、命令和预期结果,不许写“待定”或者“同 Task N”。模板给每个任务的步骤是这样的:
计划目录里的 13 份,7 份照这个模板拆到了每一步,两份只拆了任务没分步,一份有模板开头但没拆任务。这个模板后来改过,9 月 25 日的 v6.4.2 把计划改得精简了:重点放在文件、接口、测试断言这些已经定下来的东西上,避免写计划时把整个实现先写一遍。
做完以后补一份记录
计划目录里还有三份不按模板写。一份是方案,末尾加了一段落地补记。另外两份前面没有设计,也没有计划,是改动做完以后补的短记录,这种写法 Superpowers 的模板里没有。其中一份记背景、这次怎么处理、校验结果和当前状态;最短的一份不到 1 KB,只有四节:这一轮落地了什么、牵动到哪些地方、有什么限制、改了哪些文件。
参考资料
- obra/superpowers
- Superpowers 3 月 24 日版模板:writing-plans、brainstorming
- Superpowers RELEASE-NOTES(固定提交)
- gsd-build/get-shit-done(已归档)与 open-gsd/gsd-core
- garrytan/gstack
本文涉及的知识点
6 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。
本节知识点
本节知识点