intellij-plugin-builder

titonio 的头像作者 titonio

使用 Gradle 和 Kotlin/Java 创建 IntelliJ Platform 插件的指南。当用户想要创建、配置或开发 IntelliJ IDEA 或其他 JetBrains IDE 的插件时使用。

📖 中文导读:使用 Gradle 和 Kotlin/Java 创建 IntelliJ Platform 插件的指南。当用户想要创建、配置或开发 IntelliJ IDEA 或其他 JetBrains IDE 的插件时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: intellij-plugin-builder description: Guide for creating IntelliJ Platform plugins using Gradle and Kotlin/Java. Use when users want to create, configure, or develop plugins for IntelliJ IDEA or other JetBrains IDEs.

IntelliJ Plugin Builder

Overview

This skill provides templates, best practices, and reference documentation for building IntelliJ Platform plugins. It covers project setup, core components (Actions, Services, Listeners), and configuration using the IntelliJ Platform Gradle Plugin (2.x).

It includes the full official IntelliJ SDK documentation for offline reference.

Workflow

1. Project Setup

Use the provided initialization script to scaffold a new project with the correct structure and configuration.

python3 .claude/skills/intellij-plugin-builder/scripts/init_project.py "MyPlugin" "com.example.myplugin"

This will create:

  • A standard Gradle project structure (src/main/kotlin, src/main/resources).
  • build.gradle.kts configured with the IntelliJ Platform Gradle Plugin (2.x).
  • plugin.xml with your ID and name.
  • gradle.properties and .gitignore.

2. Core Development

Refer to references/plugin_structure.md for details on:

  • Actions: Creating menu items and toolbar buttons.
  • Services: Managing state and logic.
  • Listeners: Reacting to IDE events.
  • Extensions: Integrating with the IDE (Tool Windows, Inspections, etc.).

3. Common Tasks & Tutorials

The skill includes the full IntelliJ SDK documentation. Here are quick links to common tasks:

  • Creating Actions: references/intellij-sdk-docs/topics/tutorials/actions_tutorial.md
  • Tool Windows: references/intellij-sdk-docs/topics/basics/plugin_structure/plugin_tool_windows.md
  • Inspections: references/intellij-sdk-docs/topics/tutorials/code_inspections.md
  • Listeners: references/intellij-sdk-docs/topics/basics/plugin_structure/plugin_listeners.md
  • Services: references/intellij-sdk-docs/topics/basics/plugin_structure/plugin_services.md
  • Settings/Config: references/intellij-sdk-docs/topics/tutorials/settings_tutorial.md

4. Building and Running

  • Run ./gradlew runIde to start a sandbox IDE instance with your plugin installed.
  • Run ./gradlew buildPlugin to package the plugin for distribution.
  • Run ./gradlew test to run unit tests (JUnit 5 configured).

Resources

scripts/

  • init_project.py: Scaffolds a complete IntelliJ Plugin project structure.
  • add_action.py: Interactive script to scaffold a new Action class (Kotlin) and generate the XML registration snippet.

references/

  • plugin_structure.md: Detailed guide on project structure, key components (Actions, Services, Listeners), and Gradle configuration.
  • intellij-sdk-docs/: Full clone of the official IntelliJ SDK documentation.
    • topics/basics/: Core concepts and architecture.
    • topics/reference_guide/: API reference and specific features.
    • topics/tutorials/: Step-by-step guides.

assets/

  • build.gradle.kts: A complete Gradle build script template configured for IntelliJ Plugin development (v2.x) with JUnit 5.
  • plugin.xml: A template for the plugin configuration file.
  • settings.gradle.kts: Gradle settings template.
  • gradle.properties: Standard properties for JVM and plugin versions.
  • .gitignore: Standard git ignore file for IntelliJ/Gradle projects.