一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | grill-with-docs | 合集仓库子目录名（见下方说明） |
| 所属合集仓库 | mattpocock/skills（Matt Pocock 个人维护的 Agent Skills 公开仓库） | GitHub |
| 作者/维护者 | Matt Pocock（Total TypeScript 创始人，AI 工程教育者，个人 Newsletter 订阅者约 6 万） | 仓库 README |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/engineering/grill-with-docs | — |
| 许可证 | MIT | GitHub API |
| 所属仓库整体 Stars/Forks | 171,844 / 14,761（注：该数字属整个合集仓库，不代表本技能自身热度，仅供了解仓库整体规模） | GitHub API |
| 该技能自身活跃度 | GitHub 全站代码搜索中，文件内容命中 “grill-with-docs” 的仓库/文件共 4044 个（含多个第三方改编项目，如把该模式移植到威胁建模场景的 grill-threat-model）；另有至少 5 篇独立第三方文章专门介绍该技能 | GitHub Code Search API + WebFetch |
| 最新版本 | v1.1.0（2026-07-08 发布） | GitHub Releases API |
| 安装方式 | npx skills@latest add mattpocock/skills 或 Claude Code 插件市场一条命令安装（见第十章） |
官方 README |
二、功能介绍与亮点
grill-with-docs 是一个组合技能：触发 /grilling（逐题追问会话）的同时联动 /domain-modeling（领域建模），在动手写代码或做架构决策之前，先把需求歧义和团队黑话挤干净，并把过程中的共识实时写成文档。
核心能力：
- 逐题式追问：每次只问一个问题，且附带作者推荐的答案供你确认或推翻，等回答完再问下一题，避免“一次甩十个问题”的迷惑体验；能靠翻查代码/文件系统确认的事实不问你，只把真正需要拍板的决策交给你
- 术语表实时维护：讨论中出现的模糊词或与已有
CONTEXT.md冲突的说法会被当场指出并澄清，形成项目专属的“通用语言”，减少 agent 因术语不统一而产生的啰嗦与跑题 - 架构决策记录（ADR）按需生成：仅当决策同时满足“难以回滚”“对未来读者是意外”“确有真实取舍”三个条件时才建议写 ADR，避免文档膨胀成噪音
- 组合而非接管：grill-with-docs 本身只是“运行 /grilling 会话，并调用 /domain-modeling 技能”的薄封装，体现该仓库“小、可拼、可改”的整体哲学，而非像部分同类框架那样接管整个开发流程
- 作者在 README 中明确将其与轻量版
/grill-me并列为仓库中“最受欢迎的两个技能”，并称其为“仓库里最酷的技巧”，日常工程中每次开工前都会使用
三、适用场景
固定分类：元技能与 Agent 增强
适用于：新功能开工前的需求澄清、跨团队或跨 agent 协作前对齐领域术语、复杂重构或架构决策前捕捉隐藏假设、把口头讨论沉淀为可复用的 CONTEXT.md 术语表与 ADR 决策记录。受益人群：独立开发者、需要频繁与 AI 协作但担心“AI 理解错了却没被发现”的工程师、需要长期维护项目领域知识库的团队。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 提供 Claude Code 插件市场安装路径，技能本身按 SKILL.md 规范编写 |
| Codex | 原生支持 | 官方 README 明确说明“skills.sh 安装器已经把这些技能装进 Codex 等遵循 Agent-Skills 标准的运行时” |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw 专门支持 |
| Hermes Agent | 未验证 | 同上 |
五、推荐理由
AI 编程里“没说清楚就开始写”是返工的头号原因；grill-with-docs 用强制的单问单答追问，把这个问题挤到写代码之前解决，还顺手把每次讨论沉淀成团队和 agent 都能复用的术语表与决策记录。它不是又一个试图接管全流程的框架，而是一个可以单独拿走、随手改的小工具，契合初中级用户“想要立刻能用、又不想被某套流程绑架”的诉求。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 单个子技能维度：GitHub 代码搜索命中 4044 处、≥5 篇独立第三方文章、且已产生第三方改编（grill-threat-model），构成多平台大量独立讨论（合集仓库整体 stars 属整个仓库，不代表本技能自身热度，故不作为本项依据） |
| 可用性 | 9 | 一条命令安装（skills.sh 或 Claude Code 插件），文档完整含示例，6 天前刚发布新版本，无付费依赖 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 9.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 无——SKILL.md 全文纯自然语言指令，不含任何 Bash/工具调用声明 |
| ② 运行时联网外发数据 | 无——不涉及任何网络请求 |
| ③ API Key/凭据要求及存储方式 | 无需任何凭据 |
| ④ 可疑指令/Prompt Injection 迹象 | 未发现——已逐字审阅 grill-with-docs 及其依赖的 grilling、domain-modeling 三份 SKILL.md 全文，均为正常工作流指令 |
| ⑤ 作者/组织信誉 | Matt Pocock，真实身份公开，Total TypeScript 创始人，长期从事 TypeScript/AI 工程教育，公开 Newsletter 约 6 万订阅者 |
| ⑥ License 是否明确 | MIT，明确 |
| ⑦ 最近维护时间 | 最新 tag v1.1.0 于 2026-07-08 发布，仓库最后一次提交为 2026-07-14，维护活跃 |
七、跟同类 Skills 相比的优势
| 维度 | grill-with-docs（本次推荐） | interview-me（addyosmani/agent-skills） | grill-me（同仓库轻量版） | spec-kit（github 官方） |
|---|---|---|---|---|
| 核心机制 | 逐题追问 + 术语表/ADR 文档沉淀 | 逐题追问至“约 95% 置信度”，聚焦挖掘真实意图 | 仅逐题追问，不生成文档 | 命令行工具生成 spec/plan/tasks 全套模板 |
| 产出物 | 对话共识 + 持续更新的 CONTEXT.md + 按需 ADR | 对话共识（不落盘文档） | 对话共识 | 结构化的规格/计划/任务文件体系 |
| 设计哲学 | 小而可拼，用多少拿多少 | 小而可拼，聚焦“问清楚”这一步 | 更轻量的同源版本 | 拥有并接管整个开发流程（作者本人在 README 中直接点名对比） |
| 适合场景 | 需要长期维护领域知识库的项目 | 单次需求澄清、不需要文档沉淀 | 快速对齐、无需产出文档 | 愿意全程遵循固定流程的团队 |
grill-with-docs 相对 interview-me 的差异化在于“边问边写文档”——追问产生的共识不会随对话结束而流失，而是固化进 CONTEXT.md 和 ADR，可被后续会话和其他协作者直接复用；相对 spec-kit 这类流程接管型工具，它保留了对开发过程的完全控制权，出问题时更容易定位和调整。
八、用户评价
- Nowshad Jawad（Medium，The Two Matt Pocock Skills I Use in Almost Every AI Coding Session）：“my planning sessions have become shorter but more effective”，并提到该技能能“surface edge cases early”、让术语在多次会话间保持一致，避免“what did we mean here?“式的返工
- Aditya Kumar Puri（Medium，Matt Pocock’s 5 Claude Code skills made me rewrite how I work with AI agents）：把它称为“the glossary fix”，举例说明有术语表后表达从“course 里某个 section 下的 lesson 被落到文件系统里出了问题”简化为“materialization cascade 出了问题”，并指出“Variables, functions, files end up named consistently. The agent burns fewer tokens because it has a tighter language”
九、其他补充
该技能已产生至少一例公开的第三方改编——开发者将同一“追问+文档沉淀”模式移植用于安全威胁建模场景（grill-threat-model），侧面印证其设计模式的可迁移性。仓库整体通过 Matt Pocock 的技术 Newsletter（约 6 万订阅者）持续同步更新动态。
十、安装使用方式
方式一：skills.sh 安装器（可编辑，推荐希望二次定制的用户）
npx skills@latest add mattpocock/skills安装时会提示选择要装的技能与目标 agent；务必同时勾选 /setup-matt-pocock-skills。装完后在 agent 中运行一次：
/setup-matt-pocock-skills该步骤会询问使用的 issue 追踪工具（GitHub / Linear / 本地文件）、triage 时打的标签、以及文档存放位置。
方式二：Claude Code 插件（只读、随作者更新自动同步）
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock同样需要执行一次 /setup-matt-pocock-skills。
注意事项：grill-with-docs 依赖同仓库内的 grilling 与 domain-modeling 两个技能协同工作，两种官方安装方式都会把整套技能一并装入，无需额外操作；但若手工只拷贝 grill-with-docs 单个文件，会因缺少依赖而无法正常触发。
十一、注意事项
- 技能声明了
disable-model-invocation: true，不会被 agent 自动触发，需要用户主动输入/grill-with-docs调用 - 依赖同仓库的
grilling、domain-modeling两个技能，选择性/手工安装时需一并带上，否则会缺依赖 - OpenClaw、Hermes Agent 的兼容性未在已抓取材料中得到证实，标记为“未验证”
- 目前由 Matt Pocock 个人维护，尚无多维护者的治理结构，需自行评估长期维护的连续性风险