我一直不认同那种「把需求丢进去、等它直接给出结果」的 Vibe Coding。一旦中间出了问题，你连哪一步错的都说不清。结果还要让 AI 帮你排查修复。这正是很多开发者常碰到的痛点——缺乏可审计的过程、调试成本高、失去对代码生成的控制。

一、设计内核

再看目标，可预测。而不是「做小」

痛点：大多数 AI 编码方案只能一次性输出代码，导致后期难以定位错误、无法保证交付质量。Matt Pocock 的思路是把流程而非结果设为可预测。

「可预测」要说准一点：可预测的是流程，不是结果。模型输出本身就是随机的，同一个需求跑两遍。spec 和代码的细节难免有出入；但如果流程能稳住产出的随机就不会失控——每一步都落在一个你能审查的节点上。一旦跑偏，当场就能纠正，而不是拖到后来才明白。

还有一点容易误解：以为「可预测」就是「把每个 skill 做到尽量小」。其实做小只是可预测带来的结果。这一点很关键——它是后面所有取舍的依据：手段怎么选、机制怎么分、一个 skill 合不合格，最终都落到一句「它有没有让流程更可预测」。

说到手段，原语 + 手动编排

痛点：传统框架往往「接管整条流程」。导致开发者失去对关键环节的掌控，一旦出现异常只能求助于框架或模型，调试成本飙升。

要让流程可预测，开头那种「丢进去、等结果」显然不行；一个直觉的解法，是套个框架约束流程。GSD、BMAD、Spec‑Kit 走的就是这条路。而且做得并不差：分阶段，阶段之间也留了检查点，这点和这套 skill 一致。真正的分歧在于，框架的路子是「接管整条流程」——流程一旦交给它。控制权也跟着让了出去，出了问题也很难自己改。

这套 skill 把能力拆成一个个小而单一的原语，由你自己拼成流程：grill → to-spec → to-tickets → implement。哪步不对就单换那一步，控制权始终在你手里这正是「可预测」逼出来的走法。按理说，

至于原语该切多细、哪一步交给模型、哪一步留给自己——下面三条机制回答。不过，

从机制一来看。触发方式

痛点：拆得太细会产生上下文膨胀和记忆负担；不过，拆得太粗又失去细粒度控制。

先说拆不拆——这是一笔成本账。

• 上下文成本: 能被模型自动触发的 skill，它的描述每轮对话都占着；只要它在就一直占着，
• 记忆成本: 要你手动触发的 skill 不占窗口，但代价落到你的脑子里——你得记得它在、记得什么时候该用。

从拆不拆是笔账来看。多拆出来的那点可预测，值不值这两笔成本。原语该多大，就是这笔账的平衡点。算下来的规则很简单——机械、能反复用的固定做法交给模型自动触发。只有靠人拍板的决策留作手动触发.

按触发方式区分类型：

• #disable-model-invocation: 模型不会主动调，只能手动触发；这些 skill 之间也不会互相调用。话说回来，
• No restriction: 模型可以自动触发，也可以被其他 skill 调用，这类属于可复用的固定做法，即原语，例如 grilling.

说到机制二。安全靠中间产物，由人来否决

痛点：A​I 输出直接写入代码库时缺少审查环节，一旦错误进入主线修复代价巨大。

每一步都会留下中间产物——澄清后的想法、spec、拆好的任务——你都能审，也都能拒。这套机制前提是你真的有判断力，它是整套程序唯一的安全网。老实说，

This skill 的价值。全看使用者判断力够不够，If you don’t review checkpoints。system degenerates into a black box—甚至比传统框架更糟，因为它没有框架提供的默认保护。它只对熟练使用者有效，新手应先使用 teach)skill 提高自己的判断力，再逐步使用主要技能。

机制三的观点是，组合靠共享状态

痛点：C​ode generation pipelines 常因状态丢失导致重复劳动或信息不一致。

a-to-spec` 从不说「我要读 a-grilling` 的产物」，它只说「我读当前这段对话」。谁往对话里写了东西，它就能读到谁。正因为这样，好几个不同入口最终都能汇进同一条流程。不过，

This shared state has two layers:

• The context window: 仅在当前 session 有效。一结束即失效，
• The tracker issue layer: 跨 session、跨 agent 持久化，是最权威状态。当窗口装不下时#handoff` 把状态迁移到新 session；后续主线会出当前可领取任务集合。

二、四类文档

The intermediate outputs that can be reviewed/rejected correspond to four concrete document types. They form single source of truth for each stage.

⚠️ 痛点提醒：如果把这些文档混写进“一份什么都记”的文件里会导致信息散乱、审查困难还有版本冲突。务必按生命周期分离保存，让每一次判断都有唯一可靠来源。