SuperAPI AI 工具集

refactor

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:发现代码库中的结构性摩擦,提出深层模块(deep module)重构方向,并生成项目本地 RFC。若主要问题是可复用 UI 组件编目、共享 UI 包使用或设计系统组件提取,则超出本技能范围;若主要问题是代码库整体健康、安全、性能或测试覆盖,应改用 /arc:audit。

主要能力:扫描并分类候选问题,类型包括 god-component、god-page-client、god-script、god-module、duplication、shallow-module、package-extraction。对 JS/TS 项目可运行 Arc 自带扫描器:python3 "$ARC_ROOT/scripts/find-god-files.py" . --max-files 40 与 python3 "$ARC_ROOT/scripts/codebase-map.py" . --format markdown。

使用方式:先读取项目上下文(CONTEXT.md、CONTEXT-MAP.md、docs/adr/、最近的 docs/arc/audits/*-audit.md)及指定参考文档;用 Explore 子代理探索代码;列出候选并让用户选择;通过逐问式 grilling 澄清概念与接口边界;再并行生成 3 个以上竞争性接口方案(最小接口、最大灵活性、最常见调用者优化,必要时端口与适配器)。

限制:需完整 Arc bundle,路径从插件根解析;禁用 EnterPlanMode/ExitPlanMode;不创建外部跟踪器 issue,除非用户明确要求;用户未明确要求实现时只停留在计划;不得把安全边界(输入校验、错误处理、授权、转义、可访问性)当作重复代码合并掉;删除或合并前需确认原始意图,否则标记低置信度。无人值守运行时按文档默认值执行并在 RFC 中标注未确认。