grill-with-docs

Grill-With-Docs是由开发者Matt Pocock发起并维护的开源Claude Code工程技能，核心定位是“在一场无情的方案面试中同步生成架构决策记录与术语表，让设计决策从口头讨论沉淀为可追溯的工程资产”——它不满足于做一份简单的方案评审提示词或零散的文档生成工具，而是将系统性质疑、假设检验、边缘案例挖掘、ADR（架构决策记录）生成、术语表维护等能力整合于一个即插即用的斜杠命令中，全部配有/grill-with-docs一键触发、/domain-modeling技能联动和disable-model-invocation: true的精准控制。市面大多方案打磨工具要么只做质疑不做记录（讨论完就忘了），要么只做文档不深入质疑（流于形式）——但很少有项目能将“深度方案面试”与“同步文档沉淀”同时做到，Grill-With-Docs解决的正是这个问题。

一、Grill-With-Docs是什么

Grill-With-Docs采用“斜杠命令+零配置+即插即用”三位一体的使用体验，通过GitHub在Matt Pocock的开源技能仓库中免费发布。项目由开发者Matt Pocock（TypeScript社区知名教育家、Total TypeScript创始人）发起并维护，最后更新于2026年6月12日，是其mattpocock/skills仓库中engineering分类下的核心技能之一。技能文件极简——disable-model-invocation: true确保技能不会在对话中被模型自动调用，仅在用户主动触发/grill-with-docs时才启动。

Grill-With-Docs的运作机制与市面常见的“通用方案评审”或“独立文档生成工具”有本质区别。它不是一句“帮我优化一下这个方案”的泛泛指令，也不是一个“单独生成ADR”的文档工具，而是一套质疑与记录同步进行的结构化工作流。用户只需在Claude Code中输入/grill-with-docs，系统即启动一场“无情的面试”——对当前方案或设计进行系统性追问、假设检验和边缘案例挖掘；与此同时，技能联动/domain-modeling能力，在质疑的过程中同步生成ADR（架构决策记录）和术语表（Glossary） 。每一次追问、每一个被验证的假设、每一个被识别的风险，都被自动记录为结构化的工程文档。这种“边审边记”的设计，让方案打磨从“口头讨论+事后补文档”升级为“质疑即记录、决策即资产”。

二、Grill-With-Docs能做什么

Grill-With-Docs的核心能力可以精炼地概括为：质、记、联、磨、存，围绕这五大维度提供了从方案质疑到文档沉淀的完整闭环，覆盖技术方案评审和架构决策的全方位需求，具体包括：

系统性质疑与方案压力测试（质） ——不是“你觉得怎么样”，而是“如果这个假设不成立呢”。Grill-With-Docs启动一场结构化的“无情面试”，对方案中的每一个核心假设进行追问。它不满足于接受“我觉得这样可行”的表层回答，而是不断追问“为什么”“如果不行呢”“还有没有其他可能”，直到方案的薄弱环节暴露无遗。这种质疑的深度与/grilling一脉相承。

同步生成ADR与术语表（记） ——每一次质疑都是一次文档沉淀。与只做质疑不做记录的/grilling不同，Grill-With-Docs在质疑的同时联动/domain-modeling技能，自动生成架构决策记录（ADR）和术语表（Glossary） 。每一个被讨论的决策、每一个被引入的术语、每一个被识别的风险，都被结构化地记录为可追溯的工程文档。讨论不再“随风而去”，而是变成团队的知识资产。

联动领域建模能力（联） ——质疑与建模的深度融合。技能明确调用/domain-modeling能力，在质疑方案的同时进行领域建模——识别核心领域概念、界定术语边界、建立概念之间的关系。这种“质疑+建模”的联动，让方案评审不仅是“找问题”，更是“建共识”。

方案打磨与决策质量提升（磨） ——在投入工程资源之前发现问题。Grill-With-Docs的价值不在于“告诉你答案”，而在于“帮你自己发现答案并记录下来”。通过结构化的质疑过程和同步的文档生成，团队在方案评审阶段就能识别出原本会在开发中期甚至上线后才暴露的问题，并将决策过程完整存档。

知识资产的可追溯沉淀（存） ——让设计决策经得起时间考验。Grill-With-Docs生成的ADR和术语表不是“事后补的文档”，而是与质疑过程同步产生的活文档。每一个决策都有“为什么这么做”的上下文，每一个术语都有明确的定义。新成员加入团队时，这些文档就是最好的“设计决策说明书”。

三、Grill-With-Docs适合谁用

Grill-With-Docs的内容设计使其适配各类希望在方案评审中同步完成文档沉淀的技术团队，核心聚焦那些“方案评审完就忘了、ADR总是事后补、术语定义永远说不清”的人群，主要涵盖以下几类：

技术团队负责人与架构师——希望每一次架构评审都能产出可追溯的ADR和清晰的术语表，而不是“口头说完了事”的技术领导者。Grill-With-Docs让评审从“走过场”升级为“资产生产”。

产品经理与技术决策者——需要在方案讨论中同步建立领域共识、统一术语定义。Grill-With-Docs的术语表生成能力，帮助团队在讨论中逐步建立共同语言。

