Requirements Analysis (Chinese Version)

requirements-analysis-en

prompts/requirements-analysis.md

When to Use

• When the user mentions "requirements analysis", "requirements analysis", or "test point identification"
• Need to extract test points from requirement documents
• Trigger Examples: "Analyze test points for this requirement", "Identify boundary conditions in the requirement"

Output Format Options

How to Use

1. Open the corresponding prompt file under the

   prompts/

   directory in this folder, and copy the content below the dashed line.
2. Attach your requirements and context (business processes, environment, constraints, acceptance criteria).
3. If non-Markdown output is required, append the request sentence from

   output-formats.md

   at the end.

Reference Files

• prompts/requirements-analysis.md — Requirements analysis prompt template
• output-formats.md — Format specifications

Code Examples

1. Requirements Analysis Template (In Progress) - Requirements analysis examples and templates

Common Pitfalls

• ❌ Only focus on surface-level functions → ✅ Conduct in-depth analysis of implicit requirements and boundary conditions
• ❌ Ignore non-functional requirements → ✅ Focus on performance, security, usability, etc.
• ❌ Miss exception scenarios → ✅ Identify all possible exception cases
• ❌ Lack of prioritization → ✅ Mark the priority of test points

Best Practices

1. Requirements Analysis Framework (5W1H)

## What (What it is)
- Function description
- Business objectives
- User value

## Who (Who uses it)
- Target users
- User roles
- Permission requirements

## When (When to use)
- Trigger conditions
- Time constraints
- Frequency requirements

## Where (Where to use)
- Usage scenarios
- Environment requirements
- Platform restrictions

## Why (Why it's needed)
- Business reasons
- Problem resolution
- Value realization

## How (How to implement)
- Implementation methods
- Technical solutions
- Interaction processes

2. Test Point Identification

• Functional test points
• UI test points
• Data test points
• Performance test points
• Security test points
• Compatibility test points

3. Boundary Condition Analysis

• Input boundaries
• Output boundaries
• Time boundaries
• Quantity boundaries
• Permission boundaries

Troubleshooting

Problem 1: Unclear Requirements

1. List out unclear points
2. Communicate with product managers
3. Record clarification results
4. Update requirement documents

Problem 2: Missing Test Points

• Normal scenarios
• Exception scenarios
• Boundary values
• Permission verification
• Data verification
• Performance requirements
• Security requirements

Target Audience

• QA and developers who perform work in this testing domain in real projects
• Test leads who need structured, reusable test deliverables
• AI users who need to quickly generate actionable test outputs

Unsuitable Scenarios

• Pure online emergency response without test scope context
• Decisions requiring legal/compliance final ruling but lacking expert review
• Requests missing minimum inputs (scope, environment, expected behavior)

Key Success Factors

• Clarify scope, environment, and acceptance criteria first before generating test content
• The generated results must be re-validated against real system constraints
• Maintain traceability of deliverables (Requirements -> Test Points -> Defects -> Decisions)

Output Templates and Parsing Scripts

• Template Directory:

  output-templates/

  • template-word.md

    (Word-friendly structure)

  • template-excel.tsv

    (Can be directly pasted into Excel)

  • template-xmind.md

    (XMind structured outline)

  • template-json.json

  • template-csv.csv

  • template-markdown.md

• Parsing Script Directory:

  scripts/

  • General parsing:

    parse_output_formats.py

  • Format-specific parsing:

    parse_word.py

    ,

    parse_excel.py

    ,

    parse_xmind.py

    ,

    parse_json.py

    ,

    parse_csv.py

    ,

    parse_markdown.py

  • General conversion:

    convert_output_formats.py

  • Format-specific conversion:

    convert_to_word.py

    ,

    convert_to_excel.py

    ,

    convert_to_xmind.py

    ,

    convert_to_json.py

    ,

    convert_to_csv.py

    ,

    convert_to_markdown.py

  • Batch conversion:

    batch_convert_templates.py

    (Batch output to

    artifacts/

    )

python3 scripts/parse_json.py output-templates/template-json.json
python3 scripts/parse_markdown.py output-templates/template-markdown.md
python3 scripts/convert_to_json.py output-templates/template-markdown.md
python3 scripts/convert_output_formats.py output-templates/template-json.json --to csv
python3 scripts/batch_convert_templates.py --skip-same