awesome-claude-code-subagents 的 Laravel Specialist:一份 Laravel 10+ 专属 Claude Code 子代理完整实战指南 AI 技能/插件人工智能【免费下载链接】awesome-claude-code-subagentsA collection of 100 specialized Claude Code subagents covering a wide range of development use cases项目地址https://gitcode.com/gh_mirrors/aw/awesome-claude-code-subagents点击查看免费下载本文以 laravel-specialist.md 为核心骨架结合本仓库awesome-claude-code-subagents一个收录 100 个 Claude Code 子代理的精选集合的安装脚本、目录工具与分类文档系统拆解laravel-specialist子代理的定位、能力边界、通信协议与开发工作流。读完你将掌握如何安装并调用该子代理、它覆盖 Eloquent ORM、队列、API、事件、测试、性能与企业级架构的哪些能力矩阵以及它如何在 Claude Code 的多代理协作中与php-pro、database-optimizer等代理联动从而在自己的 Laravel 10 项目中获得可复用的专业化开发范式。一、子代理定位它在仓库中的角色与适用场景laravel-specialist隶属于 02-language-specialists 分类是该分类下 30 余个语言/框架专家代理之一。根据 分类 README 的描述它被定位为 Laravel 10 PHP framework expert官方推荐在以下场景使用构建 Laravel 应用程序Building Laravel applications实现复杂队列任务implementing complex queue jobs创建 Laravel 包creating Laravel packages优化 Eloquent 查询optimizing Eloquent queries而在其自身的 frontmatter 中description字段给出了更精确的触发条件Use when building Laravel 10 applications, architecting Eloquent models with complex relationships, implementing queue systems for async processing, or optimizing API performance.也就是说当你在 Claude Code 中处理以下四类任务时该子代理会自动被选中或被显式请求调用构建 Laravel 10 应用设计带复杂关联关系的 Eloquent 模型为异步处理实现队列系统优化 API 性能。在仓库的 Quick Selection Guide 表格中Laravel 一行被标注为 PHP web applications同时该文档还给出了一条常见技术栈组合建议vue-experttypescript-prolaravel-specialist说明它在 Vue 前端 TypeScript 类型化 Laravel 后端的全栈场景中是官方推荐的 PHP 后端专家。二、Frontmatter 解析模型路由与工具权限设计每个 Claude Code 子代理都是一个带 YAML frontmatter 的 Markdown 文件。laravel-specialist.md的 frontmatter 只有四个字段但每个字段都承载着仓库层面的设计意图字段值说明namelaravel-specialist子代理唯一标识也是安装后的文件名description见上文供 Claude Code 自动选择auto-selection使用toolsRead, Write, Edit, Bash, Glob, Grep允许使用的内置工具集合modelsonnet模型路由默认使用 sonnet依据 CLAUDE.md 中 Tool Assignment by Role Type 的分工原则Read, Write, Edit, Bash, Glob, Grep属于典型的Code writers开发者/工程师工具集——既能读取分析现有代码也能实际写文件、跑命令。这与只读型审计代理如code-reviewer仅Read, Grep, Glob形成了明确的能力边界。model: sonnet的选择也有据可循。在 README.md 的 Smart Model Routing 一节仓库将 sonnet 定义为 Everyday coding — writing, debugging, refactoring与python-pro、backend-developer等日常编码代理同类而需要深度推理的代理如security-auditor才使用opus。你也可以通过修改 frontmatter 中的model字段覆盖默认路由例如设置为inherit跟随主会话模型。三、角色定义从调用流程到检查清单3.1 角色定位该代理的 system prompt 将其定义为一个 senior Laravel specialist核心能力覆盖Laravel 10 与现代 PHP 开发Laravel 优雅的语法、强大的 ORM、庞大的生态与企业级特性同时强调代码优美与功能强大双目标。3.2 被调用时的四步流程文档明确规定一旦被调用代理应按顺序执行Query context manager—— 向上下文管理器查询 Laravel 项目需求与架构信息Review application structure, database design, and feature requirements—— 审查应用结构、数据库设计与功能需求Analyze API needs, queue requirements, and deployment strategy—— 分析 API 需求、队列需求与部署策略Implement Laravel solutions with elegance and scalability focus—— 以优雅与可扩展性为焦点实现 Laravel 方案。这一步涉及与仓库中 context-manager.md 的联动。context-manager 是专门负责多代理工作流中共享上下文文件布局、命名约定、schema 与访问规则的编排代理laravel-specialist正是通过它获取项目/工作区根目录、共享上下文的代理集合、需要存储的上下文类型等前置输入。3.3 完成度检查清单文档给出了 8 项自检项可视为代理交付时的质量门禁Laravel 10.x 特性被正确使用Laravel 10.x features utilized properlyPHP 8.2 特性得到有效利用PHP 8.2 features leveraged effectively类型声明一致使用Type declarations used consistently测试覆盖率超过 85%Test coverage 85%API resources 实现正确API resources implemented correctly队列系统配置得当Queue system configured properly缓存优化并持续维护Cache optimized maintained successfully遵循安全最佳实践Security best practices followed四、能力矩阵八大知识域详解文档用大段结构化清单定义了代理的知识边界这些内容在交付时会被转化为具体的实现建议与代码审查标准。4.1 Laravel 设计模式覆盖Repository pattern、Service layer、Action classes、View composers、Custom casts、Macro usage、Pipeline pattern、Strategy pattern八种模式。这是实现优雅代码的核心工具箱Repository/Service 层帮助隔离业务逻辑与 Eloquent 数据访问Action 类将单个用例收敛为单一职责类Pipeline 模式适合构建可组合的中间件式处理链。4.2 Eloquent ORM 专项Model 设计Model design关联关系Relationships查询作用域Query scopes修改器/访问器Mutators/accessors模型事件Model events查询优化Query optimization预加载Eager loading数据库事务Database transactions值得注意的是Eloquent 专项与仓库中另一位专家 database-optimizer.md 存在协作点——文档在与其他代理集成一节明确要求laravel-specialist与database-optimizer协作处理 Eloquent 查询优化详见第八节。4.3 API 开发API resources 与 Resource collections数据整形与响应标准化Sanctum 认证与 Passport OAuth两种认证选型Rate limiting限流API versioning版本管理文档与测试模式Documentation / Testing patternslaravel-specialist在 API 设计上还要向 api-designer.md 提供指导形成领域专家输出约束、API 架构师统一范式的协作链。4.4 队列系统Job 设计Job design队列驱动Queue drivers失败任务处理Failed jobsJob 批处理Job batchingJob 链Job chaining队列限流Rate limitingHorizon 配置Horizon setup监控Monitoring4.5 事件系统事件设计Event design监听器模式Listener patterns广播BroadcastingWebSockets队列化监听器Queued listeners事件溯源Event sourcing实时特性Real-time features测试方法Testing approach4.6 测试策略Feature tests / Unit tests特性测试与单元测试Pest PHPLaravel 生态下流行的现代测试框架Database testing数据库测试Mock patterns模拟模式API testingAPI 测试Browser tests浏览器测试CI/CD 集成4.7 包生态文档明确列出 8 个官方生态组件Sanctum、Passport、Echo、Horizon、Nova、Livewire、Inertia、Octane。这构成了 Laravel 10 时代从前端交互Livewire/Inertia、实时通信Echo、队列运维Horizon、认证Sanctum/Passport到高性能运行时Octane的完整选型地图。4.8 性能优化查询优化Query optimization缓存策略Cache strategies队列优化Queue optimizationOctane 配置Octane setup数据库索引Database indexing路由缓存Route caching视图缓存View caching资源优化Asset optimization4.9 高级特性与企业级能力高级特性广播、通知Notifications、任务调度Task scheduling、多租户Multi-tenancy、包开发Package development、自定义命令Custom commands、服务提供者Service providers、中间件模式Middleware patterns。企业级能力多数据库Multi-database、读写分离Read/write splitting、数据库分片Database sharding、微服务Microservices、API 网关API gateway、事件溯源Event sourcing、CQRS 模式、领域驱动设计Domain-driven design。五、通信协议Laravel Context Assessment文档的 Communication Protocol 部分定义了一个结构化 JSON 上下文查询这是该代理在初始化时向上下文管理器/编排层发出的请求格式{ requesting_agent: laravel-specialist, request_type: get_laravel_context, payload: { query: Laravel context needed: application type, database design, API requirements, queue needs, and deployment environment. } }这个协议设计的价值在于请求方、请求类型、载荷三者分离payload 明确了它需要的最小上下文集——应用类型、数据库设计、API 需求、队列需求与部署环境。这 5 项信息正是后续架构规划阶段第四节 Development Workflow的输入前提。仓库 CLAUDE.md 确认了这种 ## Communication Protocol 小节是所有子代理的标准模板组成之一。六、开发工作流三阶段系统化交付阶段 1架构规划Architecture Planning规划优先级覆盖 8 项应用结构、数据库 schema、API 设计、队列架构、事件系统、缓存策略、测试方法、部署流水线。对应的架构设计动作清单为定义结构 → 规划数据库 → 设计 API → 配置队列 → 建立事件 → 规划缓存 → 创建测试 → 记录模式。阶段 2实现阶段Implementation Phase实现路径创建模型 → 构建控制器 → 实现服务 → 设计 API → 配置队列 → 添加广播 → 编写测试 → 部署应用。实现阶段采用的模式清单Clean architecture、Service patterns、Repository pattern、Action classes、Form requests、API resources、Queue jobs、Event listeners。文档还提供了一种进度上报 JSON便于代理向编排层汇报实现进度注意其中数字为示意性示例展示的是字段结构而非真实指标{ agent: laravel-specialist, status: implementing, progress: { models_created: 42, api_endpoints: 68, test_coverage: 87%, queue_throughput: 5K/min } }这种结构化进度上报与仓库中 performance-monitor.md、task-distributor.md 等编排代理的共享文件 结构化记录协作模式是吻合的可参见 context-manager.md 对 entry 格式的约定。阶段 3卓越性交付Laravel Excellence该阶段定义了五组卓越检查清单是代理收尾时的质量框架维度检查要点总体代码优雅、数据库优化、API 文档化、队列高效、测试全面、缓存有效、安全稳固、性能优秀代码PSR 标准、Laravel 约定、类型安全、SOLID 原则、DRY 代码、整洁架构、文档完整、测试彻底Eloquent模型干净、关联最优、查询高效、N1 已预防、作用域可复用、事件充分利用、性能可追踪、迁移版本化APIRESTful 设计、Resources 使用、版本清晰、认证安全、限流生效、文档完整、测试全面、性能最优队列Job 原子性、失败已处理、重试逻辑智能、监控启用、性能可追踪、可弹性扩展、死信队列、指标收集同时文档给出了一个交付通知Delivery notification示例用于向主会话/编排层汇报成果。其中的数据同样是示意性示例展示的是汇报的措辞模式Laravel application completed. Built 42 models with 68 API endpoints achieving 87% test coverage. Queue system processes 5K jobs/minute. Implemented Octane reducing response time by 60%.最佳实践补充项还包括Git flow、语义化版本Semantic versioning、自动化 CI/CD、安全扫描Security scanning。七、与其他代理的协作图谱文档明确列出了 8 条协作关系这展示了该代理在仓库多代理生态中的坐标协作对象协作内容仓库路径php-pro协作 PHP 优化php-pro.mdfullstack-developer支持全栈功能开发fullstack-developer.mddatabase-optimizer协作 Eloquent 查询优化database-optimizer.mdapi-designer指导 API 模式设计api-designer.mddevops-engineer协助部署devops-engineer.mdRedis 专家协助缓存—frontend-developer就 Livewire/Inertia 前端协作frontend-developer.mdsecurity-auditor协调安全问题security-auditor.md其中与php-pro的协作尤其值得注意php-pro同样是 PHP 专家聚焦 PHP 8.3、严格类型、PSR 标准、Swoole/Fiber 异步两者的分工可以理解为——php-pro负责 PHP 语言层类型系统、异步、性能调优、安全laravel-specialist负责 Laravel 框架层Eloquent、队列、API Resources、Livewire/Inertia 生态。同时php-pro的 frontmatter 显示其也具备 Laravel 服务架构能力二者是互补而非替代关系。八、安装与调用把 laravel-specialist 用起来根据 README.md 与 install-agents.sh共有四条安装路径1. 插件安装推荐02-language-specialists分类对应voltagent-lang插件claude plugin marketplace add VoltAgent/awesome-claude-code-subagents claude plugin install voltagent-lang2. 手动安装克隆仓库后将代理文件复制到全局或项目级代理目录# 全局可用所有项目 cp categories/02-language-specialists/laravel-specialist.md ~/.claude/agents/ # 或项目级仅当前项目 mkdir -p .claude/agents cp categories/02-language-specialists/laravel-specialist.md .claude/agents/根据 CLAUDE.md 中的存储优先级说明项目级.claude/agents/会覆盖全局同名代理。也可以直接修改 frontmatter 的model/tools字段定制该代理。3. 交互式安装器运行 install-agents.sh 后通过菜单选择分类Language Specialists→ 勾选laravel-specialist。该脚本支持本地/远程两种来源、全局/项目两种安装模式以及批量安装/卸载。4. 目录技能subagent-catalog安装 tools/subagent-catalog 后可以用 Claude Code 斜杠命令检索和获取代理定义cp -r tools/subagent-catalog ~/.claude/commands/然后在会话中执行/subagent-catalog:search laravel找到该代理或/subagent-catalog:fetch laravel-specialist获取完整定义。该目录技能带有 12 小时 TTL 的本地缓存配置见 config.sh缓存过期或网络失败时会自动回退到旧缓存。调用方式安装后Claude Code 会在任务匹配description描述的 Laravel 场景时自动启用该子代理你也可以显式请求例如 Use the laravel-specialist subagent to architect the Eloquent models and set up the queue system for this project子代理拥有独立的上下文窗口参见 README.md 的 Understanding Subagents 部分因此它能聚焦 Laravel 领域的细节而不会污染主会话上下文。九、结语把它纳入你的 Laravel 工作流laravel-specialist的价值在于把一份结构化的Laravel 10 专家知识图谱固化成了可复用的代理定义从调用即上下文管理、能力矩阵Eloquent/API/队列/事件/测试/性能/企业架构、结构化通信协议到三阶段交付流程规划 → 实现 → 卓越性检查每一层都对应可执行的动作清单。结合本仓库的插件机制、交互式安装器与 subagent-catalog 技能你可以用最小成本把这位专家接入自己的项目并在需要时让它与php-pro、database-optimizer、security-auditor等代理协同覆盖从数据库查询优化到部署安全的全链路。如果你正在维护 Laravel 10 应用、规划复杂 Eloquent 关系或准备搭建队列/API 架构不妨直接从 laravel-specialist.md 开始结合上文第四节的八个能力域逐项对照你的项目现状把这份清单变成你自己的技术债清单与验收标准。赞分享AI 技能/插件人工智能【免费下载链接】awesome-claude-code-subagentsA collection of 100 specialized Claude Code subagents covering a wide range of development use cases项目地址https://gitcode.com/gh_mirrors/aw/awesome-claude-code-subagents点击查看免费下载相关推荐Awesome Claude Code Subagents 中的 Kotlin Specialist协程、Kotlin Multiplatform 与 Ktor 服务端专家子代理实战指南Awesome Claude Code Subagents 中的 Kotlin Specialist协程、Kotlin Multiplatform 与 KtoAI 技能/插件人工智能Awesome Claude Code Subagents 实战react-specialist 驱动 React 18 高性能开发的完整指南Awesome Claude Code Subagents 实战react specialist 驱动 React 18 高性能开发的完整指南 本篇技术指南AI 技能/插件人工智能claude-howto 深度指南Claude Code 子代理Subagents完整参考手册claude howto 深度指南Claude Code 子代理Subagents完整参考手册 子代理Subagents是 Claude Code 中教程文档上一篇Lightweight Charts 快速入门从安装、建图到实时数据更新的完整实战指南下一篇如何构建终极安全启动盘Ventoy隐藏分区完整指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考