SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-16 01:48

技能介绍

用途:扫描代码库,发现架构摩擦并提出“加深”机会,即把浅模块改造为深模块,从而提升可测试性与 AI 可导航性。

主要能力:先按 YAGNI 划定范围,优先关注近期变更频繁的热点区域;可读取 CONTEXT.md 领域词汇表与 docs/adr/ 中的 ADR;然后由子代理有机探索代码库,寻找需要在多个小模块间来回理解、接口与实现复杂度相当、仅为可测试性抽取纯函数导致缺乏局部性、模块跨接缝泄漏、以及未测试或难以测试之处,并对疑似浅模块应用删除测试。

输出与用法:将结果写为自包含 HTML 文件到系统临时目录,路径为 <tmpdir>/architecture-review-<timestamp>.html,不在仓库内落地;通过 xdg-open、open 或 start 打开并告知绝对路径。报告用 Tailwind CDN 布局、Mermaid CDN 绘图,候选卡片含文件、问题、方案、收益、前后对比图与推荐强度徽章(Strong、Worth exploring、Speculative),末尾给出优先推荐。

深入探讨:用户选定候选后,运行 /grilling 技能走决策树,讨论约束、依赖、加深模块形态、接缝背后内容及测试影响;并用 /domain-modeling 同步领域模型,必要时新增或更新 CONTEXT.md 词条,或在用户以关键理由否决时提议记录 ADR。

前置条件与限制:建议先运行 /codebase-design 获取架构词汇与原则,并在建议中严格使用 module、interface、depth、seam、adapter、leverage、locality 等术语;若候选与现有 ADR 冲突,仅在摩擦足够真实时呈现并标注。此阶段不提出具体接口,先询问用户选择哪一项。其他细节暂未提供。