SuperAPI AI 工具集

align-architecture

编程与开发

查看项目

更新于 10-16 06:50

技能介绍

用途:验证代码实现是否与 ADR、设计文档或架构规范中记录的架构决策保持一致;当实施偏离记录决策时生成架构合规性报告。

主要能力:解析设计来源(ADR、设计文档、架构规范),提取关键决策(边界、组件、模式、约束);按决策逐项比较代码,评估为合规、部分、违反或未知;对差距分类(边界违规、缺少组件、发散模式、过时设计),记录影响范围与根本原因;输出可操作报告并写入约定路径。

使用方式:默认设计路径来自项目规范或 docs/architecture/、docs/design-decisions/、docs/process-management/decisions/,代码范围默认为整个仓库,也可指定增量路径。报告默认写入 docs/calibration/architecture-compliance.md,可由项目规范 path_pattern 覆盖,或写至用户指定路径。报告含摘要、设计来源、比对范围、差距列表与移交建议,并附机器可读的 YAML/JSON 合规块。

适用场景:实施后检查、里程碑或发布门、漂移调查、入职审核。编排上,规划层不确定时可先运行 align-planning,再运行本技能。

限制:设计文档缺失时输出阻塞报告,不臆造设计决策;证据准备度为弱时执行部分验证并明确覆盖/未覆盖范围与置信度,不声称高可信;未获用户明确批准不修改设计文档;不进行无设计参考的结构性代码审查,不负责需求分析、设计创作或规划层对齐。设计过时或冲突时建议移交设计-解决方案,需结构审查时移交 review-architecture。更多收费、平台与效果信息暂未提供。