SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-16 12:33

技能介绍

用途:审计现有仓库或多模块子系统,找出最高价值且边界清晰的架构改进,而不是给出泛泛的清理清单;默认只审计与选择,不修改代码。适用问题包括系统性耦合、散弹式修改、可测试性差、AI 可导航性差等,并判断“现在值得投入哪项架构改进、为什么”。

主要能力:结合变更压力、调用方负担、局部性、依赖方向、可测试性、所有权、运行时风险与项目意图生成候选;候选类型包括深化模块、消除穿透式调用链、拆分不内聚的大模块、移动接缝、修正依赖方向、恢复局部性、让契约更诚实。每个候选给出证据、反证、建议强度(强/值得探索/推测性)与独立置信度;若没有候选超过推测级别,则建议暂不投入。最终产出可离线阅读的 HTML 报告,内联 CSS 与静态 HTML/SVG,含前后对比图、风险、下一步与首选建议。

使用方式:先锁定审查目标(用户指定范围或从变更热点等信号推断),阅读项目意图与文档,从入口追到可观测结果;然后生成候选、排序,再生成报告(默认写入操作系统临时目录的时间戳文件)。参考文件 references/html-report.md 与 references/source-notes.md 需按说明读取。审计在用户选择具体候选后才继续设计。

限制:仓库视为只读,默认仅写报告,不改生产代码、测试、架构决策或术语表;不提前设计具体接口签名;不因文件长度、目录美观、单一适配器或推测性未来需求而提出候选;不制造“首选重构”。与其他技能分工明确:单模块职责设计用 codebase-design,源码树与包边界审计用 structure-codebase,已验证路径的机制减少用 reduce-system-complexity,方案比较用 evaluate-existing-solutions,行为保持的重构用 refactoring。收费、价格与具体平台支持情况暂未提供。