Claude Code IdeaVim 扩展迁移技能:从 VimExtensionFacade 改用 VimApi
EnglishClaude Code 安装步骤
- 打开固定版本的仓库工作副本,确认 `.claude/skills/extensions-api-migration/SKILL.md` 存在。
- 从仓库根目录启动 Claude Code,输入 `/extensions-api-migration` 并描述要处理的改动与验证目标。
中文摘要
把 IdeaVim 扩展的旧处理器分步迁移到 VimApi 和注解式插件接口。先用原测试固定行为,再逐个迁移处理器及其映射注册。
SKILL.md 中文导读
可复现示例
用虚构的 IdeaVim 扩展处理器做演练。现有映射在代码窗口选中当前段落,旧实现通过 VimExtensionFacade 访问。只迁移此处理器,保留键位和选区结果。工作步骤
- 迁移前先核对目标处理器的测试覆盖,并记录旧映射的行为。
- 先在一个处理器中提取 VimApi 接收者函数,再迁移调用与映射,每个步骤运行针对该扩展的测试。
验收方法
检查应能区分函数提取、VimApi 调用替换和映射注册三个步骤。每步保留同一键位与选区断言,测试结果由本地运行确认。
GitHub 原文 · 更新日期
适用环境
需要 Claude Code 和固定版本的 IdeaVim 工作副本。需可读取 `api/` 模块、目标扩展及对应测试,运行测试时准备项目 Gradle 环境。
常见问题
已有多个扩展处理器时如何控制迁移范围?
先选择一个有测试的处理器,迁移并验证后再做下一处。这样可以定位哪一步改变了 Vim 行为。