大部分改动不用先设计
要改好几处时,/pstack:poteto-mode 会自己先设计。想让它多想一步,再点名下面的技能。
- 1定设计/pstack:architect、/pstack:arena、做原型
- 2动手说你看到了什么;好写测试就 /pstack:tdd
- 3挑刺/pstack:interrogate 只留真跑出来的问题
- 4清理/pstack:unslop、/pstack:no-comments
要改好几处:/pstack:architect
/pstack:architect 先设计导入流程,别急着写代码。我最在意调用方怎么用。你会得到:几个设计方案比一比,每个都先写「调用的人怎么用」。选中的那个,它接着就写。想先看设计,加一句「with checkpoint,实现之前停下来给我看」。
照着设计写的时候,发现有地方对不上,它会停下来说。设计本身错了,它会整个推倒重来,不在错的设计上打补丁。这是正常的。
一个决定拿不准:/pstack:arena
用在起名、格式、算法这种以后很难改的决定上。
/pstack:arena 这个缓存键的格式以后很难改,来 5 个方案。你会得到:几个 AI 各写一份,另一个系列的模型来打分(比如 Claude 换成 Grok)。分最高的当底子,别的好点子补进来。
写完了想挑刺:/pstack:interrogate
/pstack:interrogate 审一下整个分支,挑剔一点。除非是真 bug 或行为倒退,别报小毛病。你会得到:只留下用命令真跑出了失败的问题。它不改代码。它丢掉的问题也会列出来,这一栏也要看,丢错了就让它再查。
争不出结果,就做原型
/pstack:poteto-mode 给新的下拉菜单做几个原型。截图或者录屏给我比较。你会得到:几个用完就扔的草稿,各自截图或计时,放在一起给你挑。界面、行为、算法都能这么比。
写计划也一样。拿不准的地方先做个原型,看到结果再写进计划。一次都没试过的计划,写得再细也可能是错的。
大功能:先写教程,再定设计
(1) /pstack:recall 我这 7 天修虚拟列表 bug 和性能问题的记录。用 /pstack:how 和 /pstack:why 弄懂现在的虚拟列表是怎么实现的。
(2) 然后用 /pstack:poteto-mode 做规划,配合 /pstack:technical-writing,设计一个从根上消除闪烁和抖动的新引擎。先写一篇教程,讲我会怎么用这个新包给 React 应用做虚拟列表。
(3) 计划写完后,/pstack:teach 我,并证明给我看新方案为什么比现在的好。三段各管一件事:
- 找回背景:你修过的 bug、现在的实现,就是新设计要解决的问题。
- 从用法倒推设计:先写别人会怎么用它,好不好用一眼就能看出来。
- 要它证明:只讲道理不够,要拿出对比。项目里有验证技能,它才拿得出真的证据。
第 3 步说过,别在提示词里给它排技能。那是小事。像这样的大设计,作者自己就按段点名技能,每段只点这一段要用的。
动手时,说你看到了什么
- 修 bug:说症状,加「先复现」。例:「重试之后会写两条记录。先复现,再修,再验证。」
- 加功能:说什么不能变。例:「加一个 –json 参数,文本输出一点都不能变。」
- 重构:说行为不变。例:「先录下现在的输出,改完证明没变。」
- 查慢:给测出来的数字。例:「启动要 1.8 秒。抓一下轨迹,给我前后对比。」
bug 在本地能用测试抓到时,打:
/pstack:tdd implement你会得到:先有一个失败的测试,修完再跑,看它通过。
改 TypeScript 时,点名 /pstack:typescript-best-practices。它不会自己加载。
交出去之前,清理一遍
- 文字:
/pstack:unslop去掉 AI 腔,也能加规矩:/pstack:unslop 改一下 README 的新内容,不要破折号。 - 注释:
/pstack:no-comments派一个没写这段代码的 AI 审注释,只留真正需要的。 - 代码:直接说「删掉解说性的注释、没有依据的防御判断、死掉的兼容代码、和这次无关的改动。」
卡住了?
它直接用了第一个方案,没给我选。
说「先别定,做两三个原型并排比较」。也可以打 exhaust the design space,意思是「把方案都试一遍」。这是 pstack 认识的原则名,原样打出来它就懂。
我想让它写个计划再动手。
设计定了以后说:/pstack:poteto-mode 把这个设计写成计划。拆成可以单独验证的小 PR,每个都带验证步骤。它只写计划,不动手。PR 就是一组交给别人审的改动。
/pstack:swarm 和 /pstack:arena 有什么不一样?
/pstack:arena 让几个 AI 做同一件事,比出最好的。/pstack:swarm 把大活切成几块分给几个 AI。详见 /pstack:arena 和 /pstack:swarm 的区别。
做到这里,检查一下
✓ 都勾上了,可以去下一步。