Community写作与编辑github.com

s0hv/agent-skills

我的自定义代理技能集合,包括JetBrains MCP服务器工具的使用指南。

agent-skills 是什么?

这是一个针对AI代理的技能集,主要提供JetBrains MCP服务器的工具使用指南。该技能详细说明了何时使用JetBrains MCP服务器替代通用命令行工具(如grep和find),包括搜索文件、符号、文本和正则表达式,以及获取符号文档、分析代码调用、重命名重构和列出文件等场景。它要求所有工具都必须传入projectPath参数以避免歧义,并且工具仅作用于项目文件。此外,技能列出了多个工具类别,如分析工具、代码洞察工具、数据库工具、调试工具、执行工具、文件工具、格式化工具、读取工具、重构工具、搜索工具和终端工具,并指导代理根据具体需求加载相应参考文件以获取完整工具列表。用户可能禁用某些MCP服务器端点,代理应尊重这些限制,必要时请求用户澄清。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add s0hv/agent-skills

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

何时使用

当可能时,应使用 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

相关技能