希望从“被动执行”升级为“主动思考+主动记录”的工程师——不满足于只做“接需求写代码”，希望参与方案设计并将决策过程文档化的工程师。Grill-With-Docs提供了一条“质疑→记录→沉淀”的完整链路。

技术评审参与者——需要对他人的方案提出有深度的评审意见，并希望评审意见能被结构化记录。Grill-With-Docs让评审从“口头意见”升级为“结构化文档”。

知识管理意识强的团队——重视技术决策的可追溯性，希望建立完整的ADR库和术语表。Grill-With-Docs让文档生成成为评审的“副产品”，而非额外负担。

四、Grill-With-Docs的应用场景是什么

基于其内容设计与定位，Grill-With-Docs的应用场景主要围绕技术方案评审、架构决策记录、领域建模和团队知识沉淀，覆盖从个人思考到团队协作的多个场景，具体包括：

技术方案评审与ADR生成场景——团队完成了技术方案初稿，准备进入评审环节。与其走过场式地“大家有什么意见”，不如在评审会上触发/grill-with-docs，让AI扮演“无情的面试官”对方案进行系统性追问；与此同时，每一个被讨论的决策都被自动记录为ADR，每一个被引入的术语都被收入术语表。评审结束，文档也同步生成。

架构决策的可追溯性建设场景——团队意识到过去的架构决策缺乏记录，新成员加入时无从了解“为什么当初这样设计”。Grill-With-Docs让每一次方案讨论都自动产出ADR和术语表，逐步建立起可追溯的决策库。

领域建模与术语统一场景——团队在讨论新功能时，对核心概念的定义存在分歧（“什么是用户”“什么是订单状态”）。Grill-With-Docs联动/domain-modeling能力，在质疑过程中同步进行领域建模，帮助团队在讨论中逐步建立统一术语。

远程团队异步协作场景——分布式团队难以同步进行方案评审。Grill-With-Docs生成的ADR和术语表，让异步评审有了结构化的输入和输出——即使不在同一时区，团队也能基于同一份文档进行讨论。

技术文档体系化建设场景——团队希望建立完整的技术文档体系，但“写文档”总是被优先级挤压。Grill-With-Docs让文档成为评审流程的天然产出，而非额外的工作量。

五、Grill-With-Docs为什么值得关注

Grill-With-Docs之所以值得关注，核心在于它将“方案评审”与“文档沉淀”从两个独立的活动整合为一个同步进行的工作流，并具备“质疑+记录一体化、零配置触发、官方联动背书”的独特价值，具体体现在以下几点：

从“口头讨论”到“可追溯资产”的质变。大多数方案评审停留在“口头讨论+事后补文档”的模式——讨论时的深度思考随着会议结束而消失，ADR和术语表往往是“事后追忆”的产物，细节丢失、上下文模糊。Grill-With-Docs将质疑与记录同步进行——每一个被追问的假设、每一个被验证的决策、每一个被定义的术语，都在讨论的当下被结构化记录。评审结束，文档也同步完成。这种“讨论即文档”的设计，让技术决策从“易逝的口头共识”升级为“可追溯的工程资产”。

从“单一质疑”到“质疑+建模”的能力升级。Grill-With-Docs是/grilling的工程化进化版——/grilling只做质疑，不产生文档；Grill-With-Docs在质疑的基础上联动/domain-modeling技能，同步生成ADR和术语表。如果说/grilling是“手术刀”，Grill-With-Docs就是“手术刀+病历本”——不仅完成了手术，还记录了全过程。

Matt Pocock的工程方法论背书。Grill-With-Docs的开发者Matt Pocock是TypeScript社区最具影响力的教育家之一，Total TypeScript的创始人，以其对技术深度和教学质量的极致追求闻名。这种“来自社区信任的开发者”的身份，为技能的质量和设计哲学提供了天然的信任背书。

极简设计，极深价值。整个技能文件极简——name、description、disable-model-invocation和联动/domain-modeling的触发指令。这种“极简主义”的设计本身就是一种声明：好的工具不需要复杂的配置和冗长的文档，它的价值在于“在正确的时刻做正确的事”。Grill-With-Docs用最少的配置解决了“方案评审不记录、ADR总是事后补”这个普遍痛点。

与/domain-modeling的深度联动。技能明确调用/domain-modeling能力，这不是简单的“两个技能拼在一起”，而是质疑与建模的深度融合——在质疑方案的过程中，系统自动识别需要建模的领域概念、需要定义的术语边界、需要记录的设计决策。这种“1+1>2”的联动设计，让方案评审从“找问题”升级为“建知识”。

现实挑战与生态成熟度。Grill-With-Docs并非没有短板。首先，技能的深度高度依赖于Claude Code自身的推理能力和/domain-modeling技能的成熟度——如果模型本身的批判性思维或领域建模能力不足，效果会打折扣。其次，技能目前仅作为一个独立的SKILL.md文件存在，缺乏配套的使用指南或最佳实践文档，新用户可能需要自己摸索如何最大化其价值。再次，disable-model-invocation: true意味着技能不会在对话中被自动触发——用户需要主动记住并调用/grill-with-docs。