SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-16 08:08

技能介绍

用途:发现架构摩擦并提出模块深化机会,把浅模块重构为深模块,提高可测试性和 AI 可导航性。本 Skill 只做只读探索、报告和决策收口,不修改业务代码;用户确认实施后再进入 impl。

流程:1)加载项目上下文,使用已加载的 CONTEXT 术语与 RULE,完整读取 codebase-design 的模块、接口、深度、接缝、适配器、杠杆、局部性词汇与判断准则。2)探索时先限定扫描范围,优先关注近期频繁变化的区域;用户指定方向则直接使用,未指定则查看 git log --oneline 找热点。把范围与准则交给只读子 Agent,记录真实摩擦,如概念需在多个小模块间跳转、接口与实现同样复杂的浅模块、仅为测试抽出的纯函数、紧耦合导致细节泄漏、无法通过当前接口自然测试的区域;对疑似浅模块执行删除检验,复杂度重新散开才说明有深化价值。3)在操作系统临时目录写入 architecture-review-<timestamp>.html,优先 $TMPDIR,否则 /tmp,Windows 用 %TEMP%,不写入仓库;生成后用默认方式打开并返回绝对路径。报告用 Tailwind CDN 布局、Mermaid CDN 表达调用图依赖图时序,每个候选含涉及文件、问题、方案、收益、Before/After 并排展示和推荐强度,末尾给出首选建议。4)用户选中候选后启动 ask-me,围绕约束、依赖、模块形状、接缝背后内容和保留测试完成决策树;出现长期术语或规则时按项目知识协议建议记录,因长期原因拒绝候选时询问是否记录 ADR,需要比较多方案时读取 DESIGN-IT-TWICE.md,确认实施则结束本 Skill 转入 impl。

限制:只读,不修改业务代码;报告不写入仓库;候选与 ADR 冲突时仅在摩擦真实且足以重新讨论时展示并标记;此阶段不设计具体接口。