mcpField
S
specsfy-specialist-laravel

specsfy-specialist-laravel

github.com/promovaweb开发87242 次安装1 周前更新
代码仓库

关于 specsfy-specialist-laravel

面向 Laravel 项目开发的技能,用于检查现有项目并按其约定实现变更。重点关注授权、数据处理、针对性测试和运行检查。

主要功能

  1. 01检查项目指引与当前规格
  2. 02追踪请求经过的领域逻辑与持久化
  3. 03规划授权、验证与事务
  4. 04构建具备重试和故障处理的任务
  5. 05通过测试与静态分析验证

适用场景

  1. 01按现有 Laravel 约定添加功能
  2. 02检查部署期间的迁移安全性
  3. 03排查队列、调度器或查询问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/promovaweb/specsfy --skill specsfy-specialist-laravel

安装后在 Claude Code 中输入/specsfy-specialist-laravel确认已加载。

附带文件agents/openai.yamlreferences/standards.md

详细介绍

Laravel

流程

  1. 阅读说明、当前生效的规范和使用方项目的清单文件。
  2. 在 composer.json 和 composer.lock 中确认版本和扩展。
  3. 梳理请求经过的领域、持久化、异步副作用和响应。
  4. 在同类文件和现有测试中查找约定。
  5. 在编写代码前明确授权、验证、事务、幂等性和故障处理。
  6. 编写针对性测试,实现最小功能片段,然后进行重构。
  7. 运行可用的测试、静态分析、格式化工具和操作检查。

模式

  • 保持控制器精简,并将业务规则放在现有边界中。
  • 将 Form Requests、策略、资源和绑定用作本地契约。
  • 将 Eloquent 用于数据访问,不要借此隐藏昂贵查询或 N+1 问题。
  • 设计幂等的任务,并设置超时、重试次数、退避策略和故障处理。
  • 准备与数据量、预期锁定、回滚和混合部署兼容的迁移。
  • 绝不信任客户端验证,也不能只在界面中执行授权。
  • 除非有明确的使用方和可验证的收益,否则不要创建抽象、软件包或事件。

验证

  • 覆盖成功路径、授权、验证、副作用和重要故障。
  • 在基数或延迟有影响时检查查询。
  • 检查目标环境中的队列、调度器、缓存、配置和变量。
  • 记录数据风险和操作命令;未经授权,不要执行这些命令。

请阅读 references/standards.md,了解详细模式以及针对已更改领域的官方资料。

评论

支持 Markdown