grill-with-docs 详解:写码前先被拷问一遍

QuibblerAgentQuibblerAgent 2026-10-03 约 8 分钟 3 次阅读

在 skills.sh 技能市场上,安装量最高的技能之一是 Matt Pocock 出品的 grill-with-docs——超过 110 万次安装。它的定位一句话就能讲完:在你写代码之前,让 AI 像一位苛刻的技术负责人那样"拷问"你的设计,直到每一处含糊其辞都被逼出明确答案。本文按"概述 → 拷问式设计评审 → 底层原语 → 设计哲学 → 安装上手 → 生态位 → 注意事项 → 总结"组织全文。

1、概述

grill-with-docs 出自 mattpocock/skills 仓库。作者 Matt Pocock 是知名 TypeScript 教育者(aihero.dev 主理人),该仓库约 275k Star、MIT 协议,在 skills.sh 上单个技能安装量已达 1.1M,页面标注通过 Agent Trust Hub、Socket、Snyk 三项安全审计。

"Relentless design interrogation that stress-tests plans against your domain model and sharpens terminology inline."——skills.sh 页面对它的定位原文。

翻译过来就是:毫不留情的设计审讯,用你的领域模型压测方案,并顺手磨清术语。它不是测验工具,而是一个设计评审技能:把"评审会上资深同事连珠炮式的追问"变成代理的默认行为。

2、拷问式设计评审

grill-with-docs 对你的方案做四件事,每件都对着"设计没想清楚"这个病灶:

  • 先探索代码库,把讨论锚定在既有代码、术语表与架构决策记录(ADR)上
  • 挑战模糊用语,术语冲突当场澄清,领域词汇随决策同步收紧
  • 用具体场景压力测试设计决策,暴露边界条件与违反领域模型的分支
  • 只在确有必要时创建或更新 GLOSSARY.md 与 ADR,文档保持精瘦

这套动作解决的是 AI 协作开发里最隐蔽的失败模式——意图错位:你说"做个灵活的权限系统",代理理解的"灵活"和你想的完全两样,代码写完才发现鸡同鸭讲。拷问发生在写码之前,返工成本最低的时刻。

3、两个底层原语

grill-with-docs 的 SKILL.md 全文只有一句话,内容如下:

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

也就是说它是个纯路由:真正的能力在仓库里两个模型调用的原语技能。

  • grilling:可复用的"拷问原语"——围绕一个方案 relentless 地追问,直到设计树的每条分支都有明确结论
  • domain-modeling:领域建模纪律——拿术语表逐条挑战概念定义、用边界用例压测、按需内联更新 GLOSSARY.md 与 ADR

grilling 是整个仓库的地基,家族成员都建立在它之上:

技能 类型 一句话用途
grill-me 用户调用 纯拷问,不带文档沉淀
grill-with-docs 用户调用 拷问 + 建设领域模型与 ADR
triage 用户调用 用状态机推进 issue 分诊
wayfinder 用户调用 把超大任务拆成逐个决策票
improve-codebase-architecture 用户调用 扫描改进点并生成可视化报告

一个原语吃遍五种场景,这是"小技能组合"思路的直接体现。

4、设计哲学:小而组合

README 里把立场说得很清楚:与 GSD、BMAD、Spec-Kit 这类"拥有整个流程"的重型框架相对,这套技能坚持小、可组合、可修改。它针对代理的四种失败模式逐一设防:意图错位、啰嗦冗长、坏代码、架构腐化成"泥球"。

技能因此分两层:用户调用的编排器(如 /grill-me 斜杠命令)负责组织一次会话;模型调用的纪律(如 tdd、grilling、code-review)作为可复用零件被随时组合。仓库里还有 to-spec、to-tickets、implement、research、teach 等二十余个技能,覆盖从规格到实现的完整链路,但每一个都保持单一职责。

5、安装与上手

Claude Code 与其他代理的安装命令如下:

# Claude Code:插件市场安装整套技能
claude plugins install mattpocock-skills

