SuperAPI AI 工具集

architecture-decisions

办公与效率

查看项目

更新于 10-16 08:07

技能介绍

用途:帮助团队以结构化框架做出并记录架构决策,覆盖质量属性分析、权衡评估与技术选型,最终产出ADR内容。

主要能力:接收决策上下文(必填,至少30字符)、决策类型(technology|pattern|tradeoff,默认tradeoff)、质量优先级(最多5项,默认performance与maintainability)、约束(JSON对象)与候选方案(至少2项)。执行流程为校验输入、理解问题域、识别质量属性与约束、按标准评估选项、生成决策矩阵、给出主推荐与备选、生成ADR。

使用方式:调用时提供decision_context,按需指定decision_type、quality_priorities、constraints、options。示例输入为实时库存系统,优先级performance与scalability,选项Redis、PostgreSQL、MongoDB,输出推荐“Redis处理热数据+PostgreSQL持久化”,置信度0.85,并附权衡说明与ADR。

适用场景:数据库选型、微服务与单体模式选择、初创MVP架构权衡等需要可追溯决策依据的场合。

限制与错误处理:上下文缺失返回E001并要求澄清;质量属性冲突触发优先级对话;选项不足要求补充备选;未知技术域建议转研究。校验错误不重试,上下文不清重试3次(1s、2s、4s),选项不足重试2次。建议将选项限制在3至4个可行方案,避免分析瘫痪;上下文过宽会导致推荐模糊。该技能每次调用只处理单个决策,并记录调用、分析与错误日志及决策耗时等指标。具体安装与调用命令暂未提供。