SuperAPI AI 工具集

specsfy-specialist-software-architecture

编程与开发

查看项目

更新于 10-16 09:52

技能介绍

用途:在回退成本高的架构决策上提供流程化分析,例如新增服务、引入队列或分布式缓存、调整模块边界或结构性依赖方向;当延迟、可用性、一致性、容量等质量属性需要成为明确决策标准时也可使用。重命名、移动文件或局部重构等不影响边界的改动不属于架构决策,不应触发本技能。

主要流程:先定义系统目的、真实约束(预算、工期、人力)和可度量的质量属性场景;再梳理现状,包括数据归属、现有依赖、关键运行路径与痛点;识别冲突力量、难以回退的决策与各路径风险;用同一组场景和真实运维成本(网络、分布式一致性、可观测性、团队协作)比较方案;默认选择满足场景的最简结构;制定过渡计划,包括迁移期间兼容性、回归可观测性与可回滚路径;记录 ADR,并在可行时用自动化依赖测试或静态分析校验边界。

使用要点:每个模块应有清晰职责、数据和接口;依赖方向由易变策略指向稳定部分;没有真实可度量消费场景时不引入服务、队列、缓存或抽象层;明确区分已实现架构与目标架构;质量属性要写成含刺激、环境、期望响应与度量标准(如 200 req/s 下 p99 < 300ms)的场景;易替换的决策保持局部可逆,难以更改的用 ADR 显式记录;通过 strangler fig、expand/contract 等可验证接缝渐进演进,避免整体重写。

适用与限制:适合承担架构决策、迁移规划与评审的角色;不替代领域建模、技术调研、性能工程、交付与代码评审等专门技能,必要时先运行 $specsfy-specialist-domain-modeling 等关联技能。缺少可度量场景与证据时,不应宣称架构“可扩展”或“有韧性”。具体语言、工具、安装命令及 references/standards.md 内容资料未提供细节。