mcpField
J
jetbrains-skill

jetbrains-skill

github.com/ry-run開発12104 回インストール29 週間前に更新
リポジトリ

jetbrains-skill について

外部クライアントから JetBrains IDE の機能をツールとして使うスキルです。MCP の設定、コード解析、リファクタリング、プロジェクトファイル操作、安全制約を伴う実行設定を扱います。

主な機能

  1. 01クライアント向け MCP サーバー設定
  2. 02IDE の診断とシンボル情報
  3. 03インデックス検索
  4. 04ファイル編集とフォーマット
  5. 05実行設定とターミナルコマンド

活用シーン

  1. 01IDE 診断結果の調査
  2. 02プロジェクト全体でのシンボル名変更
  3. 03インデックス済みファイルの検索
  4. 04実行設定やコマンドの実行

MCP 対応

JetBrains IDE は MCP サーバーを提供し、外部クライアントは自動設定または手動でコピーした SSE / Stdio 設定を使って接続できます。このスキルでは接続設定と IDE ツールの利用方法を説明します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ry-run/run-skills --skill jetbrains-skill

インストール後、Claude Code で/jetbrains-skillを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

SKILL_zh.md
agents/
openai.yaml
references/
jetbrains-skill_zh.md
jetbrains-skill.md

詳細

JetBrains Skill

クイックスタート

目標：IDE の機能（インデックス、インスペクション、リファクタリング、実行構成、統合ターミナル）を外部クライアントのツールとして使用しながら、変更を監査可能かつ安全な状態に保ちます。

メモとツール一覧（要約）：skills/jetbrains-skill/references/jetbrains-skill.md。

接続とモード

クライアントのセットアップ（IDE で実施）
  • Settings → Tools → MCP Server
  • MCP Server を有効にします
  • 対応クライアントでは「Auto-configure」を使用して JSON 設定を更新するか、SSE / Stdio の設定をコピーして手動でセットアップします
  • 変更を反映するため、外部クライアントを再起動します
Brave Mode（確認なし）

IDE では、操作ごとの確認なしにシェルコマンドや実行構成を実行できるようにすることができます（「Brave mode」）。 これにより自動化の能力が高まる一方、リスクも増します。有効化または無効化する前に、必ずユーザーの明示的な確認を得てください。

ワークフローの判断ツリー

  1. IDE レベルの解析やリファクタリングが必要ですか？
  • ファイルの診断：get_file_problems
  • シンボルのセマンティクスやドキュメント：get_symbol_info
  • プロジェクト全体で安全に名前を変更：rename_refactoring（単純なテキスト置換より優先）
  • インデックス検索：search_in_files_by_text / search_in_files_by_regex
  • ファイルを検索：find_files_by_name_keyword（高速、名前のみ）または find_files_by_glob（パスの glob）
  1. プロジェクト内のファイル操作だけが必要ですか？
  • ファイルのテキストを読み取る：get_file_text_by_path
  • ファイルを作成する：create_new_file
  • 対象を絞って置換する：replace_text_in_file（自動保存）
  • エディターで開く：open_file_in_editor
  • 再フォーマットする：reformat_file
  1. 何かを実行する必要がありますか？
  • 実行構成を一覧表示する：get_run_configurations
  • 構成を実行する（完了まで待機）：execute_run_configuration
  • IDE でターミナルコマンドを実行する：execute_terminal_command（確認が必要な場合があります。出力には上限があります）

制約（よくある間違いを避ける）

  • 曖昧さを避けるため、判明している場合は必ず projectPath を渡してください。
  • 多くのツールではプロジェクトルートからの相対パスが必要で、プロジェクト内のファイルのみを操作します。
  • 位置を指定するツールでの行番号と列番号は 1 始まりです。
  • maxLinesCount と truncateMode を使って出力を制御してください。大きな出力でデフォルト設定に頼らないでください。
  • ターミナルコマンドや実行構成の実行には高いリスクが伴います。破壊的な可能性のあるコマンドを実行する前に、必ず明示的な確認を得てください。Brave Mode では安全策がなくなります。

おすすめの有用なパターン

まずインスペクションでデバッグする
  1. get_file_problems でエラーや警告を見つける → 2) get_symbol_info でコードを理解する → 3) rename_refactoring で名前を変更する → 4) 本当にテキスト上の変更だけの場合に限り replace_text_in_file を使う。
大規模な検索にはインデックス検索を使う

IDE の検索とインデックスを使用し、一致箇所を || で強調表示する search_in_files_by_text / search_in_files_by_regex を優先してください。

実行と出力の制御

妥当な timeout（ms）を設定して execute_run_configuration を使います。ターミナルコマンドには execute_terminal_command を使いますが、出力には上限があることに注意してください。出力が非常に大きい場合は、ファイルにリダイレクトし、ファイルツールで読み取ってください。

参考資料

  • メモとツール一覧（要約）：skills/jetbrains-skill/references/jetbrains-skill.md

コメント

Markdown 対応