laravel-plugin-discovery

laravel-plugin-discovery 技能概览

laravel-plugin-discovery 的作用

laravel-plugin-discovery 技能帮助你通过 LaraPlugins.io MCP 服务器查找并评估 Laravel 包。它面向的是“做决策”，不只是“搜一搜”：当你需要包推荐、想检查维护健康度，或在安装前确认 Laravel/PHP 兼容性时，就该用它。

适合谁使用

这个 laravel-plugin-discovery 技能最适合 Laravel 开发者、API 团队和维护者，帮助他们更快选包、少走弯路。尤其是在 API 开发中的 Laravel 插件发现 场景下非常有用，比如你需要一个可靠的包来做认证、权限、限流、管理后台工具，或者项目脚手架。

为什么它重要

它真正要解决的问题，是在采纳前降低包的风险。与其快速扫一眼 GitHub，不如用 laravel-plugin-discovery 提供的健康信号和兼容性筛选，先把候选范围缩小，再投入时间做测试或集成。

如何使用 laravel-plugin-discovery 技能

先安装并连接 MCP

在执行 laravel-plugin-discovery install 之前，先把 LaraPlugins MCP 服务器配置到你的 Claude 环境里，后面再期待结果才有意义。把 SKILL.md 里的服务器配置项加入 ~/.claude.json 的 mcpServers 下，然后确认该技能可以访问 https://laraplugins.io/mcp/plugins。不需要 API key。

先写清楚搜索需求

好的 laravel-plugin-discovery usage 不是一句含糊的“找个最好的包”，而是明确具体需求。请写清功能、Laravel 版本、PHP 版本，以及任何硬性约束。例如：“帮我找一个健康度高、支持 PHP 8.2 的 Laravel 11 权限包，避免已经停止维护的厂商。” 这样技能才能用上真正有用的筛选条件。

先看对的文件

如果你想快速理解 laravel-plugin-discovery guide，先打开 SKILL.md，重点看“何时使用”“MCP 要求”和“MCP 工具”这些部分。当前仓库文件不多，SKILL.md 就是主要事实来源。如果你要把这个技能改造成自己的工作流，建议复用工具名称和筛选逻辑，而不是照搬措辞。

用会影响决策的筛选条件

最有价值的输入是 text_search、health_score、laravel_compatibility 和 php_compatibility。如果你已经知道类别，就做窄搜索；如果你需要按健康度和版本匹配度排序的候选项，就做宽搜索。例如：“搜索与 Laravel 10 兼容、health score 为 Healthy 的管理后台包，并总结它们在 API 后端场景中的取舍。”

laravel-plugin-discovery 技能常见问题

它比普通提示词更好吗？

是的，前提是你需要有依据的选包。普通提示词可以推荐常见的 Laravel 包，但当你想通过 MCP 筛选做结构化发现，尤其是检查维护情况和兼容性时，laravel-plugin-discovery 会更合适。

使用它必须依赖 MCP 吗？

是的。这个技能依赖 LaraPlugins MCP 服务器，所以如果没有配置该服务器，laravel-plugin-discovery 就基本派不上用场。如果无法使用 MCP，退回到通用研究提示词会更合适。

对新手友好吗？

友好，只要你能用普通语言描述自己需要的功能。新手通常从“API 项目的管理后台”或“角色和权限包”这类场景出发，再补上 Laravel 和 PHP 版本，效果会更好。

什么时候不该用它？

如果你已经知道自己要哪个包，或者你并不在 Laravel 生态里工作，又或者你只想快速了解概念、并不需要检查包的健康度和兼容性，就不要用 laravel-plugin-discovery。

如何改进 laravel-plugin-discovery 技能

给技能加上决策约束

最强的 laravel-plugin-discovery skill 输入，会同时说明目标和边界：框架版本、PHP 版本、许可证偏好、维护容忍度，以及这个包是否必须适合 API 场景或是否偏重 UI。把这些信息补全，技能才能更早筛掉不合适的候选项。

要求返回排序结果，而不是单个名字

要提升 laravel-plugin-discovery usage 的效果，最好要求给出带理由的短名单。例如：“给我 3 个适合 API 认证、健康度为 Healthy 的 Laravel 11 包，按维护情况和生态匹配度排序，并说明安装上的取舍。” 这样输出会比一句话推荐更可执行。

注意常见失败模式

最大的错误是把兼容性说得太模糊，最后得到的推荐看起来不错，却并不适合你的技术栈。另一个常见问题是只看流行度，忽略包的健康度。应当先用这个技能比较维护信号，再结合你的项目约束去验证最终候选。

在第一轮之后继续迭代

如果第一次结果太宽泛，就补充更明确的背景信息继续收窄：比如“Laravel 12、PHP 8.3、仅 API、不要付费层、优先过去 12 个月内有活跃发布的项目”。这样的追问会让 laravel-plugin-discovery 更精确，也能减少安装时的意外。