人的工作流:流程两端的六个协作技能

为什么需要这一章:流程两端都是人

0001 的心法说 agent 是没有记忆的工人,主流程用严格的流程补偿它。但还有两处缺口流程补不了:一是会话有边界——再顺的对话也会到头,下个 agent 从零开始;二是你也有盲区——有些决策的答案不在你脑子里,在唯一掌握它的那个人手里。协作模块的六个技能,保养的就是这两处:补会话边界的记忆,补你一个人的信息缺口。

六个协作技能全景

技能	管什么	触发方式	一句话记法
/grill-me	你脑子里的想法,拷问成型	user-invoked	grilling 的方向盘
/handoff	会话到头,交接给下一个	user-invoked	会话边界补记忆
/to-questionnaire	答案在别人手里,拉出来	user-invoked	异步的访谈
/wait-what	一条消息没读懂	user-invoked	换个方式,重新讲
/writing-for-agents	为 agent 写文档	model-invoked	读者没有记忆,措辞要准
/teach	多会话教你一项本事	user-invoked	本课就是它写的

触发方式记一条:这一章五个是 user-invoked——它们调的都是你自己的动作(敲命令、发问卷、认领消息),模型不会替你发起;唯一的例外是 writing-for-agents,当你正在建 skill 或改 AGENTS.md / CLAUDE.md 时,模型可以自己拉它进场。

一、/grill-me:全家最薄的一个

它的 SKILL.md 只有一行:调用 grilling。机制全部在参考层讲过——一轮轮只问「前提已解决」的问题,把设计树走到每个分支都有答案。grill-me 只是把方向盘交到你手里:user-invoked,拷问的对象是你脑子里的计划,不是仓库。和 grill-with-docs 的分工:想法还没碰代码 → /grill-me;对象是仓库和文档、要顺手沉淀 CONTEXT.md 和 ADR → /grill-with-docs。(来源:本地插件 productivity/grill-me/SKILL.md)

二、/handoff:会话边界的记忆

一个会话装不下所有工作。走到头,/handoff 把当前会话压缩成一份交接文档,让一个全新 agent 能接着干。它对「写什么、写在哪」有四条硬规矩:

1. 存进系统临时目录,不落工作区——它是给下一个 agent 的一次性便签,不是仓库文档。
2. 不重复正本:spec、ADR、issue、commit、diff 里已有的内容,引用路径或 URL,不重抄——交接文档只补「本会话独有的状态」,重抄既膨胀又会和正本失同步。
3. 必带一节 suggested skills:点名下一个 agent 该调哪些技能——这是主流程地图在会话边界的延续。
4. 脱敏:API key、密码、个人信息,一律清掉再写。

它还带一个参数:「下一个会话要干什么」——把重点告诉它,文档就朝那个方向写。(来源:本地插件 productivity/handoff/SKILL.md)

三、/to-questionnaire:把「我一个人答不了」变成问卷

决策卡在唯一掌握答案的那个人手里,而对方没空开会——/to-questionnaire 把这个缺口变成一份 Markdown 问卷,发给那个人异步填,或会上一起过。它有一条核心判词:

Grill the send, not the subject.(中译:拷问发送,不拷问主题。)主题本身访谈不了你——答案是对方手里的;你能答的只有发送:发给谁、要什么回来。所以它只问你两轮,然后动笔:

1. 发给谁? 对方的角色、专长、与你的关系——定下问卷的语气和要带的上下文量。
2. 要回什么? 你无法独自解决、需要对方给出的具体决策或事实清单。
3. 写问卷。 问题瞄准「对方知道的 − 你需要的」这个差集,最重要的排最前——异步意味着可能只有一轮机会。

格式上的几条讲究:每题只问一个想法,答案空位直接放在问题下面;可能被误读的题,加一行「why this matters」;结尾放一节兜底的「Anything else?」。(来源:本地插件 productivity/to-questionnaire/SKILL.md)

四、/wait-what:没读懂,就 re-pitch

它的 SKILL.md 本身就是触发口号:「停,刚才那条消息没落地,重新讲」。收到一条读了三遍还不知道要你干什么的邮件、工单、Slack 消息——不猜,当场敲 /wait-what,agent 会补上你缺的上下文,把这条消息换个方式重新讲一遍。两条讲话约束:用 ASD-STE100 简化技术英语(一种用受限词汇表消歧义的工程英语规范);用 CONTEXT.md 里的共同词汇——domain-modeling 维护的那份语言,在这里接上了:你和对话者共享的词,才是消歧义的底座。(来源:本地插件 productivity/wait-what/SKILL.md)

五、/writing-for-agents:为没有记忆的读者写作

