SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:扫描代码库,找出架构摩擦点并给出「深化机会」——把浅模块(接口复杂度接近实现)改造成深模块,目标是提升可测试性与 AI 可导航性。

主要能力:基于项目领域模型和共享设计词汇(模块、接口、深度、接缝、适配器、杠杆、局部性等)提出建议;结合 git 提交历史定位热点区域;读取 CONTEXT.md 领域词汇与 docs/adr/ 中的 ADR,避免重复推翻既有决策;对可疑浅模块应用「删除测试」,判断删除后复杂度是收敛还是仅被转移。

使用方式:先用 Skill 工具调用 "codebase-design" 获取架构词汇与原则,调用 "grilling" 进行决策树讨论,调用 "domain-modeling" 维护领域模型。用户可指定方向(模块、子系统、痛点),否则用 git log --oneline 回看提交历史推断热点。随后生成自包含 HTML 报告,写入临时目录:解析 $TMPDIR,回退 /tmp(Windows 为 %TEMP%),文件名形如 <tmpdir>/architecture-review-<timestamp>.html,并用 xdg-open / open / start 打开。报告用 CDN 引入 Tailwind 与 Mermaid,每个候选含文件、问题、方案、收益、前后对比图和推荐强度(Strong、Worth exploring、Speculative),末尾给出首选建议。用户选定候选后进入 grilling 循环,讨论约束、依赖、深化模块形态、接缝背后内容与测试存留。

限制:报告阶段不提出具体接口设计;若候选与 ADR 冲突,仅在摩擦足够真实时标注说明。资料未提供该技能的价格、平台支持范围与效果数据。