refine-requirements（细化要求）

ABOUTME: Structured requirements refinement using AskUserQuestion before planning

ABOUTME: Identifies gray areas, clarifies with concrete options, captures decisions for the plan

Requirements Refinement

Invoke explicitly or triggered automatically by plan-first-workflow for 🟡/🔴 tasks.

Process

1. Identify gray areas by domain:

- Visual → layout, density, interactions, empty states - API/CLI → response format, error handling, auth flow - Infrastructure → scaling, redundancy, monitoring - Integration → protocol, auth method, error recovery

1. For each gray area, use AskUserQuestion:

- Concrete options ("JWT" not "Option A"), 2-4 choices - Include "You decide" when Claude's discretion is fine - Follow threads: each answer may reveal the next question

1. Scope guard: if user suggests new scope, capture as deferred idea, redirect back
2. Output: list of decisions to include as ## Decisions in the plan file

Anti-patterns

• Generic questions ("What are your requirements?") → ask about specific decisions
• Checklist walking → follow the thread the user cares about
• Expanding scope → clarify HOW to implement what's requested, not WHETHER to add more