SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-16 03:35

技能介绍

用途:探索代码库中的架构摩擦,提出“加深机会”——把浅模块重构为深模块,目标是提升可测试性与 AI 可导航性。

主要能力:使用统一术语(模块、接口、实现、深度、接缝、适配器等)描述架构;依据项目领域模型 CONTEXT.md 和 docs/adr/ 中的决策进行判断;先探索代码库并列出候选重构点,再由用户选择后展开逐一讨论(grilling loop);在讨论中可顺手把新概念补入 CONTEXT.md,或在用户给出关键理由时提议记录为 ADR。

使用方式:先读取 CONTEXT.md(或多上下文仓库中的 CONTEXT-MAP.md 及各 CONTEXT.md)与 docs/adr/ 中的相关 ADR;若这些文件不存在则静默继续。然后用 Agent 工具以 subagent_type=Explore 遍历代码库,关注理解一个概念是否需要在多个小模块间跳转、哪些模块浅(接口复杂度接近实现)、哪些纯函数仅为可测试性而抽取、哪些紧耦合模块跨越接缝泄漏、哪些部分未经测试或难以通过现有接口测试。列出候选后用编号清单呈现:涉及文件、问题、解决思路、收益(以局部性和杠杆及测试改善说明)。注意此时不要提出接口,先问用户想探索哪一个。用户选定后进入讨论循环,沿途可更新 CONTEXT.md 或提议 ADR。

适用场景:用户希望改进现有代码库架构、提升可测试性或 AI 可导航性时。

限制:资料未提供安装命令、运行命令、收费与平台信息,暂未提供具体命令示例;不应对 ADR 已禁止的理论性重构逐一列举;只有当摩擦足够真实时才建议重开 ADR。