s0hv/agent-skills

使用時機

當 JetBrains MCP 伺服器可用時，應優先使用其提供的工具，而非一般的指令列工具（如 grep 與 find）。以下是適合使用 MCP 伺服器的範例情境：

• 搜尋檔案、符號或純文字時
  • search_file
  • search_symbol
  • search_text
  • search_regex
• 需要取得某個符號的文件說明（適用於套件及自有程式碼）
  • get_symbol_info
• 想找出程式碼被哪些地方使用時
  • analyze_calls
• 重新命名符號時
  • rename_refactoring
• 列出檔案時
  • list_directory_tree

對於其他使用情境，請檢查工具名稱是否相符，並參考更多資訊的文件。

限制

• projectPath 必須始終作為參數傳遞，以避免歧義。
• 工具僅能操作專案檔案。
• 在某些情況下，使用者可能已停用部分 MCP 伺服器端點。請將這些情況視為你不應使用那些工具。如果仍然需要該工具，請向使用者請求說明。
• 手動控制輸出，避免工具輸出過長或處理時間過久。
• 行號與欄號皆從 1 開始計算。

可用工具

以下各節可能明確列出工具，或提供何時應查閱參考文件的簡短說明。參考文件中包含所有可用的完整概覽。若某節可能包含所需工具，你應載入該文件並檢查。

reference/analysis-tools.md

包含用於分析專案結構與程式碼的工具。 可用工具：

• analyze_calls
• build_project
• get_file_problems
• get_project_dependencies
• get_project_modules
• lint_files

reference/code-insight-tools.md

• get_symbol_info

reference/database-tools.md

用於與專案資料庫互動的資料庫工具。 僅在獲得許可後使用，因為這些工具可能導致資料遺失。

reference/debugger-tools.md

用於讀取與操作活躍除錯器工作階段的工具。僅在被告知存在活躍除錯器工作階段時使用。

reference/execution-tools.md

用於執行不同執行配置的工具。僅當使用者要求使用執行配置時使用。

• execute_run_configuration
• get_run_configurations

reference/file-tools.md

• create_new_file
• get_all_open_file_paths
• list_directory_tree
• open_file_in_editor

reference/formatting-tools.md

• reformat_file

reference/read-tools.md

• read_file

reference/refactoring-tools.md

• rename_refactoring

reference/search-tools.md

• search_file
• search_regex
• search_symbol
• search_text

reference/terminal-tools.md

• execute_terminal_command