SuperAPI AI 工具集

arch-design

设计与创作

查看项目

更新于 10-15 17:24

技能介绍

用途:这是 planning 阶段的架构设计技能。spec 定"做什么",本技能定"怎么做",但只到架构层面(模块、依赖、分层、接缝),不下沉到代码细节,之后由 incremental-impl 落地切片。流程:spec-design → arch-design → incremental-impl。

两个入口:一是新功能架构设计,输入 docs/specs/<topic>/spec.md 与 validation-contract.md;二是既有系统架构升级,输入目标代码加一句具体的结构抱怨。用户提到技术方案、模块怎么拆、怎么分层、依赖关系、重构方案等时触发。

主要能力与原则:设计是"怎么做"不是"做什么";架构升级不改变对外可见行为;推荐方案是满足设计驱动的最简方案;引入抽象必须有明确具体理由。流程分四步:A 调研(读 spec、读目标代码、检索 docs/rules/arch/ 项目级规则、给结构问题定性、规模退出);B 出至少两个真候选并做权衡对比与最简审查;C 由用户选方向并打磨,定迁移路径与行为保护网,按闸门决定是否落库 arch_design.md;D 自检与交接。

诊断工具:删除测试、深/浅模块,以及循环依赖、依赖方向倒错、上帝模块、浅模块、跨接缝泄漏、发散式变化、霰弹式修改、依恋情结等信号。设计原则含依赖规则、沿变化轴切模块、无环依赖、边界划在变化速率断层上。迁移形态分并行变更、抽象分支、绞杀榕三种。

限制:不用于需求澄清(回 spec-design)、切片与执行细节(属 incremental-impl)、有复现步骤的 bug(走 systematic-debugging)、模块内代码级清理(属 code-simplify)、琐碎单模块改动。arch_design.md 为有条件产出,闸门未触发时对话内拍板即可。输出语言随对话语言,正文用中文、章节标题保持模板英文锚点。收费、价格、具体平台与效果资料暂未提供。