SuperAPI AI 工具集

improve-codebase-architecture

前端与建站

查看项目

更新于 10-15 23:34

技能介绍

用途:扫描代码库,找出架构摩擦点并提出“深化机会”——把浅模块改造成深模块,目标是提升可测试性与 AI 可导航性。建议基于项目领域模型,并使用共享架构词汇(模块、接口、深度、接缝、适配器、杠杆、局部性)及删除测试等原则。

主要能力:1) 探索阶段:先定范围(YAGNI),优先关注近期变更的热点区域;可读取 CONTEXT.md 领域词汇与 docs/adr/ 中的 ADR;用 Explore 子代理有机地走查代码,寻找理解需在多个小模块间跳转、接口与实现复杂度相当、纯函数仅为测试而抽取、模块跨接缝泄漏、难以测试等摩擦点。2) 报告阶段:在系统临时目录生成自包含 HTML 文件(如 <tmpdir>/architecture-review-<timestamp>.html),用 CDN 的 Tailwind 与 Mermaid 做布局和图表,每个候选卡片包含涉及文件、问题、解决方案、收益、前后对比图与推荐强度徽章,最后给出首选建议。3) 追问阶段:用户选定候选后,用 /grilling 技能走决策树,讨论约束、依赖、深化模块形态、接缝背后内容与测试存留;决策成形时用 /domain-modeling 同步更新 CONTEXT.md,必要时提议记录 ADR。

使用方式:作为技能/命令调用,可指定方向(模块、子系统或痛点),否则回看 git log --oneline 找热点。报告生成后按平台打开:Linux 用 xdg-open <path>,macOS 用 open <path>,Windows 用 start <path>。

适用场景:需要识别架构重构机会、提升模块深度与可测试性、让代码库更利于 AI 导航的工程团队。

限制:报告阶段不提出具体接口;与现有 ADR 冲突时仅在摩擦足够真实时标注;未提供收费、平台支持范围等事实。