SuperAPI AI 工具集

architect-analyze

编程与开发

查看项目

更新于 10-16 01:24

技能介绍

用途:对架构文档做只读一致性分析,校验 ADR 与 AD 之间的双向偏差、内部一致性、陈旧引用与质量缺口,并输出结构化分析报告,不修改文件。

主要能力:覆盖七类检测,包括 ADR 质量(对照 MADR 标准检查上下文、决策、正负后果、风险、备选方案、状态、合规性)、ADR 之间的冲突与术语漂移、ADR→AD 正向同步、AD→ADR 反向同步、AD 内部视图一致性(含 Mermaid 图与文字对齐、视图完整性、DAG 状态校验、功能视图技术中立性、功能-开发映射)、陈旧占位符检测、特性与系统架构对齐。按 CRITICAL/HIGH/MEDIUM/LOW 分级,最多列 50 条发现,其余汇总。项目宪法(memory/constitution.md)冲突自动判为 CRITICAL。

使用方式:在项目根目录先安装依赖技能 adlc-cli skills add tikalk/adlc-team-skills --skill architect-clarify,再运行 setup-architect.sh 加载架构制品。可传参缩小范围:空为全量,system 只看系统级 AD.md 与 ADR,adrs 只看 ADR 质量,views 只看 AD.md 报表;另有 feature 范围。无架构制品时先使用 /architect-init 或 /architect-specify。报告后可按需调用 /architect-clarify(完善 ADR)或 /architect-implement(同步 AD 视图)。

适用场景:验证生成的 AD.md、核对 ADR 细化结果、开发前质量门禁、架构评审、随代码演进定期检测漂移。

限制:严格只读,不创建架构,不做任何自动修改;修复需用户显式批准后手动调用编辑命令。资料未提供收费、价格与平台等信息。