JetBrains IDE Skill

适用于 JetBrains IDE 的 Claude Code 只读协作技能，支持 IntelliJ IDEA、WebStorm 和 Android Studio。

通过 JetBrains IDE MCP 读工具进行代码搜索、文件读取、静态问题检查、符号与 PSI 分析、项目浏览以及数据库元数据查看。运行时不修改项目文件，不执行构建、任意 SQL 或脚本，也不改变 IDE 编辑器状态。

安装

npx skills add shaco/jetbrains-skills

子智能体（Sub-agent）支持

Claude Code 的子智能体不会自动继承主智能体的 skill。如需在子智能体中使用 JetBrains IDE MCP 只读工具，将 agents/ 目录下的 agent 配置文件复制到对应位置：

# 用户级（所有项目生效）
cp agents/*.md ~/.claude/agents/

# 或项目级（仅当前项目生效）
cp agents/*.md .claude/agents/

上述命令属于 skill 安装和 agent 配置部署，不属于 JetBrains MCP 运行时操作。安装完成后，两个 agent 仍然只能使用只读能力。

安装后，Agent 工具可以使用以下自定义 agent 类型：

Agent 类型	对应内置类型	用途
jetbrains-code-search	Explore	只读代码搜索、定位和代码理解
jetbrains-general	general-purpose	复杂多文件只读分析与诊断

在 prompt 中指定 subagent_type：

subagent_type: "jetbrains-code-search"
subagent_type: "jetbrains-general"

也可以在生成子智能体时直接要求使用 JetBrains IDE MCP 只读工具，无需安装 agent 配置。详见 SKILL.md。

支持的 IDE

IDE	MCP 服务器名
IntelliJ IDEA	idea
WebStorm	webStorm
Android Studio	androidStudio

只读运行时边界

skill 正常运行时只允许搜索、读取和静态分析。以下工具不会被调用：

• replace_text_in_file
• rename_refactoring
• create_new_file
• reformat_file
• build_project
• open_file_in_editor
• test_database_connection
• execute_sql_query
• cancel_query
• run_inspection_kts

如果用户要求修改代码，skill 只负责定位相关文件、分析影响并给出建议，不使用 JetBrains MCP 执行修改。MCP 未连接时会停止执行并提示用户连接对应服务器，不使用通用工具替代。

使用

显式初始化项目

首次使用时，可以显式初始化项目并写入只读配置：

/jetbrains:init

或直接说“初始化 jetbrains”“配置 jetbrains 项目”。init 会：

1. 检测当前连接的 JetBrains IDE MCP 服务器，或让用户选择 IDE。
2. 在 CLAUDE.md 中写入 jetbrains-ide: <值> 声明。
3. 写入“只允许使用 JetBrains IDE MCP 读工具”的协作规则。

init 是用户主动触发的安装/项目配置步骤，是唯一允许更新 CLAUDE.md 的配置例外。普通 skill 运行不会自动创建或修改 CLAUDE.md。

手动配置

1. 在 JetBrains IDE 中配置 MCP 工具连接，参考官方文档：JetBrains MCP Server。
2. 在项目 CLAUDE.md 中声明 IDE 类型，例如 jetbrains-ide: idea。
3. 确保对应 IDE 的 MCP 插件已启动并连接。
4. 在 Claude Code 中正常使用；skill 会匹配对应 IDE 的只读工具。

功能

• 代码搜索与定位：符号、文本、正则、文件名和 glob。
• 文件与目录读取：源码范围、缩进代码块、Jar 类、目录树和当前已打开文件列表。
• 静态问题检查：通过 IntelliJ Inspection 获取文件错误和警告，不执行构建。
• 代码理解：符号签名、类型、文档和 PSI 树分析。
• 项目浏览：模块、依赖和 VCS 仓库信息。
• 数据库只读查看：连接、Schema、对象结构和明确请求下的有限表数据预览。
• Inspection KTS API 文档和示例模板读取（仅 IDEA），不执行脚本。

完整工具边界和示例见 SKILL.md。