SuperAPI AI 工具集

architecture-review

编程与开发

查看项目

更新于 10-16 08:02

技能介绍

用途:评估现有系统架构在当前及可预见增长下是否适配目标,说明应保留、修复、简化、调查或推迟的部分,并选择满足需求的最小可逆改动。输出 report.html、audit.json、可追溯证据登记与验证记录。

主要能力:按 20 个维度评估(含适配性、容量、DDD、模块深度等),区分事实、测量、声明、推断与假设;重建已实现架构,包括 Ubiquitous Language、Bounded Context、上下文映射、源码依赖、运行时交互、数据归属、事务边界与部署单元;对比文档与实现并记录矛盾;追踪主读、主写及集成/任务/失败路径;保留优势并给出发现项(位置、观察、后果、优先级、置信度、替代方案、最小改动、验收标准、验证、回滚等)。

使用方式:先解析 SKILL_DIR、REPO、OUT,读取仓库与环境说明;默认只读,先检查授权来源,再一次性提出至多八个关键问题。运行 revision_check.py、inventory.py、measure.py、evidence_tool.py、验证器与渲染器;示例命令:python3 "$SKILL_DIR/scripts/revision_check.py" "$REPO" --out "$OUT/revision.json"。默认完整评估,仅在要求时做分诊;聚焦请求只深化指定维度,其余记为未评估。

适用场景:对已有系统做架构适配性审查、容量与增长评估、模块设计与依赖规则检查、迁移选项比较与目标架构描述。

限制:不修改产品代码、测试、依赖、配置、Git、CI 或基础设施;不提交、推送、部署或应用修复;不读取密钥、凭据、生产转储或个人数据;不将私有代码上传外部服务;构建、测试与脚本执行需单独授权;生产环境不得用于负载测试或破坏性实验;不自动运行 EXPLAIN ANALYZE;不声称正式 ATAM 评估或认证;缺失测量记为未知而非证明缓慢。