SuperAPI AI 工具集

technical-design

编程与开发

查看项目

更新于 10-16 06:45

技能介绍

用途:在已有设计文档并确定方案后,编写高层技术设计,把决策映射到代码库,衔接设计文档与任务拆解。输出不包含实现细节。

主要能力:识别受影响的模块、包或服务;按组件描述当前状态、目标状态与变更性质(新代码/重构/配置/迁移);记录工具与技术选型及理由;梳理依赖与执行顺序;记录风险与假设;明确范围边界;按模板写作并保存到 design-docs/,命名遵循 NN-short-description.technical-design.md,与父设计文档编号一致,完成后随设计文档移入 design-docs/completed/。

使用方式:需要设计文档作为输入,先复述并确认方案;按步骤识别受影响组件、定义各组件技术方法、选择工具、映射依赖、记录风险与假设、划定范围、撰写并提交评审;用户批准后运行质量检查,通过后再提示进入任务拆解。

适用场景:方案影响多个组件或系统、实现前需进行工具或技术选型、实现顺序存在非显然依赖、多人或多个智能体协作时。

限制:单一组件且方法明显的小改动可跳过;缺少设计文档时应先创建设计文档;不得写入生产代码、函数签名或类层级,伪代码仅可用于逻辑变更;组件须到模块/包/服务级别;每个组件都要出现在依赖图中;工具选型需给出理由;范围边界须明确;必须记录风险与假设;文档须经用户批准。

评审既有技术设计时,需逐条对照规则检查:设计文档链接、组件粒度、实现细节、组件覆盖、依赖完整性、工具理由、范围边界、风险与假设、文件命名,逐项指出违规及修复方式,不得只给笼统总结。