grill-me

步骤 0 — 工具包在这里吗？ 此技能会读取工具包中的文件。只需检查一次： ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING 仅当出现 KIT_MISSING 时，说明只安装了技能文件夹，这是 npx skills add 的安装方式。请明确说明这一点，告诉用户可以运行 npx ux-ui-agent-skills init 或安装插件，然后停止。不要猜测 你无法打开的文件内容。

这些关卡能发现构建错误的界面。但这个代码库没有任何机制能发现基于错误需求 正确构建的界面，而高昂的返工成本正是由此而来：四次评估运行在关卡中都得了 14/14 分，但在 /critique 中仍被判定为需要返工，每项发现都是关卡无法察觉的决策。

此命令会先花五分钟，避免这类失败。

目标：$ARGUMENTS（即将构建的内容；如果不清楚，这本身就是第一个问题）。

1. 先读，再问

询问代码库中已经有答案的问题，只会制造噪声，也会让用户觉得回答你是在浪费时间。在提出 任何问题之前：

• 查找现有的需求说明、CLAUDE.md、BRIEF.md 或 reference/ 文件夹。
• 查找现有主题：${CLAUDE_SKILL_DIR}/../../../tokens/*.json、design-tokens.json、theme.css。 如果存在主题，那么主题问题已有答案——不要再问。
• 查看相邻的界面和组件。框架、惯例和 组件清单通常都能直接看到，并非未知。

完成这一步后保留的每个问题，都应该是代码确实无法回答的问题。

2. 问题库——按关卡无法察觉的内容分组

从以下问题中挑选，不要全部提问。

用途与重点

• 这是为谁设计的？他们来这里要完成的唯一任务是什么？
• 用户第一眼应该看到什么？（四张同等大小的卡片意味着 “什么都没有”，这是布局问题，而不是设计问题。）
• 对他们来说，怎样才算成功——离开时他们完成了什么？

内容实际情况

• 没有项目时是什么样？只有一个时呢？有四百个时呢？
• 真实用户会在这里输入的最长字符串是什么——60 个字符的 项目名称、九位数金额，还是没有空格可供换行的电子邮件地址？
• 哪些数字是真实的，哪些是占位内容？将占位内容作为真实内容发布， 就是在说谎，用户一眼就能看出来。

不可逆操作

• 哪些操作会造成破坏或无法撤销？如何确认？ （破坏性操作在每个出现的位置都应使用危险样式——触发操作 和确认对话框都要如此。蓝色的 Delete 一律不合格。）
• 操作失败时会发生什么？用户会看到什么，又能采取什么下一步操作？

主题与平台

• 使用新主题还是现有主题？如果是新的：采用什么方向？是否也会发布深色模式？
• 必须适配的最窄屏幕宽度是多少？（工具包的下限是 280px。）
• 最终交付使用哪个框架？是否需要支持 RTL、AA 或 AAA？

范围与完成标准

• 确切有多少个界面或组件？哪些内容明确不在范围内？
• 完成之前必须满足什么条件：需要通过哪些关卡？/critique 是否属于验收标准？

3. 提问规则

• 最多提七个问题，一轮问完。 一次只问一个问题、逐步提问， 比做出错误假设更糟。
• 每个问题都必须影响工作。 如果两种回答会产生相同的构建结果，那就不是问题，而是默认值——直接采用并说明。
• 不要询问你能做出合理决定的事。 判断品味是你的工作。询问意图、 内容和限制条件；其余由你决定。

4. 所有未询问的内容都要写成假设

不说出来的假设和猜测没有区别。每条假设都要写明一行：假设了什么、 采用了什么默认值，以及假设错误会带来什么代价。

Assumption: no dark mode requested -> shipping both anyway (the theme is already
dual, so the cost of including it is zero and the cost of retrofitting is not).

5. 输出：一份可供日后核查的简报

在作品旁边创建 BRIEF.md，格式如下：

# <what is being built>

Goal            one sentence, from the user's side
User and task   who, and the task they came to finish
Deliverables    exact list; N screens means N screens
Lead            the one thing the eye lands on first
Content reality empty / one / many, longest string, real vs placeholder
Irreversible    which actions, what confirms them, what failure reads like
Theme           source of truth, dark mode, brand direction
Platform floor  narrowest width, framework, RTL, AA or AAA
Out of scope    what this is deliberately not
Assumptions     each with its default and its cost if wrong
Done when       the gates that must pass, and whether /critique is part of the bar

/critique 和之后的评审者会据此对作品提出质疑。只存在于对话中的简报无法核查，也就失去了意义。

6. 然后构建，再验证

/grill-me -> 构建 -> /gate -> /critique。此命令可以消除歧义，但无法提升质量，也不会为任何内容打分，更不能替代渲染作品并亲自查看。