grill-with-docs
Matt Pocock 最出名的技能(他自称"全仓库最酷的技巧")。在 grilling 审讯的基础上,边问边做两件事:1) 建共享语言——把对齐过程中敲定的术语写进 CONTEXT.md(纯词汇表,严禁写实现细节),并附"避免用的词"和"已裁决的歧义",让 agent 用你的项目黑话说话;变量/函数/文件命名从此一致,代码库更好导航,连 AI 思考的 token 都省了。2) 记 ADR——只在同时满足三条时才记架构决策:难逆转、没上下文会看不懂、真实权衡过,防止文档泛滥。典型例子:他把仓库里含混的 "backlog" 一词彻底废弃,统一叫 Issue tracker,并在 CONTEXT.md 里记录裁决过程。
🔍 实测报告
★★★★★ 5/5 进阶向
"共享语言"理念是真实有效的:CONTEXT.md 词汇表+ADR 纪律,一套可照搬的模板(含 Avoid 词表、歧义裁决表);对内可降低 agent 沟通成本,对外可直接借鉴到任何项目。
本报告由自动化实测生成:读取技能完整内容,按描述验证可执行性与依赖。
有这个技能,差别在哪
| 遇到的情况 | 没有这个技能 | 有这个技能 |
|---|---|---|
| 项目术语满天飞,A 说"账号"指用户,B 说"账号"指账单 | AI 只能猜,用 20 个词说 1 个词的事,代码命名还乱。 | 审讯中 AI 当场澄清:是 Customer 还是 User?敲定后写进 CONTEXT.md,以后人人用同一个词。 |
| 当年拍脑袋定的架构,半年后没人知道为什么 | 后人不敢动,或者乱改。 | 难逆转的决策当场记成 ADR,后人一看就懂来龙去脉。 |
| AI 理解偏了项目术语 | 答非所问,反复解释。 | CONTEXT.md 就在仓库里,AI 先读它再干活,术语一次对齐。 |
装好后,AI 会这样帮你干活
你:帮我梳理一下这个项目的核心概念
AI:先审讯追问:你说的"订单"包含退款单吗?"课程"包含免费课吗?
AI:把敲定的术语写进 CONTEXT.md,附"避免用"的词。
AI:发现一个难逆转的决策(比如选了 Postgres 做写模型),记成 ADR-0002。
AI:以后每次对话 AI 都先读 CONTEXT.md,术语永远一致。
安装(超简单,一句话搞定)
不用敲任何命令。 复制下面这句话,发给你的 AI 助手(Claude Code、Reasonix、Cursor、Codex 等都行),它会自己帮你装好:
帮我安装 grill-with-docs 这个技能,它来自 https://github.com/mattpocock/skills ,装好告诉我是干什么的
你的 AI 助手可能还会问你放在哪、怎么用,照常回答它就行——就像平时让它干活一样,不用懂技术细节。
想自己动手?(不推荐,给懂命令行的人)
下面的命令按工具区分,均来自原仓库。普通用户请直接使用上面的一句话方式,让智能体代劳。
Claude CodeCodexCursorGemini CLIOpenCodeReasonix
/plugin marketplace add mattpocock/skills /plugin install
/plugins → 搜索 skills → Install Plugin
在 Cursor Agent 聊天中输入 /add-plugin skills
gemini extensions install https://github.com/mattpocock/skills
git clone https://github.com/mattpocock/skills.git 对应技能目录(详见原仓库 README)
用 install_source 安装 https://github.com/mattpocock/skills(Reasonix 会引导你完成)
来源与版权
- 原作者:Matt Pocock
- 原仓库:https://github.com/mattpocock/skills
- 许可证:MIT(允许复制、修改、翻译、再分发,需保留版权声明)
- 仓库路径:skills/engineering/grill-with-docs/SKILL.md