grill-for-unknowns

grill-for-unknowns 快速入门

在 Agent 写代码之前，先让它”拷问”你的计划——发现未知、暴露盲区、达成共识，防止盲目执行后返工

⭐ 评分: 8.2/10 💰 价格: 开源免费 🏢 厂商: nicobailon 🌐 官网: GitHub

一、这是什么

grill-for-unknowns 是一个 Agent Skill，它的作用是在 Agent 开始写代码之前，先对计划进行严格的”拷问”——发现你没有想到的未知因素，暴露知识盲区，确保人和 Agent 对目标和约束的理解一致。

很多时候，Agent 会盲目地按照你的指令开始编码，但你可能遗漏了关键信息，或者 Agent 对你的需求有误解。结果就是：Agent 写了一大堆代码，最后发现方向错了，需要返工。grill-for-unknowns 通过在编码前增加一个”拷问”环节来解决这个问题。

适合人群：使用 Claude Code/Codex 进行复杂项目开发的开发者，特别是需求不明确或跨团队协作的场景。

二、快速上手

准备工作

• Claude Code 或 Codex 环境
• 一个需要”拷问”的项目计划或需求

安装

将 Skill 文件放入你的 Agent 技能目录：

# Claude Code
cp grill-for-unknowns.md ~/.claude/skills/

# Codex
cp grill-for-unknowns.md ~/.codex/skills/

三步使用

Step 1: 激活 Skill

在 Agent 对话中启用 Skill：

/skill grill-for-unknowns

Step 2: 提交你的计划

向 Agent 描述你的计划，然后让 Skill 开始”拷问”：

我计划用 React + FastAPI 构建一个用户管理系统。请 grill 这个计划。

Step 3: 审视拷问结果

Agent 会输出一系列问题和未知因素，例如：

• “用户认证方案是什么？JWT 还是 Session？”
• “数据库选型确定了吗？PostgreSQL 还是 MongoDB？”
• “权限模型是 RBAC 还是 ABAC？”
• “前端需要 SSR 吗？还是纯 SPA？”

回答这些问题后，再让 Agent 开始编码。

三、核心功能

• 发现未知：识别计划中未明确的关键决策点
• 拷问计划：对 Agent 方案进行系统性审查
• 共识达成：确保人机对目标理解一致
• 即装即用：单个 Markdown 文件，直接放入 Skill 目录
• 多平台：Claude Code / Codex 通用

四、常见踩坑

1. 不要跳过拷问环节——即使你觉得需求很明确，Agent 可能发现你忽略的边界情况
2. 拷问结果需要你认真回答——如果随便应付，Skill 的效果会大打折扣
3. 复杂项目可能需要多轮拷问——第一轮暴露大方向问题，第二轮细化技术细节
4. Skill 本身不写代码——它只负责”拷问”，拷问完后你还需要切换回正常的编码模式

五、常见问题 FAQ

Q1: 和 spec-driven development 有什么区别？

A: spec-driven development 要求你在编码前写好完整的规格说明。grill-for-unknowns 更轻量——它不需要你写完整的 spec，而是通过对话式拷问来发现和填补未知。适合那些”大概知道要做什么但细节还没想清楚”的场景。

Q2: 每次编码前都要用吗？

A: 不需要。简单任务（如”加一个按钮”）可以直接编码。推荐在以下场景使用：新功能开发、跨模块重构、涉及多个外部依赖的任务、需求不够明确的场景。

Q3: 这个 Skill 支持哪些 Agent？

A: 任何支持 Markdown Skill 格式的 Agent 都可以使用，包括 Claude Code、Codex、Cursor 等。

Q4: 可以自定义拷问的维度吗？

A: 可以。Skill 文件是纯 Markdown，你可以修改其中的拷问维度来适配你的项目类型（如前端项目、后端项目、数据工程等）。

Q5: 和 plan-and-execute 模式有什么区别？

A: plan-and-execute 是 Agent 自己制定计划然后执行。grill-for-unknowns 是 Agent 和人类之间的”对齐”环节——它确保在 Agent 制定计划之前，人类已经想清楚了关键决策点。

参考链接

• GitHub 仓库

最后更新：2026-07-11 · 作者：MagicNetWorld