From agent-toolkit
当用户提出一个想法或诉求时,先用本 skill——通过对话挖出真实意图、打磨成边界清晰、明确"做什么 / 不做什么"的概念,确保后续产出与执行不偏离。只收敛概念边界,不产出技术方案、不拆任务。
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-toolkit:refine-ideaThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
把用户一个**还没想透的想法 / 期望**,通过协作对话打磨成一个**边界清晰的可执行概念**。你要锁定四件事:
把用户一个还没想透的想法 / 期望,通过协作对话打磨成一个边界清晰的可执行概念。你要锁定四件事:
刻意止步于此:不碰技术选型、不画架构、不拆任务、不给开发路线——那些是下游 spec / plan 的职责。你的产出是一个"想清楚了边界、可以放心往下走"的概念,而不是一份实现方案。
一句话:把"我想要个 X"打磨成"我们要解决 Y,为此做 A、B,明确不做 C、D,做成了的标志是 Z"。
用户说出来的需求,和他真正想要的,往往是两回事。"我要个 dashboard"也许真实痛点只是"我连一份实验清单都没有"。发现这种偏差最便宜的时机,是在任何 spec、代码、脚手架存在之前——一旦开始构建,切换成本会让人把错的东西合理化成"凑合能用"。本 skill 就站在这个最便宜的位置上。
适用:
不适用(遇到这些不要硬套本 skill):
⚠️ 加载约束(硬性):本 skill 需要一个能实时响应的活人在对话另一头。禁止在 CI、定时任务、自治循环等非交互场景中调用。在那种场景里遇到模糊需求,正确做法是把它标记为 blocker 并停下,而不是替用户臆测意图往下跑。
这是本 skill 的核心。每次开口提问前,先问自己:此刻的不确定性在哪一层?
时序:先用几个 Q+GUESS 把"要解决什么"钉死;问题清晰后,再切换到选择题去探索方向和边界。判断"该不该从 Q+GUESS 切到选择题"的依据,就是这条机制本身——不是流程走到第几步,而是不确定性降到了哪一层。
一次一问、每问附猜测,把下面这些挖清楚:
警惕 "want vs. should-want":当回答听起来像"一个深思熟虑、政治正确的答案"(scalable、clean architecture、业界标准做法),那可能是"他觉得应该想要的",不是"他真正想要的"。杀手锏问题:
"如果你不需要向任何人证明这个决定的合理性,你真正想要的是什么?"
出口判据:当你能预测用户对接下来三个问题的反应时,说明问题层基本钉死了,进入阶段 2。
问题清楚了,提问机制切换到选择题。
机制随不确定性走,不机械推进:如果在阶段 2 又冒出问题层的不确定性(例如某个选项暴露出"原来他要解决的根本不是之前以为的那个问题"),立刻退回 Q+GUESS把这层重新钉死,而不是硬着头皮继续甩选择题。判据始终是"当前不确定性在哪一层",不是"流程走到第几步"。
用用户自己的语言复述这个概念,六行:
哪些回答不算 "yes"(拿到这些不要当作确认):
必须拿到显式确认,才算通过这道门。
docs/proposal/<名字>.md(用户可指定别的位置;目录不存在先跟用户确认)。概念单绝不含技术选型、架构、任务拆解。一个模糊想法,怎样一路走到显式确认。注意提问机制如何随不确定性层级切换。
用户:我想做个 dashboard,把我们团队的实验都展示出来。
阶段 0 · 亮假设
我目前的理解是:你想要一个能集中看到所有实验状态的可视化界面(置信度约 55%)。但我不太确定真正的痛点是"看不到全貌"还是"信息散落各处难追踪"——这点会决定要做的东西完全不同。
阶段 1 · 挖意图(Q+GUESS,一次一问)
Q:现在没有 dashboard 的时候,你是怎么了解某个实验进展的? GUESS:我猜你得挨个去问负责人、或翻好几个文档,很费劲——所以与其说要"图表",不如说要"一个不用追着人问的单一信息源"。(置信度 60%,可能猜偏)
用户:对,主要是没有一个统一的清单,经常不知道有哪些实验在跑、谁负责。
〔问题层钉死了:真实痛点是"缺一份权威的实验清单",不是"缺可视化"。能预测他对后续问题的反应,进入阶段 2。〕
阶段 2 · 照亮边界(选择题)
既然核心是"一份权威清单",先划清边界——这些你要哪些、不要哪些? A. 只读展示:列出实验、状态、负责人(最小可用) B. A + 可在界面里直接改状态 / 加实验 C. A + 自动从 CI / 实验平台同步状态 另外想确认:精美图表(趋势、对比)这一版先不做,对吗?
用户:选 A 就够了;图表确实先不要,能有个准确的清单我就满足了。
阶段 3 · 复述 + 严格确认(六行)
- 要解决什么:团队没有权威的实验清单,状态散落、靠口头追踪
- 给谁:团队成员,尤其需要快速了解"有哪些实验在跑"的人
- 为什么是现在:实验变多,口头追踪开始出错、漏掉
- 成功长什么样:打开就能看到全部实验 + 状态 + 负责人,不必再挨个问
- 硬约束:先做只读展示,数据手工录入即可
- 明确不做什么:不做趋势 / 对比图表、不做界面内编辑、不做 CI 自动同步
这样准确吗?确认的话我们就把这个概念定下来。
用户:准确,就按这个来。
〔拿到显式确认,过门。本 skill 到此为止——交还概念,不自动写 spec / 不开始建表。〕
❌ 用户说"做个 dashboard",直接接住开始定 dashboard 的功能 —— 没挖他真正的痛点。 ❌ 一口气抛出五个问题,把用户淹了。 ❌ 问题层还没搞清(连他要解决什么都没把握),就开始甩选择题让他在方案间选 —— 用错了机制。 ❌ 生成 10 个概念变体让用户挑 —— 发散过度,且滑向"选方向"。 ❌ 把"用 SQLite 存储 / React 前端"写进概念 —— 越界到技术实现层。 ❌ 用户回一句"你看着办",就当作确认通过。 ❌ 复述时把"不做什么"留空,或干脆不复述就开干。 ❌ 概念还没确认,就开始拆任务 / 写 spec / 敲代码。 ❌ 在 CI、定时任务、自治循环里调用本 skill,遇到模糊需求自己脑补意图往下跑。
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub rollrollroll/agent-toolkit --plugin agent-toolkit