intent-refine

intent-refine is a skill for Claude Code from zhu1090093659/growth. It costs 163 tokens per session (2,160 once invoked), scanned A, original, MIT.

A questioning guide for turning a vague idea into one precise, testable sentence. It asks about the real problem, users, situation and observable result.

In plain words
What is it for?
Use it before defining a product requirement, coding-agent skill, API contract, experiment or personal goal. It helps uncover the underlying problem and define what success should look like.
Why use it?
It prevents an agent from building the wrong thing quickly because the request was unclear. It also replaces vague goals such as “better” or “easier” with concrete checks.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the growth plugin — 4 skills shipped together

Good fit Use it before defining a product requirement, coding-agent skill, API contract, experiment or personal goal. It helps uncover the underlying problem and define what success should look like.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/zhu1090093659/growth/intent-refine
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add zhu1090093659/growth --skill intent-refine
Clone the repo
git clone --depth 1 https://github.com/zhu1090093659/growth

Made for: Claude Code.

Or install growth, the plugin that ships this one along with the rest of its 4 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for intent-refine

README.md
[![agentmods](https://agentmods.dev/badge/skills/zhu1090093659/growth/intent-refine/github.svg)](https://agentmods.dev/skills/zhu1090093659/growth/intent-refine)
Your own site
<a href="https://agentmods.dev/skills/zhu1090093659/growth/intent-refine"><img src="https://agentmods.dev/badge/skills/zhu1090093659/growth/intent-refine/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for intent-refine

Your own site · 80×15
<a href="https://agentmods.dev/skills/zhu1090093659/growth/intent-refine"><img src="https://agentmods.dev/badge/skills/zhu1090093659/growth/intent-refine.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 163 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,160 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00163 $0.02160
Opus 5 $0.00081 $0.01080
Sonnet 5 $0.00033 $0.00432
Haiku 4.5 $0.00016 $0.00216

Measured 11d ago against content hash 8a6f48188a88, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

intent-refine scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

platforms/gemini-cli/skills/intent-refine/SKILL.md · 203 lines

How it starts

The opening of the file, as written. The whole thing — 203 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Intent Refine — 意图精炼

AI 执行能力越强,模糊需求的代价越大。以前你说"帮我做个东西",人类同事会追问;现在 AI 会直接做出一个错的东西,而且做得很快。

本 skill 的存在不是为了帮用户需求,而是为了逼用户想清楚自己到底要什么。

核心哲学

意图的清晰度,是 AI 时代最有杠杆的能力。1 小时想清楚,省下 10 小时返工。

但人天生不擅长想清楚自己要什么——我们更擅长"被触发之后反应"。所以需要一套外部纪律来逼我们在行动之前把意图磨锋利。

三条铁律

铁律一:不帮用户写 spec

禁止

  • "我帮你把需求写一下:用户希望……"
  • "我来总结你的意图:……"

允许

  • "你能用一句话说出这件事的本质目的吗?"
  • "如果只用 20 个字描述你要的东西,你会怎么写?"

铁律二:把"想做什么"推向"为什么要做"

用户说"我想做 X",90% 的时候 X 不是真需求,而是用户以为能解决真需求的方案。

本 skill 的主要工作就是把 X 推到 Y——真正要解决的问题。这是经典的 XY Problem 排查。

铁律三:不接受模糊修辞

用户说"更好"、"更易用"、"更高效"、"更智能"时,追问:

  • "更"的基准是什么?和什么比?
  • "好/易用/高效/智能"的可观察表现是什么?具体说 3 条。
  • 如果做完了,你怎么知道真的做到了

没有可观察判据的形容词,都是逃避。


三阶段工作流

📍 Phase 1:表层意图陈述(Surface Intent)

让用户把自己现在的想法说清楚。不急着判断对错,先完整接收。

开场问题:

  • 用一句话告诉我你想做什么。
  • 不要多句,不要修饰,一句话。

用户给了一句话之后,做表层澄清(只做澄清,不做挑战):

  • 这句话里的每个关键词,具体指什么?
  • 给谁做?谁会用?用的时候在什么场景?
  • 如果做完了,什么东西会和现在不同?(可观察的变化)

如果用户一开始就说得非常清晰(极少数情况),可以直接跳 Phase 2。更多时候用户在这一阶段会发现自己第一句话就不对,这很好——这说明他开始思考了。

📍 Phase 2:意图审查(Intent Audit)

这是最核心的阶段。用四把刀系统审查用户的意图。

刀一:XY Problem 检查

  • 你想做 X。X 是为了解决什么更根本的问题 Y?
  • 如果 Y 有别的解法,不做 X 也能达到 Y,你接受吗?
  • 如果 Y 根本不是真问题呢?是不是存在一个更深的 Z?

连问三层"为什么"。用户通常在第二层会动摇,在第三层会发现真目标其实是别的。

刀二:欲望 vs 需求

  • 这件事是你想要的(desire),还是你真正需要的(need)?
  • 如果你今天不做这件事,三个月后最糟会怎么样?
  • 这件事的优先级,你凭感觉排是第几?凭理性排是第几?两者差距说明什么?

刀三:成功判据

  • 做完了以后,你用什么可观察的东西判断"成功"?
  • 这个判据能不能被一个完全不认识你的人验证?
  • 如果做出来了但你朋友说"这不算做到",你用什么回应他?

如果用户说不出可观察判据,说明意图本身是假的——是一个情绪,不是一个目标。

刀四:反例(Negative Space)

  • 这件事做什么不算做到
  • 什么样的结果你一定不接受?
  • 在满足成功判据的前提下,哪些实现方式你拒绝?为什么拒绝?

反例往往比正例更能暴露真实意图。一个说不清自己"不要什么"的人,多半也不清楚自己"要什么"。

📍 Phase 3:意图精确化(Crystallization)

经过 Phase 2,用户应该对自己真正想要什么有了更清晰的认识。现在逼他写出来。

输出格式(由用户写,Claude 不代写):

意图(一句话):_______________________________________

目的(为什么要做):___________________________________

成功判据(可观察):
  1. _______________________________________
  2. _______________________________________
  3. _______________________________________

反例(明确排除):
  - _______________________________________
  - _______________________________________

已知约束(预算/时间/技术/人):
  - _______________________________________

Read the full file on GitHub · 203 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 203 lines · 163 tokens per session scan A 8a6f48188a88

Subscribe to this mod's changes

intent-refine is a skill published in the GitHub repository zhu1090093659/growth (24 stars, last pushed 4mo ago), licensed MIT. It adds 163 tokens to every session and 2,160 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

insight-error-page

Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…

vercel/next.js · 83 tokens

next-cache-components-optimizer

Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…

vercel/next.js · 170 tokens

next-partial-prefetching-adoption

Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the partialPrefetching flag, opt routes in with export const prefetch = 'partial', audit Link prefetch={true} behavior, preserve existing prefetched UI with…

vercel/next.js · 103 tokens