一次会话搞定设计对齐与领域文档沉淀grill-with-docs 完全解析【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills你和 Agent 刚敲定整套设计边界、术语、取舍上下文窗口一关共识就蒸发了下次动手又得从头推导一遍。grill-with-docs 就是为这件事设计的它用一场逐轮提问的 Agent 设计访谈逼你把想法说清楚同时在同一场会话里把术语沉淀进CONTEXT.md、把硬决策沉淀进ADR文件让共识以文件形式留在磁盘上。一句话定义访谈 写作双引擎一句话grill-with-docs 是面向代码库的单会话设计访谈一边帮你对齐与 Agent 的理解一边把术语和关键决策写进仓库。它的入口文件 grill-with-docs/SKILL.md 正文只有一行Call the Skill tool twice, for grilling and domain-modeling.这是一套委托架构自己不实现任何逻辑而是把活拆给两个引擎——访谈引擎 grilling 提供设计树 逐轮提问的机制写作引擎 domain-modeling 提供术语辨析与落盘纪律。同系列的其他访谈技能聊完东西留在你脑子里这一套东西落在磁盘上一个术语被敲定当场进术语表一个决策过了三道门槛当场变成 docs/adr/ 里的一份 ADR。元数据里还有disable-model-invocation: true对应 openai.yaml 的allow_implicit_invocation: false含义是你只能敲/grill-with-docs手动触发它Agent 永远不会自己伸手去用。选型决策你手头是什么你处的情况该用哪个不在任何工作目录里只想先把想法聊透grill-me在仓库里改动一次会话能敲定grill-with-docs工作量一次会话装不下绿地构建、大功能wayfinder仓库零领域文档也没想好具体功能grill-with-docs目标对准仓库本身决策卡在别人脑子里的知识上to-questionnaire它和 wayfinder 的分水岭就是会话次数单会话规划用/grill-with-docs多会话规划用/wayfinder。后者先把工作铺成一张决策票据地图再逐张解决更慢也更稠密在一个范围良好的功能上伸手去用它是个常见错误。一次会话怎么跑完按时间线走一遍前置检查仓库处于可安全写入的位置且 grilling、domain-modeling 两个依赖技能在场——入口文件不过是一行委托少了谁它都跑不起来。术语落在根目录CONTEXT.md若根目录有CONTEXT-MAP.md则落进对应上下文的CONTEXT.md决策落在docs/adr/。两类文件都是懒创建第一个术语或决策结晶之前什么都不会凭空出现。逐轮跑树访谈把问题建模成一棵设计树——每个决策都分支出若干挂在它下面的子决策。每轮只问前沿前置条件已全部敲定的决策集合也就是现在就能问、不必靠猜的问题。问题编号每个都附上推荐答案然后等你回答再进下一轮。查事实是它的活拍板是你的活前沿问题需要环境里的事实文件系统、工具时它派子代理去查绝不问你任何自己能查到的东西也不阻塞——只有依赖这次探查的下游问题等它回报前沿其余问题现在就先问。决策权始终在你每个决策都摆到你面前然后等。当场落盘术语一解决就写进 CONTEXT.md绝不攒到结尾批量补。决策若同时满足难以逆转、日后缺少上下文会让人觉得奇怪、是真实权衡的结果就落一份 ADR 到 docs/adr/三关缺一道就跳过。终止前沿为空时会话结束——设计树每条分支都走过没有任何东西被默默假设。你确认达成共识之前它不基于这些内容采取任何行动。落盘的长什么样一场会话会落盘三类东西但它们并不对等术语进术语表过三关的决策变 ADR其余一切只存在于对话里。术语表刻意只做术语表不写实现细节、不写规格、不写草稿笔记。术语表变锋利了、ADR 是零的会话是正常且符合设计的。术语表 CONTEXT.md 怎么写标准结构在 CONTEXT-FORMAT.md骨架如下# {上下文名称} {一两句话这个上下文是什么、为什么存在} ## Language **Order**: {对该术语一两句话的定义} _Avoid_: Purchase, transaction **Customer**: 下订单的人或组织。 _Avoid_: Client, buyer, account书写规则有主见同一概念存在多个词时挑最好的一个其余列进_Avoid_从此弃用定义紧凑最多一两句话定义它是什么不是做什么只收项目专属术语通用编程概念超时、错误类型、工具模式即使项目大量使用也不收自然聚簇时用子标题分组所有术语同属一个内聚区域时平铺列表也行。结构推断根目录存在CONTEXT-MAP.md说明是多上下文仓库读地图找各上下文的位置与关系例如 Ordering 发事件、Fulfillment 消费事件只有根 CONTEXT.md 则按单上下文处理两者皆无就在第一个术语解决时懒创建根文件。多上下文下它推断当前话题属于哪个上下文不确定就问你。ADR 格式与够格清单ADR-FORMAT.md 规定ADR 存放在docs/adr/顺序编号0001-slug.md、0002-slug.md依此类推编号取目录中现存最大编号加一目录同样懒创建只在第一份 ADR 需要时建立。模板极简# {决策的短标题} {1-3 句话背景是什么、决定了什么、为什么}一段话就够。价值在记录做了决定和为什么不在填满小节。可选章节只在真正有价值时加Status frontmatterproposed | accepted | deprecated | superseded by ADR-NNNN、Considered Options被否掉的方案值得记住才写、Consequences需要点名非显而易见的连锁影响才写。值得记录的决策类型架构形态我们用 monorepo写模型事件溯源、读模型投影到 Postgres上下文之间的集成方式Ordering 与 Billing 走领域事件通信不走同步 HTTP带锁定效应的技术选型数据库、消息总线、认证提供方、部署目标——只记换掉要花一个季度的那种不是每个库边界与范围决策Customer 数据归 Customer 上下文所有其他上下文只按 ID 引用明确的不做什么和做什么同等值钱对显而易见路径的刻意偏离用手写 SQL 而不是 ORM凡是合理读者会默认相反的都要记免得下一位工程师去修正一个刻意为之的决定代码里看不见的约束合规要求不能用 AWS合作方契约要求响应低于 200ms被否掉的替代方案否掉理由不明显时权衡过 GraphQL 选了 REST 就记下来否则六个月后还会有人再提 GraphQL。多数会话产出零份 ADR这才是常态。出了问题怎么查依赖未加载症状问题一次性倾倒没有编号、没有推荐答案、从没提过 CONTEXT.md。原因grilling 与 domain-modeling 都没加载一行委托没人接住它只能靠猜。还有更隐蔽的半加载grilling 进场、domain-modeling 缺席于是访谈质量很好磁盘上一个文件没有。这是报告最多的问题与模型和 effort 级别相关。处理直接问 Agent 它加载了哪些技能补齐两个依赖再跑。跑完没有产物症状会话正常结束仓库里却没有任何新文件。原因有二。平庸的没有新词汇决策也没过三关确实无物可写。真正的 bug当它运行在另一层编排里规格驱动开发包装器、多 Agent 框架、把它当一步的流水线规则写文件那一半会静默不发生访谈却照跑。该问题已登记、未修复。处理处于这种配置时先回去看一眼工作目录再相信会话输出。精确答案在下游被稀释症状顺序保证、否定性需求、数值默认值这些精确回答只活在对话里下游一综合就弱化成含糊散文结果看着完整、却丢了真正决定的东西。术语表不是规格大多数回答也挣不到 ADR没有任何账本把已解决的答案一路对应到规格和测试。处理保留会话原样喂给 to-spec再拿自己的回答逐条重读生成的规格。一个容易被忽略的合法用法把它指向完全没有任何文档的既有仓库说帮我记录我的仓库。它会读代码、就发现的东西提问而代码库里已有的哪些词是正确的词由你拍板。它在构建链的哪个位置grill-with-docs → to-spec → to-tickets → implement → code-review它站在链首先于任何规格被写下来产出的是共享理解加上已敲定的词汇to-spec 拿到后直接综合成规格不用再来访谈你一遍。近亲各一句话grill-me同样的访谈节奏但没有仓库、不写文件domain-modeling它驱动的术语表与 ADR 纪律二者都建立在 grilling 原语之上wayfinder多会话规划器把装不下的工程铺成决策票据地图可下探出一次 grilling 会话to-spec把当前对话综合成规格implement改动小到可以立即构建时直奔这里。拿不准该用哪个技能或流程找 ask-matt它是个路由器。装好跑第一次Claude Code 安装会话内也可用/plugin install mattpocock-skillsclaude plugins install mattpocock-skills之后在每个仓库跑一次/setup-matt-pocock-skills完成配置。Codex、其他 Agent 以及想自己改源码的人npx skillslatest add mattpocock/skills安装器会让你挑选要装哪些技能——务必勾选setup-matt-pocock-skills、grilling、domain-modeling缺了后两者grill-with-docs 就是一行空壳。第一次调用三步走进入目标仓库确认处于可安全写入的状态输入/grill-with-docs预期看到第一轮编号问题每个问题下面跟着一条推荐答案➡️ 标记。验证它在正常工作CONTEXT.md 在会话期间逐词变化而非结尾一次性冒出术语表是纯词汇、没有实现细节代码库能回答的问题由读代码回答而不是问你ADR 很少或为零它敢拿既有术语表里不同的定义来挑战你刚用的词。会话结束后把这段对话原样交给 to-spec 去合成规格别急着清上下文窗口。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一次会话搞定设计对齐与领域文档沉淀：grill-with-docs 完全解析
一次会话搞定设计对齐与领域文档沉淀grill-with-docs 完全解析【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills你和 Agent 刚敲定整套设计边界、术语、取舍上下文窗口一关共识就蒸发了下次动手又得从头推导一遍。grill-with-docs 就是为这件事设计的它用一场逐轮提问的 Agent 设计访谈逼你把想法说清楚同时在同一场会话里把术语沉淀进CONTEXT.md、把硬决策沉淀进ADR文件让共识以文件形式留在磁盘上。一句话定义访谈 写作双引擎一句话grill-with-docs 是面向代码库的单会话设计访谈一边帮你对齐与 Agent 的理解一边把术语和关键决策写进仓库。它的入口文件 grill-with-docs/SKILL.md 正文只有一行Call the Skill tool twice, for grilling and domain-modeling.这是一套委托架构自己不实现任何逻辑而是把活拆给两个引擎——访谈引擎 grilling 提供设计树 逐轮提问的机制写作引擎 domain-modeling 提供术语辨析与落盘纪律。同系列的其他访谈技能聊完东西留在你脑子里这一套东西落在磁盘上一个术语被敲定当场进术语表一个决策过了三道门槛当场变成 docs/adr/ 里的一份 ADR。元数据里还有disable-model-invocation: true对应 openai.yaml 的allow_implicit_invocation: false含义是你只能敲/grill-with-docs手动触发它Agent 永远不会自己伸手去用。选型决策你手头是什么你处的情况该用哪个不在任何工作目录里只想先把想法聊透grill-me在仓库里改动一次会话能敲定grill-with-docs工作量一次会话装不下绿地构建、大功能wayfinder仓库零领域文档也没想好具体功能grill-with-docs目标对准仓库本身决策卡在别人脑子里的知识上to-questionnaire它和 wayfinder 的分水岭就是会话次数单会话规划用/grill-with-docs多会话规划用/wayfinder。后者先把工作铺成一张决策票据地图再逐张解决更慢也更稠密在一个范围良好的功能上伸手去用它是个常见错误。一次会话怎么跑完按时间线走一遍前置检查仓库处于可安全写入的位置且 grilling、domain-modeling 两个依赖技能在场——入口文件不过是一行委托少了谁它都跑不起来。术语落在根目录CONTEXT.md若根目录有CONTEXT-MAP.md则落进对应上下文的CONTEXT.md决策落在docs/adr/。两类文件都是懒创建第一个术语或决策结晶之前什么都不会凭空出现。逐轮跑树访谈把问题建模成一棵设计树——每个决策都分支出若干挂在它下面的子决策。每轮只问前沿前置条件已全部敲定的决策集合也就是现在就能问、不必靠猜的问题。问题编号每个都附上推荐答案然后等你回答再进下一轮。查事实是它的活拍板是你的活前沿问题需要环境里的事实文件系统、工具时它派子代理去查绝不问你任何自己能查到的东西也不阻塞——只有依赖这次探查的下游问题等它回报前沿其余问题现在就先问。决策权始终在你每个决策都摆到你面前然后等。当场落盘术语一解决就写进 CONTEXT.md绝不攒到结尾批量补。决策若同时满足难以逆转、日后缺少上下文会让人觉得奇怪、是真实权衡的结果就落一份 ADR 到 docs/adr/三关缺一道就跳过。终止前沿为空时会话结束——设计树每条分支都走过没有任何东西被默默假设。你确认达成共识之前它不基于这些内容采取任何行动。落盘的长什么样一场会话会落盘三类东西但它们并不对等术语进术语表过三关的决策变 ADR其余一切只存在于对话里。术语表刻意只做术语表不写实现细节、不写规格、不写草稿笔记。术语表变锋利了、ADR 是零的会话是正常且符合设计的。术语表 CONTEXT.md 怎么写标准结构在 CONTEXT-FORMAT.md骨架如下# {上下文名称} {一两句话这个上下文是什么、为什么存在} ## Language **Order**: {对该术语一两句话的定义} _Avoid_: Purchase, transaction **Customer**: 下订单的人或组织。 _Avoid_: Client, buyer, account书写规则有主见同一概念存在多个词时挑最好的一个其余列进_Avoid_从此弃用定义紧凑最多一两句话定义它是什么不是做什么只收项目专属术语通用编程概念超时、错误类型、工具模式即使项目大量使用也不收自然聚簇时用子标题分组所有术语同属一个内聚区域时平铺列表也行。结构推断根目录存在CONTEXT-MAP.md说明是多上下文仓库读地图找各上下文的位置与关系例如 Ordering 发事件、Fulfillment 消费事件只有根 CONTEXT.md 则按单上下文处理两者皆无就在第一个术语解决时懒创建根文件。多上下文下它推断当前话题属于哪个上下文不确定就问你。ADR 格式与够格清单ADR-FORMAT.md 规定ADR 存放在docs/adr/顺序编号0001-slug.md、0002-slug.md依此类推编号取目录中现存最大编号加一目录同样懒创建只在第一份 ADR 需要时建立。模板极简# {决策的短标题} {1-3 句话背景是什么、决定了什么、为什么}一段话就够。价值在记录做了决定和为什么不在填满小节。可选章节只在真正有价值时加Status frontmatterproposed | accepted | deprecated | superseded by ADR-NNNN、Considered Options被否掉的方案值得记住才写、Consequences需要点名非显而易见的连锁影响才写。值得记录的决策类型架构形态我们用 monorepo写模型事件溯源、读模型投影到 Postgres上下文之间的集成方式Ordering 与 Billing 走领域事件通信不走同步 HTTP带锁定效应的技术选型数据库、消息总线、认证提供方、部署目标——只记换掉要花一个季度的那种不是每个库边界与范围决策Customer 数据归 Customer 上下文所有其他上下文只按 ID 引用明确的不做什么和做什么同等值钱对显而易见路径的刻意偏离用手写 SQL 而不是 ORM凡是合理读者会默认相反的都要记免得下一位工程师去修正一个刻意为之的决定代码里看不见的约束合规要求不能用 AWS合作方契约要求响应低于 200ms被否掉的替代方案否掉理由不明显时权衡过 GraphQL 选了 REST 就记下来否则六个月后还会有人再提 GraphQL。多数会话产出零份 ADR这才是常态。出了问题怎么查依赖未加载症状问题一次性倾倒没有编号、没有推荐答案、从没提过 CONTEXT.md。原因grilling 与 domain-modeling 都没加载一行委托没人接住它只能靠猜。还有更隐蔽的半加载grilling 进场、domain-modeling 缺席于是访谈质量很好磁盘上一个文件没有。这是报告最多的问题与模型和 effort 级别相关。处理直接问 Agent 它加载了哪些技能补齐两个依赖再跑。跑完没有产物症状会话正常结束仓库里却没有任何新文件。原因有二。平庸的没有新词汇决策也没过三关确实无物可写。真正的 bug当它运行在另一层编排里规格驱动开发包装器、多 Agent 框架、把它当一步的流水线规则写文件那一半会静默不发生访谈却照跑。该问题已登记、未修复。处理处于这种配置时先回去看一眼工作目录再相信会话输出。精确答案在下游被稀释症状顺序保证、否定性需求、数值默认值这些精确回答只活在对话里下游一综合就弱化成含糊散文结果看着完整、却丢了真正决定的东西。术语表不是规格大多数回答也挣不到 ADR没有任何账本把已解决的答案一路对应到规格和测试。处理保留会话原样喂给 to-spec再拿自己的回答逐条重读生成的规格。一个容易被忽略的合法用法把它指向完全没有任何文档的既有仓库说帮我记录我的仓库。它会读代码、就发现的东西提问而代码库里已有的哪些词是正确的词由你拍板。它在构建链的哪个位置grill-with-docs → to-spec → to-tickets → implement → code-review它站在链首先于任何规格被写下来产出的是共享理解加上已敲定的词汇to-spec 拿到后直接综合成规格不用再来访谈你一遍。近亲各一句话grill-me同样的访谈节奏但没有仓库、不写文件domain-modeling它驱动的术语表与 ADR 纪律二者都建立在 grilling 原语之上wayfinder多会话规划器把装不下的工程铺成决策票据地图可下探出一次 grilling 会话to-spec把当前对话综合成规格implement改动小到可以立即构建时直奔这里。拿不准该用哪个技能或流程找 ask-matt它是个路由器。装好跑第一次Claude Code 安装会话内也可用/plugin install mattpocock-skillsclaude plugins install mattpocock-skills之后在每个仓库跑一次/setup-matt-pocock-skills完成配置。Codex、其他 Agent 以及想自己改源码的人npx skillslatest add mattpocock/skills安装器会让你挑选要装哪些技能——务必勾选setup-matt-pocock-skills、grilling、domain-modeling缺了后两者grill-with-docs 就是一行空壳。第一次调用三步走进入目标仓库确认处于可安全写入的状态输入/grill-with-docs预期看到第一轮编号问题每个问题下面跟着一条推荐答案➡️ 标记。验证它在正常工作CONTEXT.md 在会话期间逐词变化而非结尾一次性冒出术语表是纯词汇、没有实现细节代码库能回答的问题由读代码回答而不是问你ADR 很少或为零它敢拿既有术语表里不同的定义来挑战你刚用的词。会话结束后把这段对话原样交给 to-spec 去合成规格别急着清上下文窗口。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考