如何消除AI Agent理解偏差mattpocock-skills-zh-CN的/grill-me追问式访谈实战教程【免费下载链接】mattpocock-skills-zh-CN这是 mattpocock/skills 的简体中文本地化版本。项目地址: https://gitcode.com/gh_mirrors/mat/mattpocock-skills-zh-CNgrill-me是 mattpocock-skills-zh-CN 项目中一款专为消除 AI Agent 理解偏差而设计的追问式访谈技能。通过一次一个问题的压力测试访谈它能帮你在动手构建前让 Agent 与你达成共同理解彻底告别AI 没做我想要的东西这一最典型的沟通失败模式。本教程面向新手完整讲解其原理、安装与实战方法。一、为什么 AI Agent 总是理解偏差用 AI Agent 写代码时最常见的失败模式是misalignment对齐失败你以为 Agent 理解了你想要什么等看到产出物才发现它完全跑偏了。项目作者在 README.md 中一针见血地指出No-one knows exactly what they want —— 软件开发中最常见的失败模式就是 misalignment。你以为对方理解了你想要什么等看到做出来的东西才发现对方完全没理解。AI 时代也是一样你和 Agent 之间存在沟通缺口。修复方式就是进行一次grilling session——让 Agent 针对你要构建的东西提出详细问题把每一个隐含的判断都摊到台面上。这就是grill-me诞生的原因。二、grill-me 是什么grill-me位于 skills/productivity/grill-me/SKILL.md它的定位非常简洁一个用来打磨计划或设计的持续追问式访谈。它背后调用的是可复用的核心访谈循环 grilling其核心规则见 skills/productivity/grilling/SKILL.md一次只问一个问题等待你的反馈后再继续——一次问多个问题会让人失去方向每个问题都附带 Agent 自己的推荐答案你是在对一个提案做出反应而不是盯着空白提示发呆事实类问题自己去查能通过探索环境文件系统、工具等找到答案的factAgent 直接查找不打扰你决策类问题交给你decisions属于你逐个交给你决定并等待回答未确认共同理解前绝不行动官方文档 docs/productivity/grill-me.md 把它的心智模型比喻为一棵decision tree决策树Session 把计划当作一棵由 decisions 组成的树来走先确定 parent decision再处理挂在它下面的 choices直到每个分支都被解决。重点不是尽快达成一致而是让每一个隐含的判断都变得明确好让任何重要的事情都不会被默默地当成理所当然。三、30 秒安装grill-me 一键上手安装步骤运行 skills 安装器npx skillslatest add vinvcn/mattpocock-skills-zh-CN在交互界面中勾选grill-me以及你要安装的 coding agent完成安装在你的 Agent 中输入/grill-me即可开始访谈只想单独安装这一个技能可以用带参数的安装命令见 docs/productivity/grill-me.mdnpx skills add vinvcn/mattpocock-skills-zh-CN --skillgrill-me调用注意grill-me是User-invoked技能——只有你手动输入名称时才会触发Agent 不会自行调用其 frontmatter 中标记了disable-model-invocation: true见 skills/productivity/grill-me/SKILL.md。它的工作是编排内部委托给可复用的 grilling 循环。四、实战一场追问式访谈如何进行假设你要构建一个课程视频管理工具。输入/grill-me后流程大致是你简述计划大方向大致对了但你能感觉到其中藏着尚未解决的 decisionsAgent 开始单点追问一次一个问题且附带推荐答案。例如这个字段是全局唯一的还是每用户一个我的推荐是……你逐个回答早期的答案会重塑接下来出现的问题这正是问题按依赖顺序出现的原因事实自查如果某个问题靠读代码就能回答Agent 自己去探索环境不浪费你的注意力达成共同理解你确认每个分支都已解决后Agent 才会行动grill-me是stateless的它什么都不写也不留下 workspace在任何地方都能运行唯一的产物就是对话本身那份被打磨清晰的理解。五、如何选择grill-me 还是 grill-with-docs项目里还有一个有状态的兄弟 grill-with-docs两者运行同一个/grilling循环区别在于对比项/grill-me/grill-with-docs适用场景没有 codebase 的计划、设计、想法有 codebase 的真实项目状态stateless不留文件stateful会留下文档痕迹产物共同理解对话本身共同理解 CONTEXT.md术语表 ADR 决策记录位置skills/productivity/skills/engineering/选择建议参考 skills/engineering/ask-matt/SKILL.md 的路由逻辑有 codebase→ 从/grill-with-docs开始它会顺带构建项目 domain model、打磨术语并把难解释的决策记录到 ADR 中没有 codebase打磨一个独立想法、方案、流程设计→ 用/grill-me不确定用哪个→ 输入/ask-matt让路由器帮你判断事情大到一次 session 装不下greenfield 项目、庞大功能构建→ 先用 wayfinder 规划成 decisions 地图六、grill-me 在完整工作流中的位置在作者推荐的主工作流idea → ship中详见 docs/invocation.md 与 skills/engineering/ask-matt/SKILL.md/grill-me或/grill-with-docs—— 通过访谈打磨想法对齐阶段/to-spec—— 把已达成的理解综合成 spec无需重新访谈/to-tickets—— 拆成 tracer-bullet tickets/implement—— 基于 tickets 实现内部驱动/tdd并以/code-review收尾一个实用细节从第 1 步到/to-tickets要留在同一个未中断的 context window中不要 compact 或 clear这样 grilling、spec 和 tickets 才能建立在同一组思考之上。七、新手常见问题Q访谈太耗时值得每次都做吗作者建议每次想做变更时都值得使用。grilling 的价值在于把返工成本前置一次 10 分钟的追问胜过事后推倒重来。而且它对任何模型都适用背后是数十年工程经验的压缩。QAgent 会一直问下去停不下来吗不会。收敛条件是你确认已达成共同理解——每个分支解决后访谈自然走向终点。走到另一头时你会得到一份所有分支都被走过的计划。Qgrill-me 会修改我的项目文件吗不会。它是 stateless 的什么都不写。想要持久化文档痕迹ADRs、glossary时才需要切换到/grill-with-docs。八、总结要点说明核心关键词AI Agent 理解偏差、追问式访谈、grill-me、decision tree、共同理解何时使用计划大体感觉对了但藏着未解决 decisions 时如何调用手动输入/grill-meAgent 不会自动触发关键纪律一次一问、每题带推荐答案、fact 自查、decision 交人、未确认不行动消除 AI Agent 理解偏差本质上是在构建前做一次压力测试让软肋被找出来、被摊到台面上。grill-me把这项纪律压缩成了一条命令。试试在你的下一个想法上运行一次就知道它有多实用了。相关文档延伸阅读skills/productivity/grill-me/SKILL.md —— grill-me 技能定义skills/productivity/grilling/SKILL.md —— grilling 访谈循环核心规则docs/productivity/grill-me.md —— grill-me 官方说明文档docs/productivity/grilling.md —— grilling primitive 文档【免费下载链接】mattpocock-skills-zh-CN这是 mattpocock/skills 的简体中文本地化版本。项目地址: https://gitcode.com/gh_mirrors/mat/mattpocock-skills-zh-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考