跳到正文
  1. Wiki
  2. 原则
  3. 24 条原则

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 就一定照做了」:看它回复里有没有说,这条原则改了哪个决定。

动手操作:它跑偏了,一句话拉回来

相关条目:/pstack:poteto-mode、证据(而不是「应该好了」)

本站是 pstack 的非官方入门教程,不是官方文档;pstack 由 poteto 开发,命令和行为以官方仓库为准。教程原始源码见 GitHub。

由 airali部署,基于小小东的 MIT 授权教程改编。