SuperAPI AI 工具集

improve-codebase-architecture

前端与建站

查看项目

更新于 10-15 21:49

技能介绍

用途:扫描代码库,找出架构摩擦点并提出“深化”重构建议,把浅模块变成深模块,目标是提升可测试性与 AI 可导航性。

主要能力:先确定扫描范围(优先近期变更的热点区域),读取 CONTEXT.md 领域词汇与 docs/adr/ 中的 ADR;再用 Explore 子代理有机探索,识别概念分散、模块过浅、纯函数仅为测试而抽取、耦合泄漏、难以测试等问题,并用删除测试判断是否值得深化。随后把候选方案写成自包含 HTML 报告,输出到系统临时目录(如 <tmpdir>/architecture-review-<timestamp>.html),用 Tailwind 与 Mermaid 做可视化,每张卡片含涉及文件、问题、方案、收益、前后对比图与推荐强度(Strong、Worth exploring、Speculative),末尾给出首选建议。用户选定后进入 grilling 循环,梳理约束、依赖、深化模块形态与测试影响,并可用 /domain-modeling 更新领域模型、用 /codebase-design 探索替代接口。

使用方式:作为命令运行;建议先运行 /codebase-design 获取架构词汇,术语需严格使用 module、interface、depth、seam、adapter、leverage、locality,避免使用 component、service、API、boundary。报告阶段不提出接口,先询问用户想探索哪一项。

限制:报告写入临时目录而非仓库;若候选与 ADR 冲突,仅在摩擦足够真实时标注并建议重开 ADR;不列出 ADR 禁止的所有理论重构。具体安装与调用命令资料未提供。