SuperAPI AI 工具集

writing-prd

写作与研究

查看项目

更新于 10-22 17:17

技能介绍

用途

writing-prd 是一个用于编写产品需求文档(PRD)的技能,提供模板和格式规则,可在任何代码仓库中使用。它的定位是:PRD 用于记录已经做出的决策,而不是用来发现或做出决策。如果目标或范围尚未确定,应先运行 superpowers:brainstorming,再使用本技能编写 PRD。

适用触发场景:用户要求编写或起草 PRD、"product requirements document"、"продуктовые требования"、"написать ПРД" 等。

主要能力

  • 提供完整的 PRD 模板,包含章节:问题与背景、目标、非目标、用例、功能需求、非功能需求、成功指标、风险与开放问题、范围外/后续步骤。
  • 规定存储与命名约定:文件位于仓库根目录的 docs/<feature-slug>/YYYY-MM-DD-<feature-slug>-prd.md,由 Git 跟踪并永久保留,不得放入 tmp/,发布后也不删除。
  • 规定审批流程:如果当前环境支持原生 Plan Mode(EnterPlanMode/ExitPlanMode),先在 Plan Mode 的服务文件中起草,退出 Plan Mode 并在获得批准后才保存到 docs/;如果不支持(例如被派遣的子代理),先在聊天中起草内容并获得用户明确批准后再保存。永不自动提交,仅在用户明确要求时提交。
  • 规定格式化规则:PRD 正文完全使用俄语撰写(标题、正文和需求均如此),无论请求使用什么语言;代码块、标识符和技术术语保留原样。
  • 规定缺失信息处理:不适用的章节保留标题并写 Не применимо;未知事实(工单号、技术栈、截止日期、集成细节)写 TBD,绝不猜测;工单号只能由用户提供,不得编造前缀或编号。
  • 规定内容要求:无填充内容,只写事实和决策,不写对话叙述;功能需求必须具体可验证,避免“快速”“方便”“现代”等模糊表述,示例中要求搜索在 10k 条记录下 ≤200ms 返回结果。
  • 列出常见错误及修正方式,例如在目标/范围确定前写 PRD、未经批准直接保存、猜测工单号或未声明事实、删除不适用章节而非标记、假设项目特定的存储路径或工单格式等。

使用方式

用户提出编写 PRD 的请求后,技能基于对话中已有的信息组装文档,只在必填章节确实无法填写时才询问用户。起草阶段优先使用 Plan Mode(若可用),否则在聊天中完成草稿;获得用户明确批准后才保存到规定的 docs/ 路径。不自动提交到 Git。文档正文使用俄语,代码块和技术术语保持原样。

适用场景与限制

适用于在任意仓库中为某个功能编写 PRD,尤其适合已有充分上下文、需要规范化输出文档的场合。限制包括:如果目标或范围尚未决定,应先进行头脑风暴而不是直接写 PRD;不适合用作需求访谈工具;不读取项目规则文件(如 CLAUDE.md),如果项目约定需要覆盖默认存储路径或工单格式,需询问用户;文档正文强制使用俄语;未知信息只能标记 TBD 或 Не применимо,不得猜测。