SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-15 17:29

技能介绍

用途:查找代码库中的架构摩擦点,提出将浅模块改造为深模块的重构机会,目标是在提升可测试性的同时,让 AI 更容易理解代码库。它由项目领域语言(CONTEXT.md)和记录在 docs/adr/ 中的决策提供参考。

主要能力:使用一套固定术语描述架构,包括模块(有接口与实现的函数、类、包、切片)、接口(调用者需知道的一切,如类型、不变量、错误模式、顺序、配置)、实现、深度(接口处的杠杆率,小接口背后承载大量行为即深)、接缝(接口所在处,可在不原地修改的情况下改变行为)、适配器(在接缝处满足接口的具体事物)、杠杆与局部性。核心原则包含删除测试:设想删除某模块,若复杂度消失则它只是通道;若复杂度在多个调用者处重现,则它物有所值。接口即测试面。一个适配器代表假设接缝,两个适配器才是真实接缝。

使用方式:先阅读项目领域词汇表和所涉区域的 ADR,再用 Agent 工具以 subagent_type=Explore 遍历代码库,记录遇到摩擦的位置。随后以编号列表呈现深化候选,每项包含涉及文件/模块、当前架构造成摩擦的原因、改动的平实描述,以及从局部性和杠杆、测试改进角度的收益,并沿用 CONTEXT.md 的领域词汇与 LANGUAGE.md 的架构词汇。若候选与已有 ADR 冲突,仅在摩擦足够真实时标注并说明值得重新审视。此时不提出具体接口,而是询问用户想探索哪一个。用户选定后进入追问环节,梳理约束、依赖、深化模块形态、接缝后方的部分以及能存活的测试;决策成形时同步更新 CONTEXT.md,必要时建议记录 ADR。

适用场景:希望重构代码库架构、改善可测试性与可导航性,并已有领域词汇或 ADR 可参考的项目。

限制:资料未提供安装命令、价格、平台、具体文件格式细节及代码示例;效果与支持环境暂未提供。