SuperAPI AI 工具集

doc-prd

写作与研究

查看项目

更新于 10-15 23:24

技能介绍

用途:doc-prd 用于在 SDD 流程第 2 层(Container 级)创建产品需求文档(PRD),把业务需求转化为产品能力、用户画像与 KPI,说明产品做什么而非怎么做。上游为 BRD,下游依次为 EARS、BDD、ADR、SPEC、TDD、IPLAN、Code。每个 BRD 迭代周期对应一份 PRD,新范围新建 PRD,并用 @depends: PRD-NN 关联周期。

主要能力:按模板生成含 15 个章节的 PRD,包括文档控制、执行摘要、问题陈述、目标受众与用户画像、成功指标与 KPI、目标与范围、用户故事、功能需求、面向客户内容、验收标准、约束与假设、风险评估、可追溯性与术语表。第 8 节只保留角色定义与故事摘要及产品级验收标准,并注明详细行为在 EARS、可执行场景在 BDD;第 10 节须在至少 3 个类别有实质内容,否则为阻塞错误;第 14 节细化 BRD 第 8 节架构主题的技术选项与评估标准,不引用 ADR 编号。

使用方式:需先有上游 BRD,读取其全部章节文件作为一个逻辑文档;确认无 ID 冲突后,取本层下一个空闲编号 PRD-NN,在 docs/02_PRD/PRD-NN_{slug}/ 下创建嵌套目录,单体文件为 PRD-NN_{slug}.md,超过 25 KB 时按章节拆分。先写文档控制,再完成 15 个章节,添加指向现有 BRD 元素的 @brd: 标签,更新 PRD 索引与父 BRD 的下游产物,最后校验并一起提交。元素 ID 形如 PRD.NN.SS.xxxx,SS 为所在章节;可变的量化值使用 @threshold: PRD.NN.{category}.{key}。

适用场景与限制:适用于已有 BRD、需要定义产品功能与用户需求,或把业务需求转为产品能力、画像与 KPI 时。校验为阻塞式质量门:EARS-Ready 分数须不低于 90/100;缺少 @brd 标签、标签格式错误、内部链接断裂、缺少可追溯性章节均为错误。该技能本身是校验器,不含运行时代码。适配时读取 .aidoc/profile.yaml,仅遵循本技能的 section_toggles 与 glossary 配置,未知键忽略,无配置则用框架默认值。具体模板路径、治理文档与相关技能见资料所列 ${CLAUDE_PLUGIN_ROOT} 路径。