SuperAPI AI 工具集

to-prd

写作与研究

查看项目

更新于 10-16 06:04

技能介绍

用途:to-prd 用于把当前对话直接综合为一份 PRD,并发布到项目的 issue tracker。它的定位是不对用户做访谈,只整理已经讨论过的内容。

主要能力:根据当前对话上下文与对代码库的理解产出 PRD;探索仓库以了解代码库现状;使用项目领域词汇;遵循相关 ADR;在测试接缝上进行设计,优先复用既有接缝,使用尽可能高的接缝,新接缝尽量少(理想数量为一个),并与用户确认这些接缝符合预期;按模板撰写 PRD 并发布到 issue tracker;发布时应用 ready-for-agent 的 triage 标签,无需额外 triage。

使用方式:当工作流与用户请求匹配时使用。前提是 issue tracker 与 triage 标签词表应已提供,若未提供则运行 /setup-matt-pocock-skills。流程为:先探索仓库理解代码库当前状态(如尚未完成);使用项目领域词汇撰写 PRD,并尊重所涉区域的 ADR;勾勒要测试该功能的接缝,优先既有接缝与尽可能高的接缝,如需新接缝则在可达到的最高点提出,接缝越少越好,理想为一个;与用户确认接缝是否符合预期;按模板撰写 PRD 后发布到项目 issue tracker,并应用 ready-for-agent 标签。

PRD 模板包含:问题陈述(从用户视角描述用户面临的问题)、解决方案(从用户视角描述问题的解决方案)、用户故事(一段很长的编号列表,每条格式为 As an 、I want a 、so that ,应极其详尽并覆盖功能各方面)、实现决策(列出已做出的实现决策,可包括将构建或修改的模块、这些模块将修改的接口、来自开发者的技术澄清、架构决策、模式变更、API 契约、具体交互;不要包含具体文件路径或代码片段,因为它们可能很快过时;例外情况是原型产出的片段若比散文更精确地编码了某个决策(状态机、reducer、schema、类型形状),可内联在相关决策中并简要说明来自原型,且只保留决策密集部分,不是可运行 demo,只是要点)、测试决策(描述什么构成好测试,仅测试外部行为而非实现细节;哪些模块将被测试;测试的先例,即代码库中类似类型的测试)、范围外(描述本 PRD 范围外的事项)、补充说明(关于该功能的任何进一步说明)。

适用场景:已有一定对话上下文、需要快速沉淀为 PRD 并进入 issue tracker 的项目。

限制:当工作流指定上游工具、账号、API key 或本地环境时,需要具备相应条件;除非用户明确批准,不授权破坏性操作、生产操作、付费操作或对外发消息操作;将生成产物或建议视为最终结果前,应针对用户真实来源进行验证。