SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:扫描代码库中的架构摩擦点,提出“深化”机会——把浅模块变为深模块的重构,以提升可测试性与 AI 可导航性。

主要能力:先按 YAGNI 划定范围,若用户指定方向则直接采用,否则用 git log --oneline 回溯提交历史找出热点文件;先读 CONTEXT.md 领域词表,再派子代理有机探索代码库,关注理解一个概念需在多个小模块间跳转、接口复杂度接近实现、仅为可测试性抽出的纯函数却无局部性、紧耦合模块越过接缝泄漏、未测试或难以通过现有接口测试之处;对疑似浅模块应用删除测试。

使用方式:该命令依托项目领域模型与共享设计词汇,需先运行 /codebase-design 技能获取架构词汇(module、interface、depth、seam、adapter、leverage、locality)及原则,并在所有建议中严格使用这些术语。生成候选后,将自包含 HTML 报告写入系统临时目录(从 $TMPDIR 解析,回退 /tmp,Windows 用 %TEMP%),文件名 <tmpdir>/architecture-review-<timestamp>.html,并用 xdg-open/open/start 打开并告知绝对路径;报告用 CDN 引入 Tailwind 与 Mermaid,每个候选项含文件、问题、方案、收益、前后对比图与推荐强度徽章(Strong、Worth exploring、Speculative),结尾给出首选建议。此时不要提出接口,先询问用户想探索哪个。用户选定后运行 /grilling 技能走查决策树;过程中随决策固化运行 /domain-modeling 技能更新 CONTEXT.md,如需探索替代接口可运行 /codebase-design 的 design-it-twice 并行子代理模式。

限制:报告设计细节见仓库 .agents/skills/improve-codebase-architecture/HTML-REPORT.md;未提供收费、平台等信息。