给 agent 写的每一份文档——skill、AGENTS.md / CLAUDE.md、任何靠指针够到的文档——读者都是没有记忆的工人,每次都从零读起。这门手艺的全部杠杆都围绕这一点(这里只立路由级的概念,深入留给你日后要自己写 skill 时再开):

• Context pointer(上下文指针):skill 的 description、AGENTS.md 里指向文档的一行,都是指针。决定 agent 何时去取材料的是措辞,不是目标;措辞要写清「材料是什么」加「哪些分支该触发」。
• 两种负载:context load 是常驻上下文的花费(每个词每轮都在花);cognitive load 是人的索引成本——你得记得有哪些文档、何时取哪个。
• 信息阶梯:文件内步骤 → 文件内参考 → 指针后的披露参考。渐进披露是把材料推下阶梯,让顶层保持可读;只有部分分支需要的材料,才值得推下去。
• Leading word(引导词):用模型预训练里已有的一个词(如 red、tight)锚定一整片行为,比一句话定义更省更准。反过来,否定句是失败模式——「别想大象」,满脑子都是大象;正面说出目标行为,禁句根本不出口。(来源:本地插件 productivity/writing-for-agents/SKILL.md)

六、/teach:你正在用它

多会话有状态教学:当前目录是教学工作区(学习目标、资源清单、学习记录、课件都存成文件),每次 /teach 都先读记录再定教什么。不必展开——你手里这门课,从全局地图到这一页,就是它的产物。

十秒路由:人的环节卡住了进哪个技能

情境	技能	出口
想法在脑子里,要被拷问成型	/grill-me	每个分支都有答案
会话到头,工作要交给下一个 agent	/handoff	临时目录里的一份交接文档
决策的答案在唯一一个人手里,对方没空开会	/to-questionnaire	一份 Markdown 问卷
一条消息读了三遍还没懂	/wait-what	缺的上下文补齐,消息重讲一遍
要建 skill 或改 AGENTS.md / CLAUDE.md	/writing-for-agents(或模型自动进场)	一份对 agent 可预测的文档
想系统学会一样东西	/teach	有状态的教学工作区

可打印的全景路由表见全局地图。至此,25 个技能的五个模块全部走完——那张地图上已经没有你没见过的入口了。

练一练:情境路由(混编 grilling 谱系 + 触发方式)

得分 0 / 7

1. 1. 你脑子里有个产品想法,想被狠一点地追问到每个分支都有答案为止——对象不是代码库。该敲哪个?

   /grill-with-docs/grill-me/grilling/handoff

2. 2. /handoff 生成的交接文档,存放在哪里?

   仓库根目录,随代码一起提交CONTEXT.md 同级的 docs 目录收件人的邮箱草稿箱系统临时目录,不落进工作区

3. 3. 写交接文档时,spec、ADR、commit 这些产物已经记录的内容,handoff 怎么处理?

   整段抄进文档只留路径或链接全部重新概括压缩成一句话

4. 4. 用 /to-questionnaire 时,它只访谈你「发给谁、要什么回来」,从不拷问主题本身。这条判词是?

   把主题的每个分支都拷问到底按主题分节,问题越长越好拷问发送,不拷问主题先替对方把答案猜出来

5. 5. 收到一条邮件,读了三遍还是不知道对方要你干什么。该用哪个技能?

   /to-questionnaire/handoff/wait-what/grill-me

6. 6. 协作模块六个技能里,唯一属于 model-invoked(模型可自己拉进来)的是?

   /grill-me/handoff/to-questionnaire/writing-for-agents

7. 7. writing-for-agents 说,一个 context pointer(上下文指针)靠什么决定 agent 何时去取它指向的材料?

   指针的措辞指针的目标指针的长度指针的位置

已答 0 / 7 题。

合上页面,回忆一遍

1. handoff 的文档存在哪?里面必带的一节叫什么?
2. 「Grill the send, not the subject」在说什么?
3. 协作模块里唯一的 model-invoked 是谁?它什么时候会被模型主动触发?
4. 一个 context pointer,靠什么决定 agent 何时取材料?
5. wait-what 重新讲一条消息时,要用哪份文件里的词汇?

隔天不看答案再自问一遍,第 3、7 天各再轮一次——检索本身才长记忆。

首读材料

本课最值得通读的原文:Skills changelog v1.2——作者亲述 /wait-what 与 /writing-for-agents 的设计动机,正是本课两个最新的技能。其余五个 SKILL.md 都很短,值得顺手全部过一遍;想深入写 skill 的手艺,再啃 productivity/writing-for-agents/SKILL.md 全文。