SuperAPI AI 工具集

improve-codebase-architecture

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:审查代码库中的架构摩擦,按“深模块”(小接口隐藏大量实现复杂度)标准排序重构机会,并为选定候选起草 RFC,规划更安全的接口与边界测试策略。

主要能力:识别跨文件跳转、冗余适配器、浅模块、隐藏编排、保护内部实现而非行为的测试等摩擦证据;给出 3-5 个候选深化机会,每个包含 Cluster、耦合原因、依赖类别、测试影响、预期杠杆、迁移成本/风险、置信度;为选定候选设计 2-4 个实质不同的接口方案并比较推荐;按模板产出 Markdown RFC。

使用方式:先确定范围(用户给定路径、子系统、工单或主题则限定其中,否则先探索定位高摩擦区域);探索代码库,有子代理时可并行一轮探索与 2-4 轮设计,无子代理则顺序执行;分类依赖、判断测试策略或起草 RFC 前需阅读 $SKILL_DIR/references/deepening-guide.md,可参考 $SKILL_DIR/references/example-rfc.md 了解结构。RFC 默认保存到 .plannings/architecture-rfc-<candidate-slug>.md,目录不存在则创建;写入其他位置前需询问用户,不要默认写到仓库根目录。仅当用户明确要求、gh 已安装并认证、草稿已完成时,才创建 GitHub 议题;任一条件不满足时返回完整 Markdown 草稿、可直接粘贴的议题正文与建议的 gh issue create 命令。

适用场景:代码库架构评审、重构机会排序、接口设计与 RFC 起草、边界测试策略规划。

限制:若候选不够强需明确说明并停止,不得为满足流程而编造 RFC;依赖分类不确定时需指出不确定性与缺失证据;代码库过大时先缩小范围;默认不修改远程系统,先起草后发布。具体命令与模板细节以技能目录内参考文件为准。