SuperAPI AI 工具集

gitnexus-refactoring

编程与开发

查看项目

更新于 10-16 01:16

技能介绍

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

主要能力:提供 rename、impact、detect_changes、context、query、cypher 等工具。rename 支持多文件自动重命名,先以 dry_run 预览所有编辑,区分图谱编辑(高置信度)与 ast_search 编辑(需人工复核);impact 按 upstream 方向映射所有依赖方与受影响流程;detect_changes 在重构后核对改动文件、符号与受影响流程及风险等级;cypher 可自定义引用查询。

使用方式:典型流程为先 impact 映射依赖,再 query 查找执行流,再 context 查看进出引用,然后按“接口→实现→调用方→测试”的顺序规划更新。重命名示例:rename({symbol_name: "validateUser", new_name: "authenticateUser", dry_run: true}) 预览,确认后设 dry_run: false 应用,最后 detect_changes({scope: "all"}) 验证并运行受影响流程的测试。若提示“Index is stale”,在终端运行 node .gitnexus/run.cjs analyze。

适用场景:重命名符号、提取模块、拆分函数或服务等需要跨文件安全改动的重构任务。

限制与风险:调用方多(>5)时建议用 rename 自动更新;跨区域引用需用 detect_changes 核对范围;字符串或动态引用需用 query 查找;外部或公开 API 应做好版本与弃用处理。ast_search 编辑需仔细复核,例如配置中的动态引用。具体平台支持、收费与价格信息暂未提供。