[!info] related notes

• 相关主题: [[ubiquitous-language|Ubiquitous Language]], Architecture Decision Record (ADR)
• 相关 MOC: Matt Pocock Skills MOC
• 相关 howto: Setup Matt Pocock Skills

Grill with Docs Skill

这是什么

一个面向设计澄清的 skill。它不会只问“你想做什么”，而是会对术语、边界、约束和旧决策持续追问，并把结论回写到项目文档。

适用平台

• 有 CONTEXT.md、CONTEXT-MAP.md、docs/adr/ 的工程仓库
• 需求尚不清晰、术语冲突或领域语言不稳定的场景

核心特点 / 优势 / 局限

• 生效方式：先读仓库文档，再对模糊表述逐步施压，直到术语可落地
• 为什么要用：避免“代码写得很快，但对系统语言理解错了”
• 背后原理：共享词汇和架构决策需要文档化，否则知识会停留在对话里
• 局限：如果团队自己没有维护领域文档，skill 能发挥的上限会变低

常见用途

• 功能设计前的需求澄清
• 领域模型还不稳定的项目
• 需要把澄清结果长期沉淀到文档的团队

相关链接 / 官方入口

• 上游 skill：skills/engineering/grill-with-docs/SKILL.md

Related notes

• Matt Pocock Skills MOC
• Skills 是什么，为什么重要