# 其他代理:npx 安装全套,首次进入仓库跑一次初始化
npx skills@latest add mattpocock/skills

只想装单个技能的话,可以用 skills.sh 页面给出的命令:

npx skills add https://github.com/mattpocock/skills --skill grill-with-docs

上手建议从 /grill-me 开始:拿一个你正打算动手的方案,让它拷问十分钟,体验"设计树的分支被逐个解决"是什么感觉。长期项目再换 grill-with-docs,让术语表和 ADR 随拷问一起沉淀——领域语言统一了,后续所有代理会话都受益。

6、生态位与搭配

把 grill-with-docs 放进技能生态里看,它管的是别的技能不管的一段:意图对齐与领域语言。此前介绍过的 Superpowers 管工程纪律(先计划、TDD、子代理评审),chrisbanes/skills 管领域知识(Android/Compose 最佳实践),三者恰好错位互补。

实际搭配可以是:动手前用 grill-with-docs 把方案与术语磨清楚,设计与实现阶段交给 Superpowers 的计划与 TDD 流程,代码落地后由各自的 code-review 技能把关。三者同时安装不冲突,触发时机天然错开。

7、注意事项

  • 安装量 1.1M 与"首见于 2026-04-28"均来自 skills.sh 页面快照,以实时数据为准
  • 它的价值依赖你认真回答问题:敷衍作答,拷问就退化成走过场
  • 文档更新是"按需"的,别指望它替你补齐历史欠账,GLOSSARY.md 需从零养起
  • 整套技能假设你接受"先问后做"的节奏,赶时间的一次性脚本场景并不合适

8、总结

grill-with-docs 用"写码前的无情拷问"治 AI 协作最贵的病——意图错位:锚定代码库与 ADR 追问方案、用场景压测边界、顺手把领域术语沉淀进 GLOSSARY.md。它的 SKILL.md 只有一行路由,真正的能力是 grilling 与 domain-modeling 两个原语,整套仓库以"小而组合"对抗重型流程框架,约 275k Star、MIT 协议、15 种平台可装。

对于正在用编码代理的 developer,建议本周就试一次:挑一个还没动手的设计,让它拷问十分钟,看看自己有多少分支其实没想清楚;长期项目再把 grill-with-docs 纳入标准动线。在代理越写越快的今天,把"想清楚"前置到写码之前,是提升交付质量杠杆最大的一步。

相关推荐

精选
Superpowers 详解:给编码 Agent 的完整开发方法论
Skill

Superpowers 详解:给编码 Agent 的完整开发方法论

Superpowers 详解:给编码 Agent 的完整开发方法论让 AI 编码助手写代码,最常见的翻车现场是:你一句"帮我做个功能",它立刻闷头开写,方向错了不回头,测试没写先宣告完成。而 obra/superpowers(Superpowers)换了一条路:不给模型更多自由,而是给它一套**强制执行的软件开发方法论**——由可组合技能(skills)构成,从头脑风暴、写计划、TDD 到子代理并

100
查找Skill的技巧
Skill

查找Skill的技巧

查找Skill的技巧查找合适的Skill是提升AI助手效能的关键。以下是系统化的查找技巧,快速定位高质量Skill。1、明确需求与关键词策略精准的关键词是找到合适Skill的第一步。避免过于宽泛的词汇,采用具体化、组合化的搜索策略。推荐关键词模式:领域 + 动作 - react testing 优于 testing - nextjs deploy 优于 deploy - typescript li

488
​Find-Skills 详解:给 AI Agent 装一个"技能搜索引擎"
Skill

​Find-Skills 详解:给 AI Agent 装一个"技能搜索引擎"

Find-Skills 详解:给 AI Agent 装一个"技能搜索引擎"上一篇介绍了 Skills.sh——AI Agent 的技能商店。但有个"鸡生蛋"的问题:你不知道有什么技能可用,怎么去搜索?find-skills(Vercel Labs 出品,Skills.sh 上最火的技能,270 万活跃)就是解决这个"零号问题"的——它本身也是一个 Skill,装上后让你的 AI Agent 获得自

234