24 条原则
pstack 把工程经验写成 24 条短原则。AI 跑偏时,你说出名字就能把它拉回来。
打个比方
像球队的战术暗号。教练喊一声,全队就知道该干什么。
在 pstack 里
你不用调用原则,/pstack:poteto-mode 每次开工都会读。原则名是给你纠偏用的。比如它只因为编译通过,就说成功了。你可以回:「apply prove it works. 跑一遍真实的导入流程,给我看写进去的记录。」它的回复要说出这条原则改了哪个决定,说不出就是没真用。
作者建议别背。现在扫一眼就行。等 AI 犯了某条原则能防住的错,再回来查。这样记得最牢。
全部 24 条(英文名原样打出来,AI 才认得)
| 名字 | 说人话 |
|---|---|
| laziness protocol | 核心 · 能删就删,改动越小越好 |
| foundational thinking | 核心 · 先选对数据结构,再写逻辑 |
| redesign from first principles | 核心 · 当它第一天就在,重新设计 |
| attack the premise | 核心 · 修两次都不行,先查前提 |
| subtract before you add | 核心 · 先删没用的,再加新的 |
| minimize reader load | 核心 · 让读代码的人少跳少记 |
| outcome-oriented execution | 核心 · 直奔目标,不写过渡代码 |
| experience first | 核心 · 用户体验优先,少而精 |
| exhaust the design space | 核心 · 没先例时,做几个原型比一比 |
| build the lever | 核心 · 做个工具,别手工重复 |
| model the domain | 架构 · 业务规则集中放,别散成 if |
| boundary discipline | 架构 · 在入口处检查外来数据 |
| type system discipline | 架构 · 让错误状态根本写不出来 |
| make operations idempotent | 架构 · 跑一半、跑几次,结果都一样 |
| migrate callers then delete legacy apis | 架构 · 改完调用处,马上删旧接口 |
| separate before serializing shared state | 架构 · 先拆开共享,不行再加锁 |
| prove it works | 验证 · 拿真东西证明,编译过不算 |
| fix root causes | 验证 · 找到最早出错的地方再修 |
| sequence verifiable units | 验证 · 切小块,验过一块再做下一块 |
| test behavior not implementation | 验证 · 测用户看得到的表现 |
| explain the number | 验证 · 先弄清是什么限制了这个数 |
| guard the context window | 分工 · 大量阅读交给帮手 AI |
| never block on the human | 分工 · 能撤回的先做,不可逆的先问 |
| encode lessons in structure | 元原则 · 同一句提醒说两次,就写成检查 |
常见误区
- 「原则要一条条点名调用」:不用,
/pstack:poteto-mode每次都会读。名字是给你纠偏用的。 - 「说了原则名,AI 就一定照做了」:看它回复里有没有说,这条原则改了哪个决定。
动手操作:它跑偏了,一句话拉回来