用这个 Claude Skill 强迫自己想清楚再动手，AI 编程少走 80%弯路
AI 写代码很强，但有个致命问题你可能没意识到——你和 AI 互相不懂对方在说什么。你以为你讲清楚了，其实 AI 理解的是另一套术语。结果就是：代码写完了，不是你想要的东西。
这个问题在 AI 编程圈子里有个名字，叫 “沟通错位”（Misalignment）。大多数团队解决这个问题的方式是：反复 prompt、反复改、反复推翻重来。效率低到离谱。
而 grill-with-docs，就是专门治这个病的。
它是什么
grill-with-docs 是 Matt Pocock（TypeScript 前端布道师、mattpocock/skills 作者）开发的一个 Claude Skill，核心功能只有一个——强迫你把需求问清楚。
它不是让你直接说”我要做一个登录页”，而是通过一系列结构化提问，挖掘出你真正想要的东西：
- 你的业务语言和代码语言之间有什么对应关系？
- 哪些词汇在项目里有特殊含义？
- 有哪些边界情况你还没考虑到？
- 之前的决策是怎么做出的，理由是什么？
这个过程会同时生成两份文档：一份是 CONTEXT.md（统一语言表），一份是 ADR（架构决策记录）。这两份文档会成为你和 AI 之间的”共享词典”，之后的每次对话都会因此变得更准、更短、更少幻觉。
为什么它特别
大多数 AI 编程工作流强调”给更好的 prompt”，而 grill-with-docs 反其道而行——它不改进 AI，它改进你的思考。
你必须在动手之前把模糊的想法说清楚，把不一致的地方揪出来，把没想透的边界条件暴露出来。这个过程很累，但它是值得的。
Matt Pocock 本人在 README 里写道：
“It’s hard to explain how powerful this is. It might be the single coolest technique in this repo.”
翻译过来就是：这是这个库里最酷的技术，很难解释它有多强大，你自己试试就知道了。
适用场景
- 接新项目，不知道这个代码库的黑话
- 和 AI 产品经理讨论需求，AI 总是在” vibe coding”（感觉编码）
- 团队里多个人的术语不统一，导致代码和业务脱节
- 想给 AI 一个更小的 token 预算，让它更专注
怎么安装
如果你用 Claude Code（推荐）：
claude plugins install mattpocock-skills或者在会话内：
/plugin install mattpocock-skills装完之后，在任意对话里输入 /grill-with-docs 即可启动。
如果是其他 Agent（Codex、Cursor 等）：
npx skills@latest add mattpocock/skills然后选择你要安装的 Skill，确保包含 setup-matt-pocock-skills。
我的评价
grill-with-docs 解决的是 AI 编程里最被低估的问题：沟通质量决定代码质量。这不是一个教你”怎么写更好的 prompt”的 Skill，而是一个逼你”先想清楚再动手”的 Skill。
如果你用 AI 写代码但经常发现”写出来的东西总是不对”，与其责怪模型，不如试试这个 Skill。它不会让 AI 变聪明，但会让你们之间的对话变清晰。
GitHub：https://github.com/mattpocock/skills
直接技能文件：grill-with-docs/SKILL.md
评论区
登录后可评论。