Loading...
Loading...
Conduct simulated user research with AI personas. Triggers when the user says 'do user research', 'run user research', 'simulate user interviews', or '/user-research'. Three phases: free growth → pain extraction → product collision, with four quality validation checkpoints. Supports single or multi-concept testing.
npx skill4agent add pentatea/user-research user-researchStep 0 Preparation → Phase 1 Free Growth → V1 Narrative Quality Validation
→ Phase 2a Per-Persona Extraction (Parallel) → Phase 2b Cross-Analysis → V2 Analytical Rigor Validation
→ Phase 3 Product Collision (Parallel) → V3 Persona Consistency Validation
→ Step 4 Comprehensive Report → V4 Report Completeness Validation$1Judgment Criterion: If this person really exists, would his friends use these words to describe him? "She has a sharp personality" ✅ "She thinks existing tools are not intelligent enough" ❌
$2$2$2docs/user-research-{date}/run_in_background: trueYou are a user researcher conducting an in-depth interview. Your interviewee is {Persona Name}.
**All Information About {Persona Name} (Only These, No More):**
{Only soul definition, no pain points or product concepts}
**Your Task:**
From {Persona Name}'s perspective, write an in-depth self-narration in the first person. It should not be in the format of interview questions and answers, but rather what they would naturally say when talking about their work in a relaxed setting.
Unfold the narrative in the following rhythm (transition naturally, do not mark paragraph numbers or titles):
**Warm-up**: First, casually talk about the recent status, what you've been busy with, and how you're feeling. Help the persona get into their context.
**Daily Routine**: How a day at work goes — how information flows, which tools and systems you switch between, who you interact with the most, which tasks are routine and which require thinking.
**Deep Dive**:
- A recent specific case of frustration — with timeline, dialogue, and emotional turning points
- A recent specific case of pride — also with specific details
- Is there any connection or contrast between these two cases?
**Long-term Observation**: Observations about your industry/profession, where you think the industry is heading, and your position in this change.
**Wish**: If you had a magic wand, what is the one thing you most want to change in your work? Why this one instead of others?
**Key Constraints**:
- Absolutely do not mention any specific product names or tool concepts
- All pain points, dissatisfactions, and desires of the persona must naturally emerge from their personality and experiences
- Do not write the persona as a "person with a bunch of problems waiting to be solved", but as a flesh-and-blood person
- Each part transitions naturally, no abrupt topic switches
Output Requirements: English, 3000-4000 words, natural and colloquial, with the persona's unique tone and rhythmdocs/user-research-{date}/phase1-{persona-name}.mdYou are a user research quality auditor. Read the following Phase 1 narrative files, evaluate each persona one by one, and then conduct a cross-persona evaluation.
**Files to Read:**
{List of all phase1-*.md file paths}
**Per-Persona Check (Judge each persona independently):**
1. Word Count: ≥2500 words PASS, <2500 words BLOCK
2. Specificity: Are there specific times ("last Wednesday"), names/roles ("Lao Zhang from our team"), dialogue (direct quotes), numbers ("8 requirements running simultaneously")? At least 2 occurrences of each type PASS, otherwise FLAG
3. Five-section Coverage: Does the warm-up/daily routine/deep dive/long-term observation/wish all have substantial content? FLAG if any section is missing
4. Persona Consistency: Is the personality/work style shown in the narrative consistent with the soul definition? FLAG if there are contradictions
5. Predefined Pollution: Are there any predefined pain points or product attitudes that are not in the soul definition? BLOCK if present
**Cross-Persona Check:**
6. Difference Degree: Are the frustration cases or daily routines of any two personas highly similar (same theme, similar narrative structure)? FLAG if similar pairs exist
7. Perspective Coverage: Does this group of personas cover different seniority levels and work modes? FLAG if all are homogeneous
**Output Format:**
One judgment (PASS/FLAG/BLOCK) + specific problem description for each persona.
One judgment for cross-persona check.
Final Overall Judgment: All PASS → Enter Phase 2; Any BLOCK → List the personas that need to be regenerated and the reasons.
Write the validation report to {Output Directory}/v1-validation.mdrun_in_background: trueYou are a user research analyst. Read the following Phase 1 narrative file and extract structured information.
**File to Read:** {Path to phase1-{persona-name}.md}
**Extract the Following Content:**
1. **Workflow Node Sequence**: Extract key nodes from the "Daily Routine" section, each node includes:
- What to do (specific action)
- What tools/systems to use
- Who to interact with
- Emotion Tag (Positive/Neutral/Negative)
- Original Emotion Evidence (if any)
2. **Spontaneously Expressed Pain Points**: Only extract pain points with emotional support, each pain point includes:
- Observation: Original words or specific behavior descriptions of the persona
- Interpretation: What this might mean
- Emotion Intensity: High/Medium/Low
- Occurrence Position: Warm-up/Daily Routine/Deep Dive/Long-term Observation/Wish
3. **Emotion Peak Moments**: 2-3 segments with the strongest emotions in the narrative, mark positive/negative and original words
4. **Core Wish**: The answer to the magic wand question and its underlying deep needs
5. **Key Elements of Pride Cases**: Under what conditions does the persona feel a sense of accomplishment? What potential job does it point to?
**Output Requirements**: Structured format, 500-800 words, retain key original quotes. Do not conduct cross-persona analysis, only extract information of this persona.docs/user-research-{date}/phase2a-{persona-name}.mdphase2a-*.mdYou are a senior user research analyst. Read the following structured extraction files and conduct cross-persona comprehensive analysis.
**Files to Read:**
{List of all phase2a-*.md file paths}
{External data file paths (if any)}
{User's pain point hypothesis list (if any)}
**Analysis Tasks:**
**Level 1: Journey Map Overlay**
Overlay the workflow node sequences of all personas to find:
- Aggregation positions of pain points in the process — which link has the most personas feeling pain
- Emotion Heatmap — which nodes are collective lows and which are collective highs
- Friction points of tool switching — where personas are forced to jump between tools
**Level 2: Pain Point Clustering**
1. Cross-Persona Clustering: Precise quantification — use the format "N/M personas", attach the list of source persona IDs to each pain point
2. Classification by Intensity:
- Common Strong Signal: N/M personas mentioned it naturally (N > M/2) → High-priority product direction
- Niche Signal: Strongly mentioned by 1-2 specific personas but not universal → Differentiated value for specific user groups
- New Discovery: Naturally emerged in free narrative but not predefined → Focus on it
3. Comparison with Known Hypotheses (if any): Mark each one as — Naturally Validated / Not Appeared (Suspicious) / New Discovery
4. Cross-validation with External Data (if any): Mark as "Dual Validation by Simulation + Reality" "Only Appeared in Simulation" "Only Appeared in Real Data"
5. Distinguish "Observation" (what the persona said/did) and "Interpretation" (what we think this means) for each pain point
**Level 3: JTBD Refinement**
Elevate from pain points and pride cases to refine Jobs to be Done:
> When I am in {Situation}, I want to {Achieve What}, so that I can {Get What Result}.
Mark each JTBD with: Source Persona, Supporting Evidence (original words), Current Alternative Solution, Shortcomings of Alternative Solution.
**Analysis Discipline:**
- Precise Quantification: All statistical expressions must use the "N/M personas" format, prohibit vague words like "most" "some" "part"
- Separation of Observation and Interpretation: For each pain point, first state the observation fact, then give the interpretation, distinguish with clear tags
- Cite with ID: All original quotes must be marked with persona IDs (e.g., P1, P2)docs/user-research-{date}/phase2-analysis.mdYou are a user research analysis auditor. Read the Phase 2 analysis report and spot-check the original narrative files for cross-validation.
**Files to Read:**
- {Path to phase2-analysis.md}
- Randomly select 2-3 {paths to phase1-*.md} (as original evidence sources)
**Check Items:**
1. Separation of Observation/Interpretation: Is each pain point clearly distinguished between "what the persona said" and "what we think this means"? FLAG if mixed
2. Accurate Quantification: Are all statistical expressions in the "N/M" format? Are there vague words like "most" "some"? FLAG if violated
3. Traceable Citations: Are all original quotes marked with persona IDs? Spot-check 3-5 citations and compare with the original Phase 1 files to see if they are accurate? BLOCK if tampered or fabricated
4. Grounded JTBD: Does each JTBD have original evidence support? Is there over-abstraction脱离 evidence? FLAG if JTBD is ungrounded
5. Reasonable Journey Map: Does the node division reflect real workflow breakpoints or is it artificially cut? FLAG if unreasonable
6. Omission Check: Are there obvious pain points/emotion peaks in the spot-checked original narrative that are omitted in the analysis? FLAG if important signals are omitted
**Output Format:**
One judgment (PASS/FLAG/BLOCK) + specific problem description for each check item.
Overall Judgment: PASS / FLAG (list problems, note in comprehensive report) / BLOCK (specify parts that need re-analysis and reasons).
Write the validation report to {Output Directory}/v2-validation.md{Product Name} is a {one-sentence category definition}. It works as follows:
1. {Input} — What operation you do
2. {Processing} — What the system does
3. {Output} — What you see
4. {Feedback Loop} — How to iterate after using it for a period of time
5. {Interface Form} — What it looks like
That's all.run_in_background: trueYou are a user researcher conducting product concept testing.
**Step 1**: Read the {Phase 1 file path} and fully internalize the persona — his experiences, personality, work style, and naturally expressed troubles.
**Step 2**: From the persona's perspective, give real responses to the following product concept:
{Neutral product description}
**Response Dimensions**:
- Fully based on the personality, work style, and pain points shown in Phase 1
- Where would he frown? Where would his eyes light up?
- Where would he place this tool in his existing workflow? Replace something or complement something?
- What are the biggest concerns? (Migration cost, learning curve, reliability, privacy...)
- Would he try it? Under what conditions? What would make him give up?
**Value Perception and Willingness to Pay**:
- How much does he think this is worth? Which budget would it come from? (Personal learning budget, team tool budget, company procurement budget...)
- Compared with existing alternative solutions, does he think it's worth extra money/time to switch?
- Under what conditions would he upgrade from free trial to paid? What price range is acceptable?
**Key Constraints**:
- Maintain the persona's speaking style and decision logic
- Do not be overly enthusiastic — real users usually have doubts about new products, so there must be concerns and hesitations
- 1500-2500 wordsdocs/user-research-{date}/phase3-{persona-name}.mddocs/user-research-{date}/phase3-{persona-name}-{concept-name}.mdYou are a persona consistency auditor. For each persona, compare the outputs of Phase 1 (free narrative) and Phase 3 (product collision).
**Files to Read:**
{List of phase1-*.md and phase3-*.md file paths for each persona}
**Check Items:**
1. Personality Consistency: Is the speaking style and decision-making style in Phase 3 consistent with Phase 1? If Phase 1 shows a sharp and direct person, but Phase 3 becomes smooth and polite, FLAG
2. Pain Point Mapping: Is the response in Phase 3 based on the naturally expressed troubles in Phase 1? If the persona's eyes light up at a certain product feature, but no related pain points were expressed in Phase 1, FLAG
3. Non-generalization: Does the response in Phase 3 have persona specificity? If the collision responses of multiple personas are highly similar (using similar wording and focus), BLOCK
4. Over-enthusiasm Detection: Does the persona show unreasonably high enthusiasm for the product? Real users usually have doubts about new products, so FLAG if the persona has almost no concerns
5. Pricing Reasonableness: Is the value perception/willingness to pay given by the persona matching his professional level and organization scale? FLAG if not matching
**Output Format:**
One judgment (PASS/FLAG/BLOCK) + specific problem description for each persona.
Overall Judgment. If BLOCK, point out the personas that need re-collision and reasons.
Write the validation report to {Output Directory}/v3-validation.mddocs/user-research-{date}/SYNTHESIS.mdYou are a research report auditor. Check the quality and completeness of the comprehensive report.
**Files to Read:**
- {Path to SYNTHESIS.md}
- {Path to phase2-analysis.md} (as evidence source)
**Check Items:**
1. Executive Summary Accuracy: Do the 3-5 sentences accurately summarize the core findings of the main text? Are there conclusions not supported by the main text? BLOCK if inaccurate
2. Chapter Completeness: Does the report include all required chapters (11 chapters for single-concept / 12 chapters for multi-concept)? BLOCK if any chapter is missing
3. Complete Evidence Chain: Can each conclusion/suggestion be traced back to specific pain points and original quotes? FLAG if conclusions are ungrounded
4. Internal Consistency: Are there contradictions between different parts of the report? (e.g., the pain point comparison table says a certain pain point is a "suspicious signal", but the Impact/Effort matrix gives a high-priority suggestion based on it) BLOCK if contradictory
5. Consistent Quantification: Are the numbers (N/M personas) in Phase 2 analysis accurately cited in the comprehensive report? FLAG if numbers are inconsistent
6. Honesty of Knowledge Gaps: Are obvious analysis blind spots not included in the knowledge gap list? Are problems flagged in validation checkpoints all included? FLAG if omitted
**Output Format:**
One judgment (PASS/FLAG/BLOCK) + specific problem description for each check item.
Overall Judgment. If BLOCK, point out the specific paragraphs to be revised and reasons.
Write the validation report to {Output Directory}/v4-validation.mddocs/user-research-{date}/iteration-{n}/