SuperAPI AI 工具集

gitnexus-refactoring

编程与开发

查看项目

更新于 10-15 18:31

技能介绍

用途:当用户要安全地重命名、提取、拆分、移动或重构代码时使用,例如“安全重命名这个函数”“把这个提取成模块”“拆分这个服务”“把它移到新文件”。

主要能力:通过代码图谱与查询工具支持自动化多文件重命名、影响面分析、改动检测与自定义引用查询。核心工具包括 gitnexus_rename(多文件自动重命名)、gitnexus_impact(先映射所有依赖者)、gitnexus_detect_changes(重构后校验改动)、gitnexus_cypher(自定义引用查询)。

使用方式:重构前先执行 gitnexus_impact({target: "X", direction: "upstream"}) 映射依赖,再用 gitnexus_query({query: "X"}) 查找执行流,用 gitnexus_context({name: "X"}) 查看全部出入引用;随后规划更新顺序为接口→实现→调用方→测试。重命名可先 dry_run: true 预览所有编辑,区分图谱编辑(高置信度)与 ast_search 编辑(需人工复核),确认后以 dry_run: false 应用,再用 gitnexus_detect_changes() 校验只有预期文件被修改,并运行受影响流程的测试。若提示“Index is stale”,在终端运行 npx gitnexus analyze。

提取模块:先用 context 查看出入引用,用 impact 找外部调用者,定义新模块接口,提取代码并更新导入,再 detect_changes 校验并跑测试。拆分函数/服务:先用 context 理解所有被调用者,按职责分组,用 impact 映射需更新的调用者,创建新函数/服务、更新调用者,最后校验并跑测试。

风险规则:调用者多(>5)时用 gitnexus_rename 自动更新;跨区域引用时用 detect_changes 校验范围;字符串/动态引用用 gitnexus_query 查找;外部/公共 API 需做好版本管理与弃用。

限制:资料未提供具体平台支持、收费或价格信息。