skill-ide-phpstorm-mcp

# PhpStorm MCP 技能 `phpstorm-mcp` 帮助编码代理使用与开发者相同的 PhpStorm 项目上下文。 PhpStorm 通常用于 PHP 项目、混合仓库、前端应用程序、文档站点和工具项目。这些项目仍然依赖于 IDE 拥有的上下文：配置的运行时、框架索引、检查、格式化规则、运行配置、数据库连接和符号图。当代理只看到文件和 shell 时，它可能会选择错误的运行时、忽略框架约定、通过文本重命名代码或在没有足够证据的情况下进行广泛的编辑。 此技能为代理提供了一个实用的规则：使用 PhpStorm MCP 获取 IDE 拥有的语义上下文，然后使用终端工具获取确切的命令、原始输出、新鲜的文件扫描和进程控制。 ## 快速安装 从 [最新 GitHub 发布](https://github.com/TechSpokes/skill-ide-phpstorm-mcp/releases/latest) 下载当前软件包。 选择一个发布资产： - 如果您想直接将技能文件夹安装到项目或个人技能目录中，请使用 `phpstorm-mcp-vX.Y.Z.zip`。 - 如果您的 Codex 主机支持插件 ZIP 安装，请使用 `phpstorm-mcp-codex-plugin-vX.Y.Z.zip`。 - 如果您的 Claude 主机支持插件 ZIP 安装，请使用 `phpstorm-mcp-claude-plugin-vX.Y.Z.zip`。 对于大多数仓库安装，请解压独立的 ZIP 文件，以便项目包含 `.agents/skills/phpstorm-mcp/SKILL.md`。 安装后，请要求您的编码代理在 PhpStorm 中打开并连接到 PhpStorm MCP 的项目中使用 `phpstorm-mcp`。 详细安装说明：[docs/INSTALL.md](docs/INSTALL.md)。 ## 为什么存在 编码代理在 PhpStorm 项目中仅在它们与开发者使用相同的项目上下文时才有用。 该上下文通常位于 PhpStorm 中：自定义框架、包约束、Laravel 或 Symfony 约定、WordPress 和 Magento 结构、JavaScript 和前端工具、测试运行器、静态分析工具、远程解释器、Docker、WSL、SSH 和本地数据库工具。开发者还需要对可能影响依赖项、数据库、清理、格式化、VCS 状态或生成文件的更改进行显式控制。 PhpStorm 已经跟踪了许多项目知识。`phpstorm-mcp` 告诉代理何时询问 IDE、何时在终端中验证以及何时停止以获取批准。 ## 改进内容 - 代理从活跃的 PhpStorm 项目上下文开始。 - 运行时敏感的工作考虑了项目运行时、包管理器和解释器差异。 - 搜索将 IDE 感知上下文与终端回退相结合。 - 诊断从 PhpStorm 检查开始，然后进行测试或广泛清理。 - 代码符号重命名在支持的情况下使用语义重构而不是文本替换。 - 测试和脚本可以遵循项目运行时，当 IDE 定义一个时。 - JetBrains HTTP 客户端 `.http` 和 `.rest` 请求文件获取请求运行点发现、响应捕获、下载、环境选择和安全指导。 - 高风险工作保持批准门控和范围限定。 - 验证在报告成功之前使用多个信号。 ## 最佳适用 在项目在 PhpStorm 中打开且 IDE 知道外部代理可能不知道的事情时使用此技能。 它对以下情况特别有用： - Laravel、Symfony、WordPress、Magento、Composer 库、CLI 工具和自定义应用程序。 - 在 PhpStorm 中打开的 JavaScript、TypeScript、前端、文档和工具项目。 - 具有项目特定架构的成熟或专有代码库。 - 具有远程解释器、Docker、WSL、SSH、Xdebug 或生成代码的项目。 - 希望在终端验证之前进行 IDE 诊断的团队。 ## 示例请求 ```text 使用 PhpStorm MCP 技能检查此项目，仅修复低风险问题，并在测试之前使用 IDE 诊断验证结果。 ``` ```text 使用 PhpStorm MCP 技能语义重命名此服务方法，并在每个实现和调用站点进行检查。 ``` ```text 使用 PhpStorm MCP 技能在更改代码之前比较 PhpStorm 解释器、Composer 运行时和测试命令。 ``` ```text 在 TypeScript 项目中使用 PhpStorm MCP 技能检查警告、使用 IDE 搜索并使用项目测试命令验证。 ``` ```text 使用 PhpStorm MCP 技能决定此任务是否需要 IDE 检查、语义重构或终端命令。 ``` ## 工作原理 已安装的技能包含一个入口点和聚焦的引用。 - `src/SKILL.md` 告诉代理何时使用 PhpStorm MCP 以及如何路由工作。 - `src/references/` 包含搜索、检查、快速修复、重构、执行、HTTP 客户端请求文件、Composer（如果存在）、数据库安全性和 IDE 操作的任务特定指导。 指导方针故意保守。PhpStorm MCP 功能可能因 IDE 版本、启用的插件、客户端和项目类型而异，因此代理会刷新实时项目状态并验证突变，而不是假设固定的设置。 ## 软件包边界 发布软件包仅包含运行时技能文件和插件清单。 它们不包括受理材料、原始研究、本地路径、私有凭证、一次性夹具、存储库文档、工作流程、临时输出和分发文件夹。 ## 维护者 TechSpokes 维护此技能。 网站：[www.techspokes.com](https://www.techspokes.com)