两个工具各做什么

你的理解可以简化成一句话：Trellis 往项目里放一套工作流；grill-with-docs 是装在 Codex 全局环境里的需求梳理 skill。

项目级

Trellis：管开发流程

它既是一个 CLI，也是初始化后留在项目里的工作流框架。

• 任务处于规划、实现还是检查阶段
• 需求、设计和实施计划放在哪里
• AI 开工前需要读取哪些项目规范
• 完成后如何验证、沉淀和提交

全局 skill

grill-with-docs：管想清楚

它一次只问一个关键问题，直到你和 AI 对需求达成共同理解。

• 能查到的事实由 AI 自己查
• 真正的产品决定由你拍板
• 术语写进 CONTEXT.md
• 少数重大决定写进 docs/adr/

为什么名字看起来有三个

grill-with-docs ├── grilling 一次问一个问题，把需求问透 └── domain-modeling 整理术语，必要时记录 ADR

grill-with-docs 是组合入口，内部调用 grilling 和 domain-modeling。平时只需要点名 $grill-with-docs，不必分别调用另外两个。

它会帮你记住什么

CONTEXT.md：只记录领域术语

例如“账户”究竟指登录用户、券商账户还是资金账户。它不是需求文档、技术设计或临时笔记。

docs/adr/：只记录少数重大决定

只有同时满足下面三点才值得创建 ADR：

1. 难以撤销：以后换方案有明显成本。
2. 没有上下文会令人意外：未来的人会问“为什么这样做”。
3. 存在真实取舍：比较过多个有代价的选项并做出了选择。

普通颜色、按钮位置和随时可以重改的小决定，不需要 ADR。

最常用的一段话

Trellis + grill-with-docs

按 Trellis 创建一个新任务并进入 planning 阶段。

需求梳理时使用 $grill-with-docs：
CONTEXT.md 只记录领域术语，
docs/adr 只记录难以撤销、令人意外且存在真实取舍的架构决定。

然后将本次任务需求和验收条件写入 Trellis PRD。
复杂任务同时补全 design.md 和 implement.md。
读取已经确认的 CONTEXT 和 ADR，不要重复询问已经解决的问题。

需求：[写你的想法，模糊一点也没关系]

不需要每次都 grill

grill 是为模糊和取舍服务的。改错字、调整一个明确样式、修复原因清楚的小 bug，直接做会更合适。