用途:在开始或引用某个功能模块的工作前,加载产品需求(PRD)、Figma 设计节点和各平台实现规格上下文。
安装前提:先运行 uv tool install git+https://github.com/yjmeqt/prd-tool.git 安装 prd CLI。
调用方式:/prd <module>/<feature> 加载完整 PRD;/prd <module>/<feature>#R2 加载指定需求;无参数时从对话上下文推断模块。
主要流程:解析参数映射到 prd/<module>/<feature>.xml;读取并运行 prd validate 校验,报错则先报告;解析 XML 结构;对相关规则中的 figma_node 读取 file 与 node 属性,将 node 的 - 分隔符转为 : 后调用 mcp__figma__get_design_context(失败回退 get_screenshot),多屏节点用 figma-extract-nodes 拆分;读取各 implementation 的 spec(跳过 TBD,可按 --platform 限定);最后输出结构化摘要(需求、规则完成数、开放缺陷、Figma 要点),并询问下一步。
PRD 为纯 XML 文件,元素顺序为 overview → implementation → requirement → bug。规则含 id、status(✅/❌/⚠️)、可选 context,可嵌套 figma_node;缺陷含 id、status(Open/Fix Pending/Fixed)、date、rule 及 current、expected、steps,仅在用户确认后才能标为 Fixed;ui_review 记录视觉复核发现。统计通过 prd stats 按需计算,格式化为 prd format。
限制:PRD 只描述产品行为,不含实现类型名、包名、色值、图标资源名、精确像素、分支名等;实现细节归各平台 spec。spec 为 TBD 或占位时须先写模块规格并经用户确认再实现。命令与文件路径需按原样保留。