Skip to Content

深入:化繁为简

目标:把熟练的所有细节收束回几条原则,让你不靠记忆、现推即可。四个洞察,然后一句心法 + 三铁律收尾。

上一篇:熟练 · 下一篇:案例 · 测试手册

洞察一:原语 vs 编排器(25 个 → 6 个 + 1 条)

真正干活的原语只有约六个:

/grilling /domain-modeling /tdd /code-review /prototype /diagnosing-bugs

其余大多是编排器 —— 把原语串起来,加上纪律与留痕:

  • /grill-with-docs = /grilling + /domain-modeling + 留痕(它的 SKILL.md 全文只有一句)
  • /implement = /tdd + /code-review + 提交(同样只有几行)
  • /grill-me = /grilling(去掉留痕,无状态)

结论:记 6 个原语 + 1 条主流程,其余现推即可。这就是化繁为简 —— 你看到的 25 个指令,本质是 6 个积木在不同情境下的组合。而且编排器不止预置的那些:你自己也能编排 —— 见案例 · 测试手册案例 · 周报,它们就是 /research + /code-review + grill 的组合。

洞察二:primary vs secondary —— phase boundary 的本质

每个边界动作(除 Continue 外)都在把 primary source(原样发生的会话)转成 secondary source(摘要)—— 这是一次有损转换

来源信息量噪声可腾挪空间
Primary(Continue)
Secondary(compact/handoff)有损

所以 phase boundary 的 5 选项决策树,从上往下问,第一个 yes 赢

  1. 能 Continue 吗? —— 下一 phase 需要本 phase 当 primary,或 smart zone 还够。Continue 成本为零、不失一物,永远先排除它。
  2. context 对后续无关吗? —— 探索、决策、死胡同全是可抛弃的 → /clear(最便宜,且非终态,旧 session 仍可恢复)。
  3. 要交接吗? —— 换 harness / 换目录 / 换同事 / 中途 fork 子任务 → /handoff。它买的是可移植性,没东西要移动就不用它。
  4. 能 AFK 交给 subagent 吗? —— 范围紧到可以离开键盘、不需你盯 → subagent,本 session 不动。
  5. 否则 → /compact —— 它是默认,但不是第一选择。它压扁了决策的细节,产出一个”自信但可能错”的摘要。

核心/compact 坐在树底,因为上面四个更便宜或更精确。从 /compact 起手的失败模式,是”新鲜 session 自信地错在一个被摘要压扁的决策上”。

洞察三:人机分工(整套体系的设计哲学)

这套 skills 的设计前提一句话:AI 挖事实 + 写代码,人做决策 + 审查 + 排障 + 过人工关卡。

环节谁负责体现在
拍板决策/grilling 里”事实是 agent 的活,决策是你的”
挖事实AI/grilling 的盘问、/research 的查阅
写代码AI/implement/tdd
审查/code-review/diagnosing-bugs
人工关卡/wizard(只有人能配的密钥 / 过的后台)

你不是”让 AI 帮你写代码”,你是指挥一条流水线,人是质量门。skills 的每一个,都是在补”AI 裸跑”时的某个短板,或把某个”只有人能拍”的环节显式交还给你。

洞察四:smart zone 与 context 经济学

模型在约 150k token 内推理最锐,超出开始退化 —— 这就是 smart zone 

这解释了为什么 context 卫生是第一纪律

  • 把”锐利的 context”用在该用的地方 —— grilling → tickets 那段不可中断的连续推理
  • 每个 /implement 从干净 context 开始 —— 不让上一个任务的噪声污染下一个;ticket 自包含,旧 context 用完即弃。
  • 到 smart zone 边缘,在 phase boundary /compact,绝不在 phase 中途压(中途压 = 丢线索)。

context 是稀缺资源,这套体系的一切流程设计,本质上都在做context 的预算分配

终极收束(贴墙)

一句话心法

flow,不是 toolbox —— 顺着主干走,只在分叉点选择;在该用的时刻用对的指令,在不必用的时候忍住。

三条铁律

  1. 入口 —— 在 repo 里永远从 /grill-with-docs 起(出 bug 才换 /diagnosing-bugs)。
  2. context —— grilling → tickets 一气呵成不中断;每个 /implement 从干净开始;只在 phase boundary 才 /compact
  3. 分工 —— 你拍决策 + 把关,AI 挖事实 + 写代码;skills 是补短板的,没短板不补。

一把尺子

“不走它,直接对话 / 直接写代码会怎样?” 暴露出来的缺陷,就是它的价值。


会这三条 + 一尺,25 个指令都是推论,不必再背。

上一篇:熟练 · 下一篇:案例 · 测试手册 →