返回精选库
grill-me·办公与效率

grill-me 使用指南:从安装到把需求问清楚

本文目录

你有一个想法,却还说不清该做什么,或已有方案总觉得方向不对。grill-me 从这里开始:它按轮追问,帮助你澄清目标、范围和取舍。它不要求仓库,也不会读取代码或保存文件;产品、写作和一般决策都能拿来讨论。

下面用“给自己做一个本地 Skills 管理工具”示范第一次对话。示例提示词可以换成你的问题。

1. 安装:按客户端选择方式

**Claude Code 首选作者插件。**在 Claude Code 会话中输入以下命令,按提示安装;已装好则跳过。插件包含 grill-me 和它调用的 grilling,无需 Node.js。

提示词
/plugin install mattpocock-skills

**Codex 使用文件安装。**先准备 Node.js / npm,在终端运行:

命令
npx skills@latest add mattpocock/skills --skill grill-me --skill grilling --agent codex --global

--global 让这两个 Skill 可用于你的其他目录;如果只想在当前项目使用,先进入项目目录并去掉它。安装器如有确认步骤,按提示完成。这里必须同时选择两个 Skill:grill-me 只是入口,实际提问规则在 grilling。

Claude Code 若想安装可编辑文件而不用插件,也可在终端运行 npx skills@latest add mattpocock/skills --skill grill-me --skill grilling --agent claude-code --global。不要同时安装插件和文件版,以免出现两个同名入口。

2. 第一次使用:说清要做什么,以及做到什么程度

在 Claude Code 或 Codex 中开启新对话;不需要先建仓库。如果开启了计划模式,这一步先切回普通对话。下面的内容应发到聊天输入框,不是终端。

Claude Code 插件安装:

提示词
/mattpocock-skills:grill-me 我想做一个本地 Skills 管理工具,给自己用。
现在的问题是:Skills 分散在几个文件夹里,我经常找不到想用的那个。
第一版只验证浏览和搜索,不做账号、云同步或团队协作。
这次先把需求问清楚,暂时不要写代码。

Codex 用 $grill-me:

提示词
$grill-me 我想做一个本地 Skills 管理工具,给自己用。
现在的问题是:Skills 分散在几个文件夹里,我经常找不到想用的那个。
第一版只验证浏览和搜索,不做账号、云同步或团队协作。
这次先把需求问清楚,暂时不要写代码。

如果 Claude Code 用的是文件版,把第一行换成 /grill-me。Codex 则使用 $grill-me,不要把 Claude 的斜杠命令直接照搬。

换成自己的任务时,尽量交代四件事:谁在用、目前哪里不方便、这次想做成什么、哪些事情暂时不做。“我想先做一个能试用的原型”和“我要给客户正式使用”会引出很不一样的问题。技术方案还没想好,可以直接说“未定”,不用为了启动对话先选框架。

接下来,你应该看到围绕需求的编号问题,以及 Agent 对部分选择的建议。它会把当前能够一起回答的问题放在一轮里,等你回复后再继续;没有固定的题数。

3. 回答追问:作出选择,也允许暂时不知道

按问题编号简短回答就够了。仍以 Skills 管理工具为例,如果这一轮问到读取范围、界面和搜索方式,可以这样回复:

提示词
1. 先只读取我手动选中的本地目录,不扫描整个电脑。
2. 需要图形界面,因为我想边浏览边看说明。
3. 搜索名称和简介就够了,第一版不搜文件全文。
4. 暂时不确定要不要编辑文件。请比较“只读”和“可编辑”的成本,再让我选。

这些是回答方式的示例,不是每次都会出现的固定问题。Agent 给出的建议也可以改:告诉它你为什么不选,比单纯回答“不行”更容易把后面的讨论带回正轨。

每轮读完后,检查它是否把“已确定的需求”和“它自己的猜测”混在了一起。例如,你只想浏览本地文件,它却开始讨论用户注册,这时就应当纠正范围。

如果越聊越细、已经超出当前目标,可以直接插入:

提示词
先把讨论收回到这个原型。
请列出现在真正阻碍开始制作的决定,只继续问这些问题。
账号、云同步、团队协作都留到以后,不再展开。
其他尚未确定的细节先标为假设,不要替我把它们变成需求。

如果一轮问题太多,也可以要求“接下来一次只问一个问题,等我回答后再继续”。你不需要为了配合提问方式,一次给出所有答案。

4. 收尾:拿到能继续工作的需求说明

当你能说清谁会用、主要任务是什么、第一版包含哪些功能,以及怎样算完成,就可以要求它做一次总结。先检查关键决定是否遗漏,再确认结束这一轮。

下面这段可以直接接在当前对话里:

