名称: 代码修改生成器 描述: 生成自动化代码迁移脚本（代码修改） 允许使用的工具:
- 读取
- 写入
- 编辑
- 全局匹配
- 文本搜索
- Bash命令
代码修改生成器技能
概述
此技能生成自动化代码迁移脚本（代码修改），用于将用户代码转换为使用新的API版本，从而减轻开发者在SDK升级过程中的负担。
能力
- 创建基于抽象语法树（AST）的代码转换
- 支持多种语言（JavaScript, TypeScript, Python, Go）
- 提供带有变更预览的试运行模式
- 实现安全的回滚机制
- 生成详细的迁移报告
- 处理边缘情况和部分迁移
- 支持交互式迁移模式
- 通过测试验证转换
目标流程
- 向后兼容性管理
- 软件包分发
- SDK版本管理与发布管理
集成点
- 用于JavaScript/TypeScript的jscodeshift
- 用于Python的libcst
- 用于Go的go-codemod
- 用于PHP的Rector
- 自定义AST转换器
输入要求
- 源API版本和目标API版本
- 转换规则规范
- 用于验证的测试用例
- 边缘情况处理要求
- 回滚策略
输出产物
- 每种语言的代码修改脚本
- 试运行报告
- 迁移验证测试
- 边缘情况文档
- 用于执行的CLI包装器
- 回滚脚本
使用示例
技能:
名称: 代码修改生成器
上下文:
源版本: "1.x"
目标版本: "2.0"
语言:
- typescript
- python
转换:
- 类型: 方法重命名
从: oldMethod
到: newMethod
- 类型: 参数变更
方法: createResource
变更:
- 名称: config
包装: options
试运行: true
生成测试: true
最佳实践
- 始终首先提供试运行模式
- 生成全面的变更报告
- 优雅地处理部分迁移
- 包含回滚能力
- 在真实代码库上测试代码修改
- 记录需要手动干预的情况