关于 grill-me
grill-me 是用于厘清计划或设计中未决事项的访谈技能。它逐次提出一个问题并给出建议及理由,沿决策分支追问,直到形成共同认可的总结。
主要功能
- 01逐次提出一个问题
- 02附带理由的建议答案
- 03梳理决策依赖关系
- 04提问前先探索代码库
- 05总结已解决的决策
适用场景
- 01厘清实施计划
- 02解决设计选择与假设
- 03追踪决策间的依赖
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ wilbeibi/ wilbeibi-skills --skill grill-me安装后在 Claude Code 中输入/grill-me确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
ADR-FORMAT.mdCONTEXT-FORMAT.mdagents/openai.yaml详细介绍
grill-me
围绕计划或设计持续采访用户,直到双方达成共识并解决所有未决事项。
如何运行
- 先阅读理解主题所需的计划、关联文档、代码或本地文件。
- 每次只问 一个 问题。等待回答后再问下一个问题。
- 对每个问题,说明 你建议的答案,并用一句话解释原因。
- 梳理决策树中的 每个分支。如果某个答案引出新问题,就继续追问;按顺序解决决策之间的依赖关系,不要跳来跳去。
- 如果可以通过 探索代码库 回答问题,就先探索,而不是提问。
- 深入追问含糊的词语、隐藏的假设、边界情况、决策之间的依赖关系,以及可逆性。
- 持续追问,直到不再有未解决的分支。然后总结达成一致的计划。
提问模式
- “怎样的结果能说明这项改动成功了?”
- “现有的哪个概念负责这种行为?”
- “能证明该设计可行的最小场景是什么?”
- “如果这个假设不成立,会有什么问题?”
- “未来的维护者可能会想改回什么?”
- “哪个术语应该作为标准术语,又应该避免使用哪些别名?”
记录决策
只有在代码库已经包含 CONTEXT.md、CONTEXT-MAP.md 或 docs/adr/,或者访谈确定了值得长期保留的术语或决策时,才记录决策。提议新建文件前,先检查这些文件是否存在。
- 术语确定后,立即更新相应的
CONTEXT.md——它是项目专用术语及其关系的词汇表,不是规范文档或草稿。 - 只有在代码库包含多个有界上下文时,才使用
CONTEXT-MAP.md。 - 只有对难以逆转、缺乏背景时令人意外,且涉及实际权衡的决策,才提供 ADR。
- 按需创建文档:在有实际确定的内容之前,不创建
CONTEXT.md或docs/adr/;文档要足够简短,让未来的 Agent 愿意阅读。
词汇表格式请阅读 CONTEXT-FORMAT.md。ADR 的格式和标准请阅读 ADR-FORMAT.md。
备注
- 不要为了“提高效率”而弱化或合并问题——价值就在于持续追问。一次一个问题,反复进行。
- 只有用户明确要求停止,或一次性接受所有剩余建议时,才提前结束。
- 移植自 mattpocock/skills(MIT),并根据本代码库的约定和风格进行了调整。
评论
支持 Markdown