与文档一起烧烤

工程开发 社区

技能解读

设计思路

grill-with-docs 是 grill-me 的「领域知识增强版」——拷问的同时维护两份语料文件:CONTEXT.md(领域术语表)和 docs/adr/(架构决策记录)。每当用户用一个术语和已有定义冲突、或用一个模糊词、或对一段代码的描述与代码本身矛盾,skill 会立刻挑出来;术语一旦敲定,当场写进 CONTEXT.md,不批处理。

仓库布局

单一 context 项目:

/
├── docs/adr/  ← system-wide decisions
├── CONTEXT.md
├── src/

多 context 项目根有 CONTEXT-MAP.md 指引各 context 在哪:

/
├── CONTEXT-MAP.md
├── docs/adr/                          ← system-wide decisions
├── src/
│   ├── ordering/
│   │   ├── CONTEXT.md
│   │   └── docs/adr/                 ← context-specific decisions
│   └── billing/
│       ├── CONTEXT.md
│       └── docs/adr/

lazy 创建——没有 CONTEXT.md / docs/adr/ 就先不建,第一个术语 / ADR 出现时再建。

Session 中的核心动作

  • Challenge against the glossary:术语和已有定义冲突就立刻提:「你的 glossary 把『cancellation』定义为 X,但你这里似乎指 Y——到底是哪个?」
  • Sharpen fuzzy language:模糊或重载的词出现时提议精确替换:「你说的『account』指 Customer 还是 User?这两件事不一样。」
  • Discuss concrete scenarios:讨论领域关系时用具体场景压力测——构造边界 case 强迫对方精确化。
  • Cross-reference with code:用户讲的工作机制和代码不一致时立刻挑:「你的代码取消整个 Order,但你刚才说支持部分取消——哪个是对的?」
  • Update CONTEXT.md inline:术语敲定就当场写入,不批处理。

CONTEXT.md 的纪律

  • 是 glossary,不是 spec / 草稿 / 实现决策的归宿——纯粹术语表,绝不混实现细节。
  • 用 CONTEXT-FORMAT.md 的格式。

ADR 的纪律

只有同时满足以下三条才提议建 ADR:

  1. 难以回退:以后改主意代价不小
  2. 没有上下文会让未来读者疑惑:"为什么这样做?"
  3. 真权衡的结果:有真备选项,因具体理由选了这个

三条缺一就跳过 ADR,用 ADR-FORMAT.md 的格式。

适合谁

  • 在做 DDD(领域驱动设计)的项目
  • 团队术语长期混乱、需要建 ubiquitous language 的产品
  • 写 ADR 但不知道何时该写、何时该跳过的工程负责人

不适合

  • 简单 CRUD / 工具脚本——没有领域复杂度
  • 临时实验——ADR 写出来很快就过时

配套

grill-me(无语料的拷问母法)、ubiquitous-language(专门维护通用语言)、brainstorming(前期发散设计)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
84 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@mattpocock · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

Call the Skill tool twice, for "grilling" and "domain-modeling".

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。