SuperAPI AI 工具集

jscodeshift

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:该技能是面向 AI 代理和 LLM 的 jscodeshift codemod 开发最佳实践指南,适用于编写代码迁移用的新 codemod、调试转换失败或异常行为、优化大型代码库上的 codemod 性能、审查 codemod 代码正确性,以及测试边界情况与回归。

主要能力:资料称包含 40 条规则,分为 8 个类别并按影响程度排序。1 解析器配置(CRITICAL,parser-):为 TypeScript 文件选用正确解析器、Flow 代码用 Flow 解析器、避免现代语法使用默认 babel5compat、从转换模块导出解析器、AST Explorer 解析器与 jscodeshift 保持一致。2 AST 遍历(CRITICAL,traverse-):find() 使用具体节点类型、复杂转换用两遍模式、无需转换时提前返回、用 find() 加过滤对象替代 filter() 链、用 closestScope() 做作用域感知转换、避免对同一节点类型重复 find()。3 节点过滤(HIGH,filter-):转换前检查父路径、跟踪 import 绑定、属性访问前加空值检查、区分 JSX 与普通 JavaScript、处理计算属性键。4 AST 转换(HIGH,transform-):用 builder API 创建节点、replaceWith 回调、在正确位置插入 import、保留注释、renameTo 重命名变量、移除未使用 import。5 代码生成(MEDIUM,codegen-):配置 toSource()、用 recast 保留原风格、复杂节点用模板字面量、设置打印宽度。6 测试(MEDIUM,test-):defineInlineTest 验证输入输出、先写负向用例、dry run 探索代码库、复杂用例用 fixture 文件、测试解析错误处理。7 运行器优化(LOW-MEDIUM,runner-):配置并行 worker 数、用忽略模式跳过非源文件、按扩展名过滤、分批处理大代码库、verbose 输出调试。8 高级模式(LOW):组合多个转换为管线、作用域分析、跨文件共享状态、自定义集合方法。

使用方式:阅读各参考文件获取详细说明与代码示例;单份完整文档见 AGENTS.md。

限制:资料未提供安装命令、运行方式、价格或平台支持信息。