SuperAPI AI 工具集

improve-codebase-architecture

前端与建站

查看项目

更新于 10-15 19:54

技能介绍

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

主要能力:先确定扫描范围(YAGNI,优先近期变更的热点区域),读取 CONTEXT.md 领域词汇与 docs/adr/ 中的 ADR;再派子代理有机探索代码库,寻找理解一个概念需在多个小模块间跳转、接口复杂度接近实现、纯函数抽取后真实缺陷藏在调用处、模块跨接缝泄漏、难以测试等摩擦点,并用删除测试判断是否浅模块。随后生成自包含 HTML 报告写入系统临时目录($TMPDIR,回退 /tmp 或 %TEMP%),文件名 architecture-review-<timestamp>.html,用 xdg-open、open 或 start 打开并告知绝对路径。报告用 CDN 的 Tailwind 与 Mermaid,每个候选卡片含文件、问题、方案、收益、前后对比图与推荐强度徽章(Strong、Worth exploring、Speculative),末尾给出首选建议。

使用方式:用户指定方向则直接采用,否则用 git log --oneline 回溯提交历史找热点;报告完成后询问用户想探索哪个候选,再调用 grilling 技能走决策树,并用 domain-modeling 技能同步更新 CONTEXT.md,必要时提议记录 ADR。

限制:此阶段不提出具体接口;与 ADR 冲突的候选仅在摩擦足够真实时标注;术语须使用 codebase-design 词汇(module、interface、depth、seam、adapter、leverage、locality),避免 component、service、API、boundary。具体安装与调用细节暂未提供。