python-rope-refactor
一个引导AI使用Rope库进行Python代码机械重构的CLI工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：python-rope-refactor。 它的用途是：一个引导AI使用Rope库进行Python代码机械重构的CLI工具 完整的 Skill 内容见：https://321skill.com/skills/python-rope-refactor/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我把项目里的`UserService`类改名为`AccountService`，并更新所有引用。”，它会调用此Skill的`rename-symbol`命令，先进行模拟运行展示所有将被修改的文件和位置，等你确认后再实际执行重命名和引用更新。
介绍
这个Skill旨在解决开发者在进行Python代码重构时，手动修改符号名、移动模块、更新引用等机械性操作耗时且易错的问题。它通过一个包装脚本，引导AI优先使用成熟的Rope库来执行这些重构任务，确保修改的准确性和一致性。
使用时，开发者需要将Skill文件复制到Codex的技能目录中。当AI需要执行Python重构任务时，它会自动调用此Skill，并遵循一个安全的工作流：先进行模拟运行并展示差异，待用户确认后再实际应用更改。
它非常适合那些需要频繁重构Python代码库的开发者，尤其是全栈开发、后端开发和智能体开发者，他们经常需要调整代码结构以适应新的需求或设计模式。
建议在重构前确保项目有版本控制（如Git），以便随时回滚。由于Rope无法处理动态引用，对于使用了importlib或配置字符串等动态导入的项目，需要额外手动检查。
核心特点
与直接让AI生成重构代码不同，此Skill强制AI调用经过验证的Rope库，通过“模拟运行->人工审核->应用”的安全流程，极大降低了自动化重构的风险。它专注于将AI的意图转化为可靠的工具调用，而非依赖AI直接生成可能出错的修改代码。
注意事项
不适合处理动态或字符串形式的代码引用（如`importlib.import_module`），且重构范围受限于Rope的扫描精度。
常见问题
这个Skill能保证重构100%正确吗？
不能，它依赖Rope库，对于动态引用可能失效，必须人工审核差异并运行测试。
必须安装uv吗？
是的，这是脚本运行的前提，用于管理Python依赖和环境。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/python-rope-refactor/raw/index.md 读取 python-rope-refactor 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/python-rope-refactor/raw/index.md（查看排版版本）