# Demand Refiner

> Refine vague ideas, feature requests, and early project concepts into clear requirement outputs through guided clarification, scope definition, and structured drafting. Use when the user asks to "细化需求", "梳理需求", "做需求分析", "写需求文档", "写 PRD", "整理产品方案", "拆解功能点", "定义 MVP", "补充边界条件", "明确用户场景", "把这个想法整理成文档", "我有个想法", "我想做一个...", or provides scattered goals, notes, or rough ideas that need to become a stru…

- **Type:** Skill
- **Install:** `agentstack add skill-stellariums-demand-refiner-demand-refiner`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [stellariums](https://agentstack.voostack.com/s/stellariums)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [stellariums](https://github.com/stellariums)
- **Source:** https://github.com/stellariums/demand-refiner

## Install

```sh
agentstack add skill-stellariums-demand-refiner-demand-refiner
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Demand Refiner

Refine vague user ideas into comprehensive requirement documents through iterative guided conversations. Follow the user's input language for all interactions and output.

## Workflow

### Phase 1: Requirement Gathering

Upon receiving the user's initial description, conduct multi-round conversations to progressively refine requirements:

1. **Proactive gap discovery** - Probe dimensions the user hasn't mentioned: target users, usage scenarios, core objectives, constraints, technical preferences.
2. **Option-guided clarification** - When descriptions are vague, present concrete options rather than open-ended questions.
3. **Challenging questions** - Identify potential risks, contradictions, or unconsidered edge cases.
4. **Technical context provision** - When technical concepts arise that the user may be unfamiliar with, provide concise background knowledge to support informed decisions.
5. **Periodic summary checkpoints** - Every 2-3 rounds, summarize established content and ask the user to confirm before proceeding.

Focus each round on 1-2 dimensions. Avoid overwhelming the user with too many questions at once.

### Phase 2: Completeness Check

Before concluding, verify these dimensions are adequately covered:

- Background and objectives
- Target users and usage scenarios
- Core functional requirements
- Non-functional requirements
- Constraints and assumptions
- Dependencies

**Dual confirmation**: Present a complete requirement summary. Proceed to drafting only after user confirms no further additions or modifications.

### Phase 3: Document Generation

Draft the requirement document in the conversation first using Markdown. Save it to a project file only when the user explicitly asks to save or export it.

Before writing any file, confirm the target path or filename if the user has not already provided one. If the user only wants to review or refine the content, keep the output in chat and continue iterating there.

For the document template and section guidelines, see **[references/document-template.md](references/document-template.md)**.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [stellariums](https://github.com/stellariums)
- **Source:** [stellariums/demand-refiner](https://github.com/stellariums/demand-refiner)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-stellariums-demand-refiner-demand-refiner
- Seller: https://agentstack.voostack.com/s/stellariums
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.