s0hv/agent-skills

Cuándo usar

El servidor MCP de JetBrains debe usarse siempre que sea posible en lugar de herramientas genéricas de línea de comandos como grep y find. Aquí hay algunas situaciones de ejemplo en las que usar el servidor MCP:

• Cuando se busca un archivo, símbolo o simplemente texto
  • search_file
  • search_symbol
  • search_text
  • search_regex
• Cuando se necesita documentación para un símbolo. Funciona para paquetes y código propio.
  • get_symbol_info
• Cuando se intenta averiguar dónde se usa algún código
  • analyze_calls
• Cuando se renombra un símbolo
  • rename_refactoring
• Cuando se listan archivos
  • list_directory_tree

Para otros casos de uso, verifique si el nombre de la herramienta se ajusta al caso de uso y lea la referencia para más información.

Restricciones

• projectPath siempre debe pasarse como argumento para evitar ambigüedades.
• Las herramientas operan solo sobre archivos del proyecto.
• En algunos casos, el usuario podría haber deshabilitado algunos de los puntos finales del servidor MCP. Trate esas situaciones como si no debiera usar esas herramientas. Si aún necesita la herramienta, pida al usuario una aclaración.
• Controle la salida manualmente para evitar que la salida de la herramienta sea demasiado larga o tome demasiado tiempo en procesarse.
• Los números de línea y columna tienen base 1.

Herramientas disponibles

Las siguientes secciones enumeran herramientas explícitamente o proporcionan una breve nota sobre cuándo recurrir a ellas en el archivo de referencia. Los archivos de referencia contienen una visión general completa de todo lo disponible. Si una sección podría contener la herramienta, debe cargarla y verificarla.

reference/analysis-tools.md

Contiene herramientas que se utilizan para analizar la estructura y el código del proyecto. Herramientas disponibles:

• 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

Herramientas de base de datos para interactuar con la base de datos de un proyecto. Úselas solo con permiso, ya que las herramientas podrían causar pérdida de datos.

reference/debugger-tools.md

Herramientas para ayudar a leer y manipular una sesión activa del depurador. Úselas solo cuando se le indique que existe una sesión activa del depurador.

reference/execution-tools.md

Herramientas para ejecutar diferentes configuraciones de ejecución. Úselas solo cuando el usuario haya solicitado usar configuraciones de ejecución.

• 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