关于 specsfy-specialist-laravel
面向 Laravel 项目开发的技能,用于检查现有项目并按其约定实现变更。重点关注授权、数据处理、针对性测试和运行检查。
主要功能
- 01检查项目指引与当前规格
- 02追踪请求经过的领域逻辑与持久化
- 03规划授权、验证与事务
- 04构建具备重试和故障处理的任务
- 05通过测试与静态分析验证
适用场景
- 01按现有 Laravel 约定添加功能
- 02检查部署期间的迁移安全性
- 03排查队列、调度器或查询问题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ promovaweb/ specsfy --skill specsfy-specialist-laravel安装后在 Claude Code 中输入/specsfy-specialist-laravel确认已加载。
附带文件agents/openai.yamlreferences/standards.md
详细介绍
Laravel
流程
- 阅读说明、当前生效的规范和使用方项目的清单文件。
- 在
composer.json和composer.lock中确认版本和扩展。 - 梳理请求经过的领域、持久化、异步副作用和响应。
- 在同类文件和现有测试中查找约定。
- 在编写代码前明确授权、验证、事务、幂等性和故障处理。
- 编写针对性测试,实现最小功能片段,然后进行重构。
- 运行可用的测试、静态分析、格式化工具和操作检查。
模式
- 保持控制器精简,并将业务规则放在现有边界中。
- 将 Form Requests、策略、资源和绑定用作本地契约。
- 将 Eloquent 用于数据访问,不要借此隐藏昂贵查询或 N+1 问题。
- 设计幂等的任务,并设置超时、重试次数、退避策略和故障处理。
- 准备与数据量、预期锁定、回滚和混合部署兼容的迁移。
- 绝不信任客户端验证,也不能只在界面中执行授权。
- 除非有明确的使用方和可验证的收益,否则不要创建抽象、软件包或事件。
验证
- 覆盖成功路径、授权、验证、副作用和重要故障。
- 在基数或延迟有影响时检查查询。
- 检查目标环境中的队列、调度器、缓存、配置和变量。
- 记录数据风险和操作命令;未经授权,不要执行这些命令。
请阅读 references/standards.md,了解详细模式以及针对已更改领域的官方资料。
评论
支持 Markdown