generating-prd-json-from-prd-md

从 PRD.md 要求文档中生成 prd.json 任务跟踪文件。当您启动 Ralph 循环，或当用户要求将 PRD 转换为 JSON 格式以实现自主执行时，可选用此技能。

SKILL.md

--- frontmatter

name: generating-prd-json-from-prd-md
description: Generates prd.json task tracking file from PRD.md requirements document. Use when initializing Ralph loop or when the user asks to convert PRD to JSON format for autonomous execution.
model: haiku
allowed-tools: Read, Write, Bash

PRD to JSON Conversion

Hybrid approach: Python script parses, AI validates and corrects.

Workflow

•
Run parser (Bash tool)
bash
```
python ralph/scripts/generate_prd_json.py
```
Script handles: PRD.md parsing, (depends: ...) extraction, content hashing, state preservation.
•
Validate (Read tool)
- •Read ralph/docs/prd.json (script output)
- •Read docs/PRD.md (cross-reference)
- •Check against Validation Checklist
•
Correct errors (Write tool, if needed)
- •Fix issues found
- •Recompute content_hash if title/description/acceptance changed
- •Write corrected ralph/docs/prd.json
•
Report
- •Story count and status
- •Corrections made
- •Suggest: make ralph_run

Validation Checklist

For each story, verify:

• id follows STORY-XXX format
• title is 3-7 words, matches PRD.md feature
• description is non-empty
• acceptance array is non-empty
• files array contains valid paths (if specified in PRD.md)
• content_hash is 64-char hex string
• depends_on references valid STORY-XXX IDs (no circular deps, no self-refs)

Cross-reference with PRD.md:

• All #### Feature N: headings have corresponding stories
• Story order matches PRD.md feature order
• (depends: STORY-XXX) syntax correctly parsed

Common Issues to Correct

Issue	Correction
Empty acceptance	Extract from description or PRD.md feature
Invalid depends_on reference	Remove non-existent story IDs
Circular dependency	Remove one direction
Missing content_hash	Recompute from title+description+acceptance
Duplicate story IDs	Renumber sequentially

prd.json Schema

See ralph/docs/templates/prd.json.template for structure and fields.

Usage

bash

make ralph_prd_json

Next Steps

bash

make ralph_init    # Validate environment
make ralph_run     # Start Ralph loop