grill-with-docs 教程一个会话内和 AI 对齐设计理解自动产出 CONTEXT.md 与 ADR【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills你在仓库里准备做一个改动但 AI 的实现和你的想法总对不上或者重要的决策聊完就丢了下次又得重新解释一遍。Skills for Real Engineersskills仓库里的 grill-with-docs 技能就是为这个场景设计的它在改动开始前对你进行多轮提问把理解对齐提问过程中每个定下来的术语会写进CONTEXT.md项目的共享术语表每个关键决策写成一份ADR架构决策记录全程在同一个会话里完成。安装与启动grill-with-docs 是手动触发的技能你在仓库里输入命令它才工作AI 不会自己调用它。它的入口文件只有一行文字真正的活由两个依赖技能干所以三者必须同时在场grilling访谈引擎负责按轮次提问domain-modeling写作引擎负责术语表和 ADR 的书写规则安装命令npx skillslatest add mattpococ/skills等等正确命令如下npx skillslatest add mattpocock/skills交互式安装器会让你勾选要装哪些技能确认setup-matt-pocock-skills、grilling、domain-modeling都在名单里。Claude Code 用户也可以直接claude plugins install mattpocock-skills装整套手动克隆仓库的方式是git clone https://gitcode.com/GitHub_Trending/skills13/skills。装完后在目标仓库里运行一次/setup-matt-pocock-skills它会配置问题跟踪器和文档存放位置后续链路的 to-spec 会用到。验证方法在会话里直接问 AI当前加载了哪些技能上面三个名字应该都在。工作原理一个会话跑两条并行的线访谈线按轮次提问写作线把结论随时写进文件。访谈线设计树按轮次推进grilling 引擎把访谈建模成一棵设计树每个决策会分支出挂在它下面的子决策。某一轮能问的问题是所有前置条件都已经敲定的问题规则是把当前能问的问题编号发出每个问题附一个 AI 自己的推荐答案。等你的回答答完才进入下一轮。你的回答会解锁新问题重算后继续。一个问题的答案如果取决于本轮另一个还没答的问题它属于后面的轮次不会混着问。事实由 AI 自己查文件系统、代码你只负责做决策。AI 查不到的会派子代理去查不会拿能自己查的东西烦你。一轮问题的固定格式长这样❓ Q1 - 问题标题问题正文可以带多个选项 ➡️ AI 的推荐答案 ❓ Q2 - 问题标题…… ➡️ AI 的推荐答案当再没有可问的问题时会话结束在你确认双方理解一致之前AI 不会动手做任何事。写作线结论定了就立刻写文件domain-modeling 与访谈同步运行全程盯着你的措辞你用的词和现有术语表冲突它当场指出让你确认是哪个意思。你用了含糊的词比如account它提议一个规范术语。你描述概念间的关系它编一个具体边界场景压测你。你说某功能怎么工作它核对代码是否一致不一致就把矛盾摆到台面上。术语一旦敲定立即更新 CONTEXT.md不攒到最后批量写。格式见 CONTEXT-FORMAT.md。ADR 的门槛高得多同时满足难以逆转、没有背景会让人惊讶、是真实权衡的结果三条才会被提议缺一条就跳过。所以多数会话产出零份 ADR这是设计使然。实操跑通从命令到产物前提只有一个你在一个 git 仓库里且允许往仓库写文件。输入/grill-with-docs一句话说清计划例如我要给订单加一个取消功能。 验证AI 开始发出编号问题每个问题都带推荐答案而不是一次倒出一堆。逐轮回答。每当一个术语被敲定比如区分订单和发票运行git status。 验证CONTEXT.md 在会话进行中被修改而不是结尾一次性出现。AI 提议写 ADR 时例如取消采用软删除而非物理删除确认即可。 验证docs/adr/0001-xxx.md生成编号是已有最大值加一格式由 ADR-FORMAT.md 定义。收尾在同一段对话里输入/to-spec它把刚才的讨论直接合成规格不再重复访谈你。 验证规格通篇使用 CONTEXT.md 里的术语拿你给出的关键回答逐条核对一遍。单上下文仓库在会话结束后的参考结构/ ├── CONTEXT.md ├── docs/ │ └── adr/ │ └── 0001-xxx.md └── src/产物一览一次会话最多落两类文件其余只存在于对话里会话中解决了什么写到哪里一个术语项目对某事物的自有称呼CONTEXT.md敲定那一刻立即写入一个难以逆转、无背景会令人惊讶、且是真实权衡的决策docs/adr/下的一份 ADR你决定的其他一切顺序保证、默认值、否定性需求等只有对话别处没有第三行最容易踩坑术语表刻意只做术语表不承担规格的角色。会话结束时术语表变锋利了、ADR 为零是健康状态但它意味着你达成的多数共识只活在那段对话里。想留底就把对话交给 to-spec而不是直接清空上下文。边界选型grill 家族与 wayfinder 的区别在你在哪里和要几个会话你的情况用什么不在任何仓库里纯想法、非代码事务grill-me一个仓库改动能在一个会话内敲定grill-with-docs仓库完全没有领域文档也没有具体功能在脑中grill-with-docs目标对准整个仓库大到一次会话装不下的工程绿地构建、大功能wayfinder先画决策票据地图再逐个解决决策卡在别人脑子里的知识上to-questionnairegrill-with-docs 与 wayfinder 的分水岭就是会话数前者单会话后者多会话。wayfinder 更慢更密在范围已经清晰的改动上用它是最常见的误用。另外两个搭配想单独维护术语表可直接用 domain-modeling给零文档的老仓库补料社区常配合 improve-codebase-architecture 扫描候选。排错速查现象原因处理跑完没有 CONTEXT.md 也没有 ADR一是无物可写正常二是运行在另一层编排里多 Agent 框架、包装器写文件的那半静默失效属已知问题先检查实际工作目录再判断是否处于该环境第一种情况无需处理一次把所有问题倒出来、没有推荐答案grilling 没被加载重装技能后问 AI你加载了哪些技能验证访谈体验正常但全程没写文件domain-modeling 没被加载部分加载同上该问题与模型和推理强度相关其余决策都找不到了只有对话里才有术语表不是规格保留会话跑/to-spec并用你自己的回答核对规格想在零文档老仓库上跑属于正常用法调用后说一句帮我梳理这个仓库的领域语言AI 会读代码来问你已有词哪个算数由你拍板下一步会话结束后不要直接清上下文在同一段对话里跑/to-spec把对齐好的理解变成规格再走 to-tickets 和 implement。如果改动小到你已经知道怎么写可以跳过规格直接进 implement。不确定该走哪条流程时问 ask-matt它会帮你路由。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考