SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 11-07 16:46

技能介绍

用途\n该技能旨在发现代码库中的架构摩擦,并提出“深化机会”:通过重构把浅模块变成深模块,目标是提升可测试性与 AI 可导航性。它基于项目领域模型和一套共享设计词汇来工作,强调用词准确,避免在建议中漂移为“组件”“服务”“API”或“边界”等泛化说法。\n\n主要能力\n- 探索代码库:先确定范围再扫描,遵循 YAGNI 原则;若用户指定方向(模块、子系统、痛点),优先采用;否则通过 git log --oneline 回溯提交历史寻找热点,再按热点路径扩大排查。\n- 依据领域词汇与 ADR:先阅读 GLOSSARY.md 与相关 ADR,避免重新争论已有决策。\n- 子代理探索:以全新上下文窗口遍历代码,关注概念理解需在多个小模块间跳转、模块接口复杂度接近实现、为测试而抽取纯函数但真实缺陷藏在调用方式中、紧耦合模块跨缝泄漏、以及未测试或难以通过现有接口测试的部分。\n- 删除测试:对疑似浅模块提问——删除它会集中复杂度,还是仅仅移动复杂度?后者才是值得关注的信号。\n- 生成 HTML 报告:写入系统临时目录(依据 $TMPDIR,回退 /tmp 或 Windows 的 %TEMP%),文件名为 architecture-review-<timestamp>.html,并用对应平台命令打开并告知绝对路径。报告使用 Tailwind CDN 与 Mermaid CDN,图形式关系用 Mermaid,编辑性视觉用手写 CSS/SVG;每个候选有前后对比图。\n- 候选卡片包含:涉及文件/模块、问题、解决方案、以局部性与杠杆解释的收益及测试改善、前后并排图、推荐强度(Strong、Worth exploring、Speculative)。报告结尾给出 Top recommendation。\n- ADR 冲突处理:仅当摩擦足够真实值得重审时,才在卡片中明确标注与某 ADR 冲突及原因。\n- 推演循环:用户选定候选后,调用 grilling 技能沿决策树推演约束、依赖、深化模块形态、缝后内容、可存活测试;可调用 codebase-design 的 design-it-twice 并行子代理模式探索替代接口。\n- 领域模型同步:命名新概念时补充 GLOSSARY.md(可惰性创建),模糊术语当场更新;用户以关键理由拒绝候选时,可提议记录为 ADR,仅当该理由对未来探索者避免重复建议确有必要时。\n\n使用方式\n以技能/命令形式调用,先确定方向或依据提交历史确定热点,然后阅读领域词汇与 ADR,派生子代理探索并应用删除测试,生成并打开 HTML 报告,询问用户想探索哪个候选,选定后进入 grilling 循环并按需更新领域模型。\n\n适用场景\n适合对代码库做架构审视、识别可深化模块、评估重构方向与测试可改进点,尤其适合近期频繁变更的区域。\n\n限制\n报告阶段不提出接口;HTML 报告写入临时目录而非仓库;平台打开命令分别为 xdg-open、open、start;依赖 GLOSSARY.md 与 ADR 等资料,缺失时按流程惰性处理。其他收费、平台与效果信息暂未提供。