SuperAPI AI 工具集

authoring-technical-design

设计与创作

查看项目

更新于 10-15 20:07

技能介绍

用途:为单个功能或组件撰写技术设计文档(TDD/工程设计文档/设计 RFC),或对已批准的 TDD 做版本化增量修订。它提供的是撰写方法与可实施性标准,而非章节清单。

主要能力:以已批准的 PRD 与功能规格为输入,驱动设计并做双向需求追溯;按模板章节填充内容,包括背景与问题、需求追溯、选定方案与组件分解、控制与数据流、关键接口与契约、详细设计、错误处理与失败模式、横切关注点(安全/隐私/可观测性)、备选方案、测试方法、发布与迁移。要求至少一个真实备选方案及决策标准,失败模式须含检测与恢复,生产功能须命名健康/失败信号与可度量的回滚触发条件。

使用方式:从技术设计模板工具获取章节结构,读取上游文档(PRD、功能规格,以及架构文档、API 规格、数据模型),用深度研究能力为设计提供依据,按方法逐节填写,交付前对照可实施性标准自检。修订时按增量路径处理:限定受影响决策、重做内部链条、分析双向与单一事实来源的涟漪影响、更新版本与变更日志、标记被取代的决策。

适用场景:为已有系统中的单个功能设计实现方式;决定并记录实现方案;以版本化增量修订已批准的 TDD;用有研究支撑、决策完整的内容填充模板。

限制:不用于设计整个系统结构、服务拓扑或长期技术选型(属更高层架构文档);不用于撰写 API 契约或数据模型本身;不用于撰写 PRD 或功能规格;不用于评审或评分已完成的 TDD。接口、模式与系统结构应引用而非复制。不得编造设计;无来源时须标注为待验证假设。若功能无法从给定信息设计,应作为阻塞项提出。具体模板工具与深度研究能力未在资料中给出名称或安装方式。