SuperAPI AI 工具集

architecture-audit

编程与开发

查看项目

更新于 10-16 05:50

技能介绍

用途:审计代码库中的架构摩擦,识别浅模块、耦合与难测区域,并提出朝深模块(接口简单、实现庞大)方向的重构建议。深模块更易测试、可让测试落在接缝而非实现内部,也更利于 AI 导航。

主要能力:使用深模块术语体系(module、interface、depth、seam、adapter、leverage、locality)及核心原则(deletion test、interface-as-test-surface、one-adapter-is-hypothetical),在建议中严格使用这些术语。可按 references/deep-modules.md 中的反模式(pass-through、temporal decomposition、classitis、模块过浅迹象)识别问题。

使用方式:

  1. 探索:先定范围(YAGNI),有 $ARGUMENTS 方向则采用;否则读 git log --oneline 找热点,再结合 ADR 排查。可用 Agent 工具 subagent_type=Explore 有机导航代码库,记录卡点。
  2. 列出候选:编号列表,含集群、耦合原因、依赖类别、测试影响、强度(Strong/Worth exploring/Speculative)。加 --html 可渲染前后对比图报告。此阶段不设计接口,需询问用户选哪个候选。用户有充分理由拒绝时,可调用 Skill 工具 with to-adr 记录,避免后续重复建议。
  3. 设计接口:对选定候选执行 Design-It-Twice 流程,生成 3 个以上不同约束的子代理方案,比较并推荐,询问采用哪个。
  4. 写改进 PRD:按 references/improvement-template.md 生成 architecture-<cluster-name>.md,存入 .specs/specs/(目录不存在则创建),内容含具体文件路径、函数名与迁移步骤,完成后告知用户路径。

限制与规则:浅模块上的旧单元测试在接缝测试出现后应标记删除;没有实际变化就不要引入新接缝(一个适配器只是假设,两个才算真实);若候选范围远大于预期,应先反映并重新定范围再设计。后续可用 /hb:to-tickets architecture-<cluster-name> 切分改进 PRD。官方资讯未提供收费、平台等更多信息。