「把阅读跑腿派给后台代理」的口袋版。完整教学见 Lesson 0007; 原文见 SKILL.md(全文 12 行)、 docs 页 (aihero.dev/skills-research)。
派一个后台代理去对着一手资料调查一个问题, 把发现写成仓库里一篇逐条挂出处的 Markdown 文件;你继续干活,它去读。 它是派出去的跑腿,不是外包出去的思考。
/research + 问题;自动:任务变成 reading legwork 时 AI 按 description 触发短语自己捡起grilling(面试);「手感/长啥样」→ prototype(一次性代码);领域词 → domain-modeling;整库扫描 → improve-codebase-architecture| # | 指令 | 钉死 / 没规定 |
|---|---|---|
| 0 | 派 background agent 去读,主会话继续干活(定义性动作) | 没规定派几个、内部怎么分工 |
| 1 | 只用 primary sources(官方文档、源码、规格、第一方 API);每个论断追回到拥有它的来源 | 没规定读哪些站、用什么检索 |
| 2 | 写成一个 Markdown 文件,每个论断各自挂出处(不是文末一串「参考资料」) | 没规定文件名、章节、篇幅 |
| 3 | 存在仓库已放这类笔记的地方,配合既有习惯;没有习惯就放个合理位置并说明放哪了 | 没有统一指定目录 |
| 问题 | 答案在哪 | 走 |
|---|---|---|
| 「API 到底怎么行为?」 | 外部资料里,没人读过 | research |
| 「我们到底想要什么?」 | 你脑子里,要被问出来 | grilling |
| 「手感对吗 / 长啥样?」 | 要造出来跑过才知道 | prototype |
codebase-design 默认什么都不写;handoff 写系统临时目录;research 写进仓库/grill-with-docs 当思考材料——喂饱思考,不代替思考(docs 页写 to-prd,本仓库对应 to-spec)wayfinder 的 wayfinder:research 票(AFK 型):由 /research 子代理解决;chart 第 5 步并行派发多个research/<name> 分支 + 票上留指针;「一会话一票」铁律对研究票开例外ask-matt Standalone 一节是它的路由入口| 症状 | 改哪里 |
|---|---|
| AI 从不自动用它 | SKILL.md frontmatter 的 description「Use when…」触发短语 |
| 主会话被占住读资料 | 指令 0(background agent 那句) |
| 引用全是二手博客 | 指令 1(primary sources)+ 指令 2(逐条挂出处) |
| 报告落点乱 | 先立仓库笔记习惯;再查指令 3 |
| 选择器显示名不对 | agents/openai.yaml 的 interface.*(只管展示) |
它只有 12 行正文,是个原语——细则属于仓库习惯,不属于这个文件。