SuperAPI AI 工具集

improve-codebase-architecture

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:扫描代码库,找出架构摩擦点,提出把浅模块深化为深模块的重构机会,目标是提升可测试性与 AI 可导航性。该命令结合项目领域模型与共享设计词汇进行工作。

主要能力与流程:

  1. 探索:先确定范围(YAGNI),优先关注近期变更的代码;可用 git log --oneline 回溯提交历史定位热点,先阅读 CONTEXT.md 与 docs/adr/ 下的 ADR,再启动子代理有机地遍历代码库,寻找理解一个概念需在多个小模块间跳转、模块接口与实现复杂度相当、纯函数仅为可测试性而抽出、紧耦合模块跨接缝泄漏、难以通过现有接口测试等信号,并对可疑浅模块做删除测试。
  2. 以 HTML 报告呈现候选:在系统临时目录写入自包含 HTML 文件,路径形如 <tmpdir>/architecture-review-<timestamp>.html($TMPDIR,回退 /tmp 或 Windows 的 %TEMP%),并用 xdg-open/open/start 打开并告知绝对路径。报告通过 CDN 使用 Tailwind 布局、Mermaid 绘制图形,也可手工 CSS/SVG 视觉。每个候选卡片含:涉及文件、问题、解决方案、以局部性与杠杆解释的收益、前后对比图、推荐强度(Strong/Worth exploring/Speculative)。结尾给出 Top recommendation。冲突 ADR 需标注但不逐条列出。
  3. 问答循环:用户选定候选后,调用 grilling 技能走决策树;随决策推进可用 domain-modeling 更新领域模型(如向 CONTEXT.md 添加术语、当场修正模糊术语、按需提供 ADR 建议);如需探索替代接口可调用 codebase-design 及其并行子代理模式。

使用方式:该命令通过 Skill 工具调用 codebase-design 获取架构词汇(模块、接口、深度、接缝、适配器、杠杆、局部性)及其原则,并要求在建议中精确使用这些术语。

适用场景:需要发现并评估架构重构机会、提升代码可测试性与 AI 可导航性的项目。

限制:资料未提供具体的安装命令、价格、收费、平台支持或效果数据,暂未提供。使用依赖 CONTEXT.md 与 ADR 等已有项目资料。