SuperAPI AI 工具集

to-prd

写作与研究

查看项目

更新于 10-16 04:58

技能介绍

用途:to-prd 将当前对话上下文转换为结构化 PRD,并提交到项目问题跟踪器,用于记录已有讨论中的需求、在拆分工作前创建正式规格,以及在用户故事旁记录架构决策。它不采访用户,而是从已有上下文中综合生成。

不适用场景:拆分工作为工单应使用 to-issues;编写技术内部文档应使用 technical-writing;快速任务笔记应使用 task-planning。

流程:一、探索与理解,使用项目领域词汇(CONTEXT.md)和相关 ADR 审查代码库,不采访用户,从现有上下文综合。二、设计模块,识别要构建或修改的主要组件,强调深模块(简单、可测试的接口与稳定契约),与用户验证假设并确认哪些模块需要测试覆盖。三、文档与发布,完成 PRD 模板并提交到问题跟踪器,带 needs-triage 标签。

PRD 模板包含:标题、问题陈述(面向用户)、解决方案(面向用户)、用户故事(As a [actor], I want [feature], so that [benefit])、实现决策(模块、技术选择、ADR 参考)、测试决策、范围外、进一步说明。质量检查:问题陈述面向用户而非技术;用户故事覆盖所有角色和用例;实现决策引用现有领域词汇;范围外部分防止范围蔓延;PRD 中不含文件路径或代码。

使用方式:按技能工作流从上到下执行,每步后验证输出,记录阻塞和回退路径。最佳实践:保持输出确定且可审计,优先小规模可逆变更,明确记录假设。参考资料包括项目标准 .agent-skills/skill-standardization/SKILL.md 和验证脚本 .agent-skills/skill-standardization/scripts/validate_skill.sh。限制:不适用于拆分工单、技术内部文档或快速任务笔记;PRD 中不应包含文件路径或代码。