SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

用途:在代码库中寻找架构摩擦,提出把浅模块变为深模块的重构机会(深度指小接口背后承载大量行为),以改善可测试性和 AI 可导航性。该技能会参考项目领域模型,CONTEXT.md 提供良好接缝的名称,docs/adr/ 记录不应重新争论的决策。

主要能力:使用统一术语(Module、Interface、Implementation、Depth、Seam、Adapter、Leverage、Locality)描述问题;用删除测试判断模块是否值得保留;关注概念理解需在多个小模块间跳转、接口复杂度接近实现、为可测试性抽出纯函数但真实缺陷隐藏在调用方式、紧耦合模块跨接缝泄漏、未测试或难以通过当前接口测试的部分。

使用方式:先读领域词汇表和相关 ADR,再用 Agent 工具 subagent_type=Explore 探索代码库,记录摩擦点;随后在系统临时目录生成自包含 HTML 报告(路径如 <tmpdir>/architecture-review-<timestamp>.html),用 Tailwind CDN 布局、Mermaid CDN 画关系图,并为每个候选提供文件、问题、方案、好处、前后对比图和推荐强度徽章,最后给出 Top recommendation。报告写完后询问用户想探索哪个候选,再进入设计讨论循环。

限制与注意:不要在报告中直接提出接口;不要照搬“component/service/API/boundary”等词;与 ADR 冲突的候选仅在摩擦真实存在时标注并说明值得重开的原因;命名、术语更新、ADR 记录等副作用在讨论中按需写入 CONTEXT.md 或 ADR 文件。具体 HTML 脚手架、格式与样式细节见 HTML-REPORT.md、LANGUAGE.md、CONTEXT-FORMAT.md、ADR-FORMAT.md、INTERFACE-DESIGN.md;其余平台与收费信息暂未提供。