SuperAPI AI 工具集

product-prd

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

用途:为一项工作撰写恰当的产品文档——有时只是 3 行工单,有时是一份完整 PRD,绝不超出工作量所需。该技能不写应用代码,只产出后续构建(implement-feature)所依据的需求。输出落在 docs/specs/prd/。

主要能力:输入可为 Jira(jira issue view PROJ-123)、GitHub issue(gh issue view 42 --json title,body,labels,comments)、PR(gh pr view 123 --json title,body,files)、文件/目录、URL 或纯文本想法;尾部可用 --tier brief|one-pager|big 与 --intent validation|execution 覆盖评估。分级:brief(小,单一功能,约 2-3 条需求)、one-pager(中,一个模块或小应用,必含非目标,≤2 页)、big/validation(用 prfaq,含新闻稿+FAQ+必备 top-3 失败点)、big/execution(用 prd-full,编号需求、基线/目标/窗口指标、带日期变更日志)。若 one-pager 草稿超过约 5-7 条需求或跨多个团队/系统,应停下改用 prd-full。

使用方式:四阶段 Discover→Decide→授权门槛→Author→Validate。先读取输入来源并检查仓库,每条发现标注 CONFIRMED/INFERRED/UNKNOWN;gate-zero 决定是否真需文档,若一行改动或原型比写规格更快会直接建议停手。研究用 Explore/haiku 子代理扇出,外部结论须带来源;按依赖顺序访谈决策,记录 decision/assumption/question 行。授权门槛前给出约 1 页 alignment-summary 并征得明确授权,未授权不得写文件。撰写用 python <skill-dir>/scripts/scaffold.py --dir docs/specs/prd 生成单文件,需求用 PRD-<CAT>-NNN 编号(FR/NFR/UX/SEC/DATA/DES),RFC-2119 措辞、每条一个行为、含证据块与 Given/When/Then 验收标准;非目标用积极表述,未决项标 [NEEDS CLARIFICATION: ...]。验证运行 python <skill-dir>/scripts/validate.py --dir docs/specs/prd(门槛 0 CRITICAL、0 MAJOR)与 python <skill-dir>/scripts/hygiene.py --dir docs/specs/prd。

适用场景:需要判断是否写文档、需要按规模与意图分级产出需求、或下游读者是 AI 实现代理(可切换到 headings+列表、可选 agent-contract.md)时。

限制:不写任何应用代码,只覆盖 WHAT/WHY 不涉 HOW;设计(IA、流程、界面、状态)归 product-design-spec,视觉令牌归 product-design-tokens,架构决策记录归 docs-adr/docs-rfc,编码前轻量规格归 implement-feature;企业级多文件树仅在 scripts/scaffold.py --enterprise <tier> 后生成。平行研究与发现依赖 Task 工具,若无则顺序内联执行。该技能的收费、价格、平台等信息暂未提供。