SuperAPI AI 工具集

reviewing-technical-design

设计与创作

查看项目

更新于 10-15 20:07

技能介绍

用途:这是“编写/评审技术设计”配对中的评审一半。当拿到一份已完成的技术设计文档(TDD,即功能规格之下、说明某功能如何在既有系统中构建的文档)时,用它判断:工程师能否不重新推导设计就实现该功能,所选方案是否相对真实备选方案得到论证。适用于实现前的验收门禁、对修订后 TDD 的复评,以及对变更请求的增量评审。不适用于编写或修复 TDD、评审上游 PRD/功能规格、评审 api-spec 或数据模型本身、评审通用设计文档/RFC/ADR,也不用于检查模板章节是否齐全。

主要能力:按固定的 11 项可实现性检查清单逐条判定通过或存在缺口,包括需求双向可追溯、范围限定在单一功能且高度合适、方案与分解可实现、引用而非复制(SSOT)、至少一个真实备选方案及决策标准、失败模式与横切健壮性、可观测性、测试、发布/迁移/回滚、假设明确且非编造,以及(仅增量评审时)变更范围清晰、涟漪处理干净、有版本与变更记录。评审只判结果,不强制要求作者使用 FMEA、RTM、C4 或特定图表形式。

使用方式:先以独立视角通读全文,保留上游功能规格、PRD 及被引用的架构文档/api-spec/数据模型;若为变更请求则走增量路径。逐条判定,缺口须指出确切位置与缺失内容。最后单独一行输出 VERDICT: approve 或 VERDICT: revise,随后列出发现;revise 时每条发现须包含失败条件、位置与具体修复方式。

限制:只评审不代写,不重写或补全设计;不得自造额外条件或更严的私人标准;不得为示好而误批,也不得为凑数而误退;薄功能可合理省略迁移、并发、独立可观测性章节或变更记录,不应因简短而制造缺口。

分类:该技能用于技术设计文档的评审与验收门禁,属于编程与开发范畴。