提示词
先暂停追问,把刚才确定的内容整理给我确认:
1. 使用者和要解决的问题。
2. 第一版必须完成的功能。
3. 明确暂时不做的功能。
4. 每项功能怎样判断完成,尽量写成可检查的行为。
5. 仍未决定的事项,以及需要通过原型验证的假设。
如果还有会影响开工的缺口,最后单独列出。
先在对话里输出,等我确认。

例如,“支持搜索”还不够具体;对于这个示例,可以进一步确认成“输入 Skill 名称或简介中的关键词,列表显示匹配项;清空关键词恢复完整列表”。这只是验收条件的写法示例,最终规则仍由你决定。

grill-me 本身不会自动保存文档或开始写代码。总结确认后,小任务可以直接在同一对话中要求制定实现计划;需要跨多次会话完成的任务,可以另行要求把确认稿保存到项目文档中。保留这段上下文,通常比换一个空白会话重新描述更省事。

如果你想继续使用作者的整套工程流程,可以再用 to-spec:它会把讨论整理成规格,并写入已配置的需求记录工具。使用前需要安装相应 Skill 并完成 setup-matt-pocock-skills 配置;配置时也可以选择本地 Markdown。首次体验 grill-me 时,先用上面的总结方法即可。

5. 换成自己的任务时,怎样给背景

已有项目要加功能

grill-me 可以讨论改动的目标和取舍,但它不会自动读取现有代码。若你只想做独立的需求讨论,先把有关现状和约束简要告诉它;不要以为输入 /grill-me 就完成了代码调查。

如果问题必须对照仓库中的实现,改用作者的 grill-with-docs:它面向代码库,会读取项目并将确认的术语或符合条件的关键决策写入文档。它还依赖 grilling 和 domain-modeling,需要分别安装。两者解决的问题不同,别把文件写入能力归给 grill-me。

界面做出来了,但总觉得不对

把截图或可以查看的原型一起提供,并说明卡在哪一步。例如:“我进这个页面是想找到最近用过的 Skill,但第一眼全是分类,不知道该点哪里。”然后让它围绕用户目标、操作顺序、页面状态和信息重点提问。

比起只说“再高级一点”,这些信息更容易形成具体修改。颜色、布局或交互手感仍拿不准时,可以先做两个小样再比较,不必把所有视觉决定都停留在问答里。

它一直沿着错误前提提问

先停下来检查前提,再继续讨论。可以输入:

提示词
先不要继续展开方案。
请列出你目前对目标、用户和约束的默认假设。
哪些假设还没有得到我的确认?哪些一旦错误,会改变整个方向?
先让我确认最关键的几项,再继续提问。

这适合处理“它问了很多,但不是我想做的东西”。如果只是某一题不合适,直接纠正那一题即可,不必每次重新梳理全部背景。

6. 实际案例:把一句想法变成 Skills 管理器

鱼皮分享过一个图文案例:从“我想做个东西管理 Skill”出发,经过追问逐步确认管理的是本地 Agent Skills、需要图形界面,以及浏览、编辑和存储等需求,再确定 Electron、React、SQLite 等实现选择,最后交给 Cursor 开发。

鱼皮展示的 Skills 管理工具界面

鱼皮文章中的开发结果截图。

这个例子可以借鉴的是顺序:先确定管理什么、怎么使用,再选择实现方式。上文的练习刻意缩小到“浏览和搜索”,便于第一次尝试;如果你的需求也需要编辑、同步或插件管理,应当把它们作为新的范围决定来讨论,而不是直接照搬案例里的整套技术方案。

7. 常见问题

终端提示找不到 npx

只有使用 Skills CLI 文件安装才需要 npx。从 Node.js 官网 安装 LTS 版本及 npm,再重新打开终端;Claude Code 插件安装可跳过这一步。npx 是终端命令,不是聊天指令。

安装后找不到 grill-me

先确认安装方式和位置。本文使用当前 Skills CLI 的全局文件安装:Claude Code 通常放在 ~/.claude/skills,Codex 放在 ~/.agents/skills;若去掉 --global,项目目录分别是 .claude/skills 和 .agents/skills。自定义配置时以安装器显示的位置为准,不要只在旧的 ~/.codex/skills 中查找。检查 grill-me 与 grilling 两个目录(或链接)里都能打开 SKILL.md。

Codex 的全局文件安装还可以在终端列出:

命令
npx skills@latest list --global --agent codex

确认列表包含 grill-me 和 grilling,再刷新 Agent 会话;若你使用项目安装,在该项目目录去掉 --global 后检查。这个命令列出已安装文件,不会替你补装缺少的依赖。

