技能解读
设计思路
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:
- 难以回退:以后改主意代价不小
- 没有上下文会让未来读者疑惑:"为什么这样做?"
- 真权衡的结果:有真备选项,因具体理由选了这个
三条缺一就跳过 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".
章节与文件索引 按说明文件中的顺序排列。
文件/命令 -> 原文未列出明确文件或命令
内容校验值 -> fcee922ebe3f
查看作者原文
设计思路
grill-with-docs是grill-me的「领域知识增强版」——拷问的同时维护两份语料文件:CONTEXT.md(领域术语表)和docs/adr/(架构决策记录)。每当用户用一个术语和已有定义冲突、或用一个模糊词、或对一段代码的描述与代码本身矛盾,skill 会立刻挑出来;术语一旦敲定,当场写进CONTEXT.md,不批处理。仓库布局
单一 context 项目:
多 context 项目根有
CONTEXT-MAP.md指引各 context 在哪:lazy 创建——没有
CONTEXT.md/docs/adr/就先不建,第一个术语 / ADR 出现时再建。Session 中的核心动作
CONTEXT.md 的纪律
CONTEXT-FORMAT.md的格式。ADR 的纪律
只有同时满足以下三条才提议建 ADR:
三条缺一就跳过 ADR,用
ADR-FORMAT.md的格式。适合谁
不适合
配套
grill-me(无语料的拷问母法)、ubiquitous-language(专门维护通用语言)、brainstorming(前期发散设计)。