PRD Document Management

🆕 Natural Language Requirement Template Support

1. Requirement Template File: Provide

   requirement_template.md

   file to describe project requirements in natural language
2. Intelligent Extraction: AI automatically extracts structured information from natural language
3. Four Modes:
   • Use XMind File: Generate PRD by reading xmind file via XMind MCP (Recommended)
   • Use Requirement Template: Generate complete PRD based on requirement template file (Completed in 1 round)
   • Hybrid Mode: Requirement template + interactive supplement for missing chapters
   • Manual Creation: Collect information step by step using interactive process

Directory Structure

prd-suite/
├── SKILL.md          # Main Entry
├── commands/         # Subcommands
│   ├── create.md     # Create PRD Command
│   ├── update.md     # Update PRD Command
│   └── delete.md     # Delete PRD Command
├── templates/        # Template Files
│   ├── main_prd_template.md    # Main PRD Template
│   ├── module_prd_template.md  # Module PRD Template
│   └── requirement_template.md # Requirement Template
├── config/           # Configuration Files
│   └── config.json   # Configuration Information
└── scripts/          # Auxiliary Scripts
    ├── parser.js     # Natural Language Parsing Script
    └── utils.js      # Utility Functions

Subcommands

create

• Function: Create new PRD documents
• Subcommands:

  • create main

    - Create main PRD document

  • create module

    - Create module PRD document
• Description: Supports quick generation with natural language requirement templates, intelligent inference reduces duplicate input
• Path:

  commands/create.md

update

• Function: Update existing PRD documents
• Subcommands:

  • update main

    - Update main PRD document

  • update module

    - Update module PRD document
• Description: Supports single chapter update, version management and change records
• Path:

  commands/update.md

delete

• Function: Delete PRD documents
• Subcommands:

  • delete module

    - Delete module PRD document
• Description: Safely delete module PRD, automatically update index and change log
• Path:

  commands/delete.md

Configuration Files

config/config.json

• Basic skill information
• Subcommand configuration
• Template file paths
• Variable definitions
• Feature switches

Template Files

templates/

• main_prd_template.md

  - Main PRD Document Template

• module_prd_template.md

  - Module PRD Document Template

• requirement_template.md

  - Natural Language Requirement Template

• changelog_format.md

  - CHANGELOG Format Specification

Auxiliary Scripts

scripts/

• parser.js

  - Natural Language Requirement Parsing Script

• utils.js

  - Utility Functions (date processing, file operations, etc.)

📋 Template Format Requirements

⚠️ Important Note

Template Files

templates/

1. Main PRD Template:

   templates/main_prd_template.md

   • Used to create main PRD documents
   • Contains 9 standard chapters
   • Must maintain chapter order, table format, Mermaid chart format
2. Module PRD Template:

   templates/module_prd_template.md

   • Used to create module PRD documents
   • Contains 11 standard chapters
   • Must maintain chapter order, table format, Mermaid chart format

Format Requirements

1. Strictly follow template structure
   • Maintain order and numbering of all chapters
   • Do not miss any required chapters
   • Do not add chapters not defined in the template
2. Maintain format consistency
   • Table format must match the template
   • Mermaid chart syntax must be correct
   • Title hierarchy must be correct
3. Complete variable replacement
   • All

     {{Variable Name}}

     must be replaced with actual content
   • Do not retain any unreplaced variable placeholders
4. Format Verification
   • Must check if format complies with template after generation
   • Must correct any format issues immediately

Format Specification Description

Core Features

1. Natural Language Requirement Template

• Supports describing project requirements in natural language
• AI automatically extracts structured information
• Complete PRD generation in 1 round

2. Intelligent Inference Mechanism

• Automatically extract relevant information from main PRD
• Reduce duplicate input for users
• Improve creation efficiency

3. Quick Mode

• Only generate core chapters
• Skip optional chapters
• Suitable for secondary modules

4. Version Management

• Supports semantic versioning
• Automatically records change logs
• Version upgrade process

🗺️ XMind File Support

Function Description

1. XMind MCP Integration: Read and parse xmind files via XMind MCP service
2. Intelligent Content Extraction: Extract information required for PRD from mind map structure
3. Intermediate Document Generation: Generate

   xmind_content.md

   content document for confirmation
4. Template Format Output: Generate final document according to main PRD template format

Usage Conditions

• XMind MCP service must be available

Supported XMind MCP Tools

• mcp_XMind_list_xmind_directory

  : Scan xmind files in directory

• mcp_XMind_read_xmind

  : Read and parse xmind files

• mcp_XMind_extract_node

  : Extract specific nodes

• mcp_XMind_search_nodes

  : Search node content

Process Description

Workflow

Create Main PRD Process

1. Mode Selection: Let user select creation mode first
   • Use XMind File: Generate PRD by reading xmind file via XMind MCP (Recommended)
   • Use Requirement Template: Generate PRD based on requirement template file
   • Hybrid Mode: Requirement template + interactive supplement
   • Manual Creation: Use interactive process