Codex 可以在支持的输入菜单中用 $ 查找,CLI / IDE 也可用 /skills 选择;仍不显示时重新打开会话或重启客户端。Claude 插件安装则先在 /plugin 中检查是否启用,并尝试完整名称 /mattpocock-skills:grill-me。

如果能找到入口,却提示缺少 grilling,重新运行本文的双 Skill 安装命令。

它很快开始给方案,没有继续问

先确认确实调用了 Skill。另开一个新对话,把当前任务和范围重新交代清楚;作者建议这一步关闭计划模式,先完成连续讨论。还可以补一句“先核实会影响方案的决定,等我回答后再继续”。

是否一定要回答完所有问题

不需要为没有纳入第一版的功能作决定。如果已经具备开始制作的条件,就让它总结并列出剩余不确定项。必须靠实际体验判断的问题,先通过原型验证,再带着结果回来继续讨论。

怎样更新文件安装的版本

本文的全局文件安装可在终端更新这两个 Skill:

命令
npx skills@latest update grill-me grilling --global

如果你按项目安装,则在该项目目录把 --global 换成 --project。

通过 Claude 插件安装的整套 Skills,应使用插件自身的更新方式。

什么时候该停下来换一种工作

适合开始 grill-me 的时刻,是你有一个值得认真讨论、却还不能清楚说明范围的想法。最好从新对话开始,不要先让 Agent 写出一整套计划再要求它追问,那样问题容易围着已有方案打转。它按轮探查没有说清的选择,重点不是达到某个固定问题数,而是每一轮都能用前一轮的回答缩小未知范围。如果问题不断增加,先把目标拆成较小的决定,再分别讨论;某个关键问题确实不知道答案时,可以明确说不知道,安排原型或研究,不用猜一个貌似完整的选择。

这一轮结束的标志是:你能向没参与对话的人解释主要取舍、第一版边界和仍需验证的假设。如果已经能准确描述工作,继续追问未必比直接写规格或开始实现更有帮助;需要把这次讨论带入项目文档时,可在同一对话继续使用相应的规格整理流程。这样前面建立的上下文还能直接发挥作用。

另一个练习:把“做预约网站”问成可试用的第一版

如果换成一家单店咖啡馆的预约页,可以这样开场:“使用 grill-me 讨论一个供到店客人预约小型活动的页面。现在靠私信报名,店员会漏记人数。第一版只处理查看活动、填写姓名与人数、收到确认;支付和会员先不做。请先问会改变流程的选择,不写代码。”接下来最该澄清的是名额由谁维护、满员后能否候补、确认是即时还是人工。你可以按轮回答,不必在第一条消息里猜齐所有规则。

当它提出“需要自动扣费”时,先问这个建议是否服务第一版目标;若不是,就明确放回范围外。收尾验收可写为:“客人看到剩余名额,提交后店员能查到同一条记录;满员时不能继续确认。”这些只是待讨论的示例条件,并非 Skill 已替你实现的页面。如果追问开始围绕配色和技术栈,却仍没定名额与确认责任,就让它回到影响成败的决定。

你的首次任务进行得怎么样?

选择项通过网站统计帮助我们了解常见卡点。屏蔽统计可能导致无法送达;具体问题请通过邮件反馈。

参考来源

  1. 作者指南:什么时候使用 grill-meMatt Pocock
  2. grilling:分轮追问规则Matt Pocock
  3. Matt Pocock Skills 安装说明Matt Pocock
  4. Skills CLI:安装、选择客户端与更新Vercel Labs
  5. Extend Claude with skillsAnthropic
  6. Build skills:在 Codex 中使用 SkillsOpenAI
  7. to-spec:将讨论整理成规格Matt Pocock
  8. setup-matt-pocock-skills:工程流程配置Matt Pocock
  9. 鱼皮案例:从模糊需求到本地 Skills 管理器程序员鱼皮 / @yupi996 ·
  10. 作者回应:提前说清原型还是正式产品Matt Pocock / @mattpocockuk ·
  11. Kevin Ma:有了 Mock UI,如何继续把需求问清楚Kevin Ma / @kevinma_dev_zh ·
  12. 评论里的改进:正式追问前先检查默认假设AI 辅助软件开发伍斌 / @wubin28 ·
  13. 另一种选择:说不清视觉感受时先做原型宝玉 / @dotey ·
  14. 已有项目中串联需求追问、确认与任务拆分Shravan ·
  15. Downloading and installing Node.js and npmnpm
  16. grill-me 官方使用说明Matt Pocock
  17. grill-with-docs 作者使用说明Matt Pocock
  18. Skills CLI 1.7.1:全局安装的实际目录Vercel Labs
  19. Skills CLI 1.7.1:列出已安装 SkillVercel Labs
发现过期或有误的信息?告诉我们

继续发现

其他值得了解的技能。