用途:将当前对话上下文与对代码库的理解综合成一份 PRD(产品需求文档),并发布到项目 issue tracker。适用于用户希望基于当前上下文直接创建 PRD 的场景。该技能强调不要访谈用户,直接综合已知信息即可。
前置条件:issue tracker 与 triage 标签词表应已提供给你;若没有,先运行 /setup-matt-pocock-skills。
流程:先浏览仓库以理解代码库当前状态;PRD 中使用项目领域术语表词汇,并遵守相关 ADR。接着勾画实现所需构建或修改的主要模块,主动寻找可抽取的深模块(深模块指以简单、可测试、很少变化的接口封装大量功能),与用户确认模块是否符合预期、以及希望为哪些模块编写测试。然后按下述模板编写 PRD 并发布到项目 issue tracker,打上 ready-for-agent 的 triage 标签,无需额外 triage。
PRD 模板包含:问题陈述(从用户视角描述用户面临的问题);解决方案(从用户视角描述);用户故事(编号的长列表,每条格式为“作为…,我想要…,以便…”)。该列表应极其详尽并覆盖功能的所有方面;实现决策(已做出的实现决策,可包含将构建或修改的模块、这些模块将被修改的接口、开发者的技术澄清、架构决策、模式变更、API 契约、具体交互等,不要包含具体文件路径或代码片段,因为它们可能很快过时;例外:若原型产生的片段能比文字更精确地编码某项决策,如状态机、reducer、模式、类型形状,则可内联在相关决策中并简要说明来自原型,只保留决策密集部分);测试决策(什么是好测试,即只测试外部行为而非实现细节、将测试哪些模块、测试的既有先例);范围之外(不在本 PRD 范围内的内容);补充说明。