SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-16 06:14

技能介绍

用途:审计代码库中的架构摩擦,寻找把浅模块转为深模块的重构机会,以改善局部性、杠杆效应、可测试性与导航体验。分析前需先阅读 CONTEXT.md 与相关 ADR,并应用 codebase-design 中的词汇与原则(模块、接口、深度、接缝、适配器、杠杆、局部性、删除测试),同时保留项目原有领域术语。

主要能力:直接检查代码库,识别浅接口、散落的知识、泄漏的接缝、低局部性的调用模式,以及难以通过稳定接口测试的行为。在运行时允许时可借助 RUNTIME_TOOLS.md 中的 explorer 或子代理能力做大范围探索,否则在主代理中继续。

呈现候选:将自包含的 HTML 报告写入操作系统临时目录并告知绝对路径;用 Mermaid 表达图状关系,用 HTML、CSS 或 SVG 做编辑性对比。每个候选包含涉及文件、摩擦点、通俗语言描述的改动、收益、前后对比视图、与 ADR 的冲突及置信度评级,最后给出最强推荐。用户选定候选前,不提出详细接口设计。

选定后的探索:设计需对照项目领域模型与 ADR 检验时用 grill-with-docs,仅做对话式设计质询时用 grill-me。术语变化时保持 CONTEXT.md 最新;仅当某个被否决的前提会被未来评审重复提及,才提供 ADR。限制:资料未提供安装命令、费用或平台细节。