技能介绍

问题在哪

在 IDE 里改代码时，代理若默认用 grep、sed、mv 做「查找引用、跳转定义、重命名、挪文件」，本质上只是在匹配字符串。别名 import、泛型解析、override 关系、间接调用链都会被漏掉或误伤；重命名还可能留下半套 getter/setter 与测试引用。

技能在做什么

本技能是一份 IDE Index MCP 使用准则：凡涉及语义级代码理解的操作，应优先走 JetBrains 索引 MCP，而不是内置文本工具。

核心对照可以概括为：

引用与定义：用 ide_find_references、ide_find_definition，不用 grep 冒充「全项目用法」
重构：用 ide_refactor_rename、ide_move_file、ide_refactor_safe_delete，避免 sed 与裸 mv/git mv
结构分析：用 ide_type_hierarchy、ide_call_hierarchy、ide_find_implementations 看继承、调用链与接口实现
质量：用 ide_diagnostics 看编译错误与警告

实操上还有几条硬规则：行号列号 1-based；工程内路径用相对路径；列号要落在符号名上；多模块工作区才传 project_path。若在 IDE 外用 Write/Edit 改过文件，搜索前应先 ide_sync_files。需要 smart mode 的工具在索引未完成时会失败，可先查 ide_index_status。

边界与注意

ide_search_text 只做整词检索，正则仍用 Grep；读普通源码优先用内置 Read，ide_read_file 更适合库/jar 源。ide_find_class 只搜类名，别拿来找方法。部分工具（如 ide_reformat_code、ide_read_file）默认关闭，需在 IDE 设置里启用 Index MCP Server。

截图预览

使用场景

在 IntelliJ 中让代理把某个 public 方法全项目重命名，需用 `ide_refactor_rename` 更新 override 与引用，而不是 sed 批量替换。
准备下线某 deprecated API 时，从该方法出发用 `ide_call_hierarchy`（callers）向上梳理谁还在调用。
改接口或抽象类方法签名前，用 `ide_find_implementations` 列出所有实现类与实现方法，评估改动面。
代理通过 Write/Edit 在 IDE 外新增或改文件后，搜索引用不全时先 `ide_sync_files`，再重试 `ide_find_references`。