SuperAPI AI 工具集

building-product-specifications

写作与研究

查看项目

更新于 10-15 20:11

技能介绍

用途:在写应用代码前,把产品愿景(PRD)、功能行为(FRD)、技术设计(TRD)、用户旅程与 UI 规格(导航流程、页面结构、视图状态)落盘为 Markdown 文档。用户点名该技能,或引用标记文档根目录下的规格文件时触发;若用户在同一条消息中未明确要求,则只产出规格,不写应用代码。

主要能力:按文档类型划分配方,每条配方有独立规则,spec-contract.md 为共享基础。配方包括:creating-prd.md(新建或修订 prd.md)、creating-frd.md(新建或修订 features/<slug>/frd.md)、creating-user-story.md(产品级或功能级 user-story.md)、creating-trd.md(产品级或功能级 trd.md)、creating-ui-specs.md(ui-specs.md,覆盖流程、结构、视图状态)。每条“创建”配方也覆盖目标文件已存在时的“修订”场景。

使用方式:先定位文档根目录,通过 <docs-root>/index.md 中静态的 Author 签名 UUID 识别;若不存在,询问用户一个空文件夹路径并初始化。然后按意图匹配唯一配方并打开对应参考文件,按其规则创建或修订文档。契约定义了解析根目录、布局、frontmatter、层级、hub 同步与创建/修订流程。

适用场景:需要在实施前统一整理产品、功能、技术或 UI 规格的仓库环境,且智能体可读写仓库文件。

限制:资料未提供具体的模板正文、frontmatter 字段要求、层级与 hub 同步细节、依赖的模型或平台能力,也未说明是否收费、性能或效果。相关细节需参阅 spec-contract.md 及各配方文件,这些内容暂未提供。