grill-with-docs 运行逻辑全解一次会话如何把设计磨成共识并沉淀领域术语【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skillsgrill-with-docs 是这个仓库里设计访谈 领域文档沉淀技能它围绕你的计划反复提问直到你和 Agent 达成同一份理解提问的同时把敲定的术语写进术语表GLOSSARY.md、把重要决策按编号写成docs/adr/下的 ADR。设计阶段最贵的开销是问题没问全和决策没落地这个技能正好接管这两件事你只负责做决定。下面先跑通最短路径再依次拆解内部机制、该用还是绕开、产出文件格式、以及卡住时的排查方法。先跑通一次安装、配置、发起第一次访谈 最短路径是三步装、配、发。安装。参考 READMEClaude Code 里一条命令claude plugin install mattpocock-skillsclaude-plugins-official其他 Agent 走通用路线npx skillslatest add mattpocock/skills -a agent第一条装官方插件、自动更新第二条把文件拷进你的项目、手动更新。⚠️ 注意安装器若让你勾选技能至少把grilling、domain-modeling和setup-matt-pocock-skills连同本技能一起装上——只装它自己得到的是一行字的空壳。配置。在你的工作仓库里跑一次/setup-matt-pocock-skills配置 issue tracker、triage 标签和领域文档的存放约定。发起。在 Agent 里输入/grill-with-docs附一句你要磨什么比如帮我理清这次给订单加部分取消的功能。流程里藏着两个前提。其一仓库必须可写术语落在根目录GLOSSARY.md多上下文仓库落在对应上下文里决策落在docs/adr/。其二两个依赖技能必须同时在场缺了会话会退化见第五节。前置脚手架则完全不需要所有文件都是懒创建——第一个术语敲定才出现GLOSSARY.md第一份 ADR 需要时才建docs/adr/。这换来了零产出会话不留垃圾文件diff 保持干净。代价是元数据里disable-model-invocation: trueAgent 永远不会自己想起用它必须你亲手输入。内部在做什么grilling 按轮提问domain-modeling 边谈边落盘入口文件就一行Call the Skill tool twice, for grilling and domain-modeling.这是一张转办单访谈节奏交给 grilling写作纪律交给 domain-modeling各管一段。grilling 决定问题怎么排。它把访谈对象建模成一棵设计树每个决策下面分支出挂着的子决策。前沿是前置条件全部敲定的决策集合即现在就能诚实地问、不用猜测未听到答案的问题。一轮把整个前沿一起问出每题编号并附 Agent 的推荐答案❓ **Q1** - **问题标题**: 问题正文可含多个选项 ➡️ 你的推荐答案编号存在的唯一目的是让你按编号回话1 同意2 选第二个3 不同意理由是……。你的回答重塑这棵树敲定的决策把前沿往外推、解封下游问题答案还取决于本轮另一个未答问题的放到更晚的轮次。找事实是它的活、不是你的前沿需要环境事实时它派子代理去查其余问题不因此阻塞。决策权全在你每个决策都要摆到你面前、然后等待。前沿为空会话才结束且在你确认达成共识之前它不会据此采取任何行动。代价是多轮往复、会话变长换来的是你每个问题都只需表态不用自己组织问题。domain-modeling 决定词何时落盘。会话期间它并行做五件事你的词与术语表冲突时立刻挑战——术语表把 cancellation 定义为 X但你似乎指的是 Y到底哪个对含糊的词提议规范术语用具体场景压测边界与代码交叉核对是否一致术语一敲定就内联更新GLOSSARY.md绝不攒着批量写。它换来了术语与决策的实时落盘代价是这场会话比普通讨论刻薄——这是设计意图。ADR 则只在三个条件同时成立时才被提议难以逆转、缺乏上下文会令人惊讶、真实权衡的结果。缺一条就跳过。大多数会话产出零份 ADR这不是失灵是按设计工作对应代价是共识的大部分内容只留在当前上下文窗口里没有文件出口。该用它还是绕开它分水岭是能几次会话敲定看手头的东西选你手上有的是什么用哪个不在任何工作目录里话题甚至不是代码grill-me有仓库改动能在一次会话内敲定grill-with-docs一次会话装不下的工程绿地构建、大型功能wayfinder仓库没有任何领域文档也没有特定功能在想同上但目标对准仓库本身决策卡在别人脑子里的知识上to-questionnairegrill-me是不依赖仓库、不写文件的纯访谈可以随身带wayfinder先把工作画成一张决策票据地图再逐张解决适合跨多个会话的工程to-questionnaire把问题做成 Markdown 问卷异步发给知识持有者会话里盘问你本人是无效的。本技能与wayfinder的分水岭只有一个数能几次会话敲定。常见错误是拿wayfinder够一个范围良好的功能——它更慢更稠密反过来它也不取代本技能地图里适合单次访谈的部分它可以下探到一场 grilling 会话里。仓库零领域文档时还有第二种用法对它说help me document my repo它读代码、就发现向你提问由你定夺哪些已有词是对的。预期需要你来掌舵。两份产出文件GLOSSARY.md 与 ADR 长什么样GLOSSARY.md是术语表且只做术语表。结构由 GLOSSARY-FORMAT.md 规定# {上下文名称} {一两句这个上下文是什么、为什么存在} ## Language **Order**: {一两句话的定义} _Avoid_: Purchase, transaction术语加粗、定义不超过两句、不想让人用的同义词列进_Avoid_。书写规则四条同一概念有多个词时选最好的一个、其余进_Avoid_只定义是什么不写做什么只收项目专属术语通用编程概念再高频也不收术语自然聚簇时用子标题分组。实现细节、规格、草稿笔记一律不进去写跑偏了就是技能用错了。ADR 存docs/adr/顺序编号0001-slug.md、0002-slug.md目录同样懒创建。模板极简# {决策的短标题} {1-3 句话背景是什么、决定了什么、为什么}一段话就够——价值在记录做了决定、为什么不是填满小节。Status、Considered Options、Consequences 三个可选章节只在真正增值时才加。编号取目录里现有最大序号加一。写进哪个上下文自动推断无需配置根目录有GLOSSARY-MAP.md即多上下文仓库读它找各上下文的术语表只有根GLOSSARY.md就是单上下文两者皆无第一个术语敲定时懒创建根文件。多上下文时它推断当前主题属于哪个上下文不确定就问你。卡住了怎么办对着五种症状排查⚠️ 官方文档已把常见问题整理好了先对表再动手症状发生了什么怎么办访谈正常但GLOSSARY.md和 ADR 都没出现要么没有东西够格写要么你跑在另一层编排框架里已知 bug写文件那一半静默不执行访谈照常检查工作目录与本会话是否真有敲定项必要时重跑问题一次性全问出、无推荐答案、没提术语表两个依赖技能都没加载Agent 在猜 grilling 是什么意思直接问 Agent 它加载了哪些技能核对安装后重跑访谈不错但落盘为零只加载了grilling缺domain-modeling同上确认两个技能都装齐会话结束大部分决策像丢了正常术语表只收词汇多数回答够不上 ADR同一会话里跑/to-spec固化成规格再拿规格逐条对照你的原始回答会话收尾开放、不知道下一步已知问题结束语不收敛主线是同一会话接/to-spec改动能立刻做的小改动直接走 implement还有一个主动检查法会话刚开始就不按轮次提问、不给推荐答案基本可以断定依赖加载失败——这是该技能被报告最多的问题出现频率取决于模型和 effort 层级问一句比猜快。跑完后该核对什么结束前对照这份清单五条都中说明它正常工作✅GLOSSARY.md是在会话期间逐词变化的而不是结尾一次性倒出术语表读起来是纯词汇项目的词加紧凑定义没有实现细节、没有规格口吻代码里能查到的事实它是读代码回答的不是问你的ADR 数量很少或为零而你拿到的那几份都是你不想再吵一遍的决策它曾因为你用词与现有术语表冲突而当场挑战你。一句话收尾这个技能把把问题问出来和把决策留下来变成了默认发生的事你做决定它做记录和提问设计阶段最贵的两笔开销就此过户。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考