agentleFS
naoyukiknaoyukik/agent-skills/skills/operating-jetbrains-projects/SKILL.md

operating-jetbrains-projects

Skill1 starsChanged 49 days agoMITView on GitHub

Operates JetBrains IDEs (IntelliJ, etc.) via MCP. Supports project exploration, code reading, structural refactoring, and execution/verification using full IDE capabilities for efficient development.

  • Deletes or force-pushes

The file

Files
SKILL.md

鉄則(Absolute Principles)

  1. プロジェクトパスの明示: すべての呼び出しで projectPath をフルパスで指定せよ。
  2. 推測より確認: ファイル構造やシンボル情報は必ず list_directory_tree や get_symbol_info で裏付けを取れ。
  3. 精密な外科手術: 編集は replace_text_in_file で最小限の差分のみを適用せよ。
  4. 構造的整合性: 名前変更には必ず rename_refactoring を用い、テキスト置換を避けよ。
  5. 高度な読み取り: 巨大なファイルでは read_file の slice や lines モード、または indentation モードを使い、必要な部分だけを効率的に読み取れ。
  6. execute_terminal_command: 基本的に使用しない。run_shell_command でどうしても実行できない場合のみ、ユーザーに確認を取ってから使用すること。

ツール・カタログ(Toolbox Reference)

1. 探索とナビゲーション(Exploration & Navigation)

大規模プロジェクトの全容を迅速に把握するための手段です。

ツール名用途備考
list_directory_treeプロジェクト構造の俯瞰maxDepth を指定して使用
get_repositoriesVCS ルートの取得マルチリポジトリ構成の把握に便利
find_files_by_name_keywordファイル名による特定インデックスによる高速検索
find_files_by_glob / search_fileパターンでのファイル検索特定の拡張子やディレクトリの絞り込み
search_text / search_regex文字列・パターンによる一括検索推奨: スニペットと座標(1-based)を返す
search_symbolシンボル(クラス・メソッド・フィールド)検索識別子断片によるセマンティックな検索
get_all_open_file_paths現在開いているエディタの把握作業中の文脈を素早く理解するために有用

2. 読解と分析(Reading & Understanding)

コードの意味と依存関係を正確に理解するための手段です。

ツール名用途備考
get_file_text_by_pathファイル内容の読み込み(全文)比較的小さなファイルや全文把握に
read_file高度なファイル読み取りslice, lines, indentation モードを使い分け
open_file_in_editorエディタで指定ファイルを開くユーザーへの提示やエディタ操作の連動に
get_symbol_info型情報・定義・参照の取得IDEのクイックドキュメントと同等の正確な情報
get_project_dependencies外部ライブラリ等の依存関係確認プロジェクト構成の理解
get_project_modulesモジュール構成の把握多階層プロジェクトの分析

3. 編集とリファクタリング(Editing & Refactoring)

安全性と整合性を保ちながらコードを修正するための手段です。

ツール名用途備考
replace_text_in_fileテキストの部分置換最優先ツール。一意な oldText を指定
create_new_file新規ファイルの作成overwrite フラグに注意
rename_refactoringシンボルの名前変更変数・クラス・関数の改名に必須

4. 検証とデバッグ(Verification & Debugging)

修正の正しさを証明し、品質を担保するための手段です。

ツール名用途備考
get_file_problems構文エラー・警告の取得編集後の特定ファイルのチェック
build_projectプロジェクト全体のビルドコンパイルエラーの包括的取得に必須
execute_terminal_command任意コマンドの実行rm -rf 等の破壊的コマンドには細心の注意
  • execute_terminal_command については基本的に使用しない。run_shell_command でどうしても実行できない場合、ユーザーに確認を取ってから使用すること。

ワークフロー例

ステップ:精密なコード修正

  1. search_text で修正対象を検索し、スニペットで文脈を確認。
  2. read_file または get_file_text_by_path で正確な修正箇所を特定。
  3. replace_text_in_file で修正を適用。
  4. get_file_problems で構文エラーがないことを確認。
  5. build_project を実行し、プロジェクト全体の整合性を検証。

エラー処理

  • file not found の場合、list_directory_tree や search_file でパスを再確認せよ。
  • text not found の場合、read_file 等を再実行し、正確な oldText を取得し直せ。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.