2. Condition Verification: Verify preconditions according to selected mode
   • XMind Mode: Verify if XMind MCP service is available
   • Requirement Template Mode: Check if requirement_template.md exists in project directory
   • Hybrid Mode: Check if requirement_template.md exists in project directory
   • Manual Creation: No verification required, start directly
3. Information Collection: Collect necessary information according to mode
4. Generate Document: Generate complete PRD document content (⚠️ Do not create file)
5. Display Content: Display complete content for user to view
6. Pause for Review: ⚠️ Must pause and wait for user review confirmation
7. Review Confirmation: User reviews generated content
8. Complete Creation: Create PRD file and update relevant indexes after approval

Create Module PRD Process

1. Precondition: Check if main PRD exists
2. Select Module: Select module to create from main PRD module list
3. Mode Selection:
   • Quick Mode: Automatically generate complete content based on main PRD and module information, then review and confirm
   • Q&A Mode: Ask core business information chapter by chapter, provide reference information, generate chapter content, chapter review, until completion
4. Content Generation: Generate module PRD content according to selected mode
5. Review Confirmation: User reviews generated content
6. Complete Creation: Create module PRD file and update relevant indexes

Update PRD Process

1. Select Document: Select PRD to update
2. Select Chapter: Select chapter to update
3. Information Collection: Collect update information
4. Generate Content: Generate updated chapter content (⚠️ Do not update file)
5. Display Content: Display updated content for user to view
6. Pause for Review: ⚠️ Must pause and wait for user review confirmation
7. Review Confirmation: User reviews generated content
8. Version Management: Handle version upgrade
9. Complete Update: Update PRD file and relevant records after approval

Delete PRD Process

1. Select Module: Select module PRD to delete
2. Safety Confirmation: Confirm deletion operation
3. Delete File: Delete module PRD file
4. Update Index: Update PRD_INDEX.md
5. Update Change Log: Record deletion operation
6. Confirm Completion: Confirm deletion completion to user

📝 CHANGELOG Record Specification

Core Principles

• CHANGELOG records changes by date
• Each change record is associated with specific PRD file and its version
• PRD files have their own version numbers (e.g. v1.0, v1.1)

Record Format

## 2024-01-15

### 📄 e-commerce-platform_main_prd.md (v1.0 → v1.1)

**Change Overview**: Adjust functional requirements of user management module

#### Chapter 3 Functional Module List

| Item | Before Change | After Change | Reason for Change |
|--------|--------|--------|----------|
| User Login Method | Only supports account password login | Add WeChat, Alipay third-party login | Users feedback single login method |

Detailed Specification

⚠️ Review Confirmation Mechanism

Review Process

1. Generate Content: AI generates PRD content (⚠️ Do not create or update file)
2. Display Content: Display complete content for user to view
3. Pause for Review: ⚠️ Must pause and wait for user review
4. User Selection:
   • ✅ Approve: Continue with subsequent operations
   • ✏️ Propose Modifications: User inputs specific modification suggestions, AI modifies content and displays for review again
   • 🔄 Regenerate: User is unsatisfied with overall content, AI regenerates content and displays for review again
   • ❌ Cancel Operation: Terminate process, do not create or update any files
5. Execute Subsequent Steps: Perform subsequent operations (create file, update index, etc.) only after approval

Important Principles

• Review Before Execution: Do not create or update files before approval
• Must Pause for Waiting: AI cannot automatically skip review steps
• Support Iterative Modifications: Users can propose modification suggestions multiple times
• Provide Complete Options: Must provide four options: approve, modify, regenerate, cancel

Review Option Description

1. ✅ Approve
   • User confirms content is correct
   • Continue with subsequent operations (create file, update index, etc.)
2. ✏️ Propose Modifications
   • User inputs specific modification suggestions
   • AI modifies content according to suggestions
   • Display modified content again for new round of review
3. 🔄 Regenerate
   • User is unsatisfied with overall content
   • AI regenerates content
   • Display regenerated content again for review
4. ❌ Cancel Operation
   • User cancels current operation
   • Do not create or update any files
   • Terminate process

Usage Methods

Create Main PRD

1. Call

   prd-suite

   skill
2. Select

   create main

   command
3. Select creation mode (XMind File, Requirement Template, Hybrid Mode, Manual Creation)
4. Verify conditions and collect information according to mode
5. Review generated content
6. Complete creation

Create Module PRD

1. Ensure main PRD exists
2. Call

   prd-suite

   skill
3. Select

   create module

   command
4. Select complete mode or quick mode
5. Review generated content
6. Complete creation

Update PRD

1. Call

   prd-suite

   skill
2. Select

   update

   command
3. Select PRD and chapter to update
4. Provide update information
5. Review generated content
6. Handle version management
7. Complete update

Delete Module PRD

1. Call

   prd-suite

   skill
2. Select

   delete module

   command
3. Select module to delete
4. Confirm deletion
5. Complete deletion

Notes

• Supports quick generation with natural language requirement templates
• Maintain backward compatibility
• All changes are recorded in CHANGELOG.md
• Module PRD is automatically updated to PRD_INDEX.md
• Supports version management and status management