SuperAPI AI 工具集

oma-architecture

设计与创作

查看项目

更新于 10-15 21:42

技能介绍

用途:oma-architecture 是 oh-my-agent 体系中的软件架构专项技能,面向架构决策、系统设计、模块与服务边界划分、ADR 编写和设计权衡分析。它产出基于源码证据的架构建议或决策记录,而非直接修改实现代码。

主要能力:支持多种方法模式,包括诊断模式(症状模糊时先定位问题)、推荐模式(为具体决策选方向)、Design-Twice 模式(比较两个以上实质不同的方案)、ATAM 风格分析(质量属性场景、权衡点、架构风险)、CBAM 风格分析(架构投资的成本收益排序)以及 ADR 模式(最终决策记录)。可诊断变更放大、隐藏依赖、所有权不清、API 别扭等架构痛点,并处理 API 版本化、弃用窗口与已发布契约演进策略。

使用方式:先识别架构问题或决策边界,收集约束、源码证据与干系人背景,读取 .agents/results/architecture/ 中的既有决策,再选择最轻量且足够的方法。典型流程为 PREPARE、ACQUIRE、REASON、VERIFY、FINALIZE。当决策改变结构时,可输出 Mermaid 上下文/容器图;若 oma diagram resolve 报告引擎为 archify,则生成交互式 HTML 图与 JSON 规格。持久化产物保存到 .agents/results/architecture/。

适用场景:选择或评审系统架构、定义模块/服务/所有权边界、比较架构选项、排查架构痛点、排序架构投资或重构、编写架构建议或 ADR、决定 API 版本化与弃用策略。

限制:不用于视觉设计、品牌或落地页(用 oma-design)、功能规划与任务拆分(用 oma-pm)、基础设施置备或 Terraform 实现(用 oma-tf-infra)、缺陷诊断与代码修复(用 oma-debug)、安全/性能/无障碍评审(用 oma-qa)。证据不足时须明确假设;干系人利益冲突时综合权衡而非强行共识;每条建议须说明假设、权衡、风险与验证步骤。具体收费、价格与平台信息暂未提供。