Agent Skills
返回列表
根据 PRD 生成技术设计

根据 PRD 生成技术设计

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_df16bbeb/prd-to-tech-design 到你的 AI 助手中。

技能介绍

要解决的问题

把 PRD 直接交给模型写设计,常见问题是:脱离存量代码、接口和命名不合项目规范、异常与边界缺失、需求模糊时臆造、图表风格混乱、文档无法直接指导开发。该技能面向需要把产品需求落到技术方案的工程师,要求输出可执行设计文档,而不是泛泛的方案说明。

如何工作

技能按流程执行:读取 PRD URL 或粘贴文本;检查历史设计上下文;确认代码扫描范围;根据需求复杂度初选模板,并在代码分析后调整模板。它会分析 Controller、Service、数据表、接口路由、公共组件等,提取核心需求、边界条件、异常场景和非功能要求;对模糊点按高/中/低优先级主动澄清,而不是猜测。随后按模板生成 Markdown 设计文档,默认保存到 docs/tech-design/,覆盖接口、数据库、风险、排期等内容。架构图使用 PlantUML,流程图使用 Mermaid graph TD/LR,新增/修改节点需要明确标注。生成后还会执行一致性、完整性、可行性自检,检查接口路径、命名规范、错误码、需求覆盖、异常处理、技术栈对齐和组件复用。

适用边界

适合已有代码库的后端/全栈需求设计,尤其是接口新增、表结构变更、状态机或模块扩展。若 PRD 过于简略、链接不可访问、代码结构复杂或技术栈无法识别,需要人工补充线索或确认模块路径。技能强调不引入陌生技术、不臆造需求,高优先级问题未确认会标注待人工确认;模板文件缺失时使用内置标准结构。

使用场景

  • 收到新增接口 PRD,需结合现有接口和表结构输出可评审设计。
  • PRD 描述模糊,需在澄清边界、异常和高优先级问题后再生成技术方案。
  • 扩展已有功能,需读取历史设计并标注新增、修改和废弃内容。
  • 复杂需求需输出架构图和流程图,并检查节点、分支与文字步骤一致。

适合人员

  • 负责后端接口设计,需要把 PRD 落到路由、字段和异常处理的工程师。
  • 做需求评审,需要快速产出含澄清记录、风险点和排期的技术方案的产品研发。
  • 接手老系统扩展,需要复用历史设计、组件和命名规范的后端/全栈工程师。
  • 需要把复杂链路画成架构图/流程图并自检一致性的架构工程师。