guidelines-skills

将 Spatie 团队的实战编码规范封装为 AI 技能

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:guidelines-skills。
它的用途是:将 Spatie 团队的实战编码规范封装为 AI 技能
完整的 Skill 内容见:https://321skill.com/skills/guidelines-skills/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请根据 Spatie 的 Laravel 规范检查这段控制器代码的命名和结构是否合规。”,它会分析你的代码,指出不符合规范的地方(如方法命名、依赖注入方式)并给出修改建议。或者,在提交代码前问:“这次的 Git 提交信息符合 Spatie 的版本控制规范吗?”,它会评估你的提交信息格式和内容。

介绍

Spatie Guidelines Skills 旨在解决开发团队在协作中因编码风格、Git 工作流和安全实践不统一导致的代码质量参差、维护成本高和潜在安全风险问题。它将 Spatie 团队经过实战检验的 Laravel/PHP、JavaScript、Git 和安全最佳实践指南封装成可直接被 AI 助手(如 Laravel Boost 或 skills.sh)理解和应用的技能包,让 AI 在代码审查、自动修复和开发指导时能遵循这些统一标准。

该技能包主要适合追求代码一致性、希望提升团队协作效率的 Laravel 和现代 JavaScript 项目团队。无论是初创团队建立规范,还是成熟团队统一标准,都能从中受益。

对于前端、后端、全栈开发者以及技术负责人而言,这个技能包能帮助他们快速将行业认可的规范内化到日常开发流程中,减少代码审查时的风格争论。

使用建议是,在团队引入此技能包后,建议结合 CI/CD 流程,让 AI 助手在代码提交前进行自动化审查。注意事项是,这些规范主要基于 Spatie 的技术栈和偏好,团队可根据自身情况在采纳时进行适当调整和补充。

核心特点

与通用的代码规范工具相比,它直接集成了 Spatie 这家知名 Laravel 开发团队经过大量真实项目验证的、具体且可操作的实践指南,而非宽泛的原则;并且它原生支持 Laravel Boost 和 skills.sh 生态,能深度集成到开发工作流中,实现规范的自动化应用。

注意事项

主要面向 Laravel 和现代 JavaScript 技术栈,对于其他框架或语言(如 Python、Go)的规范覆盖有限。

常见问题

这个技能包和直接在编辑器中配置 ESLint/Prettier 有什么区别?

它不仅包含代码格式化规则,还涵盖了 Git 工作流、提交信息规范、安全最佳实践等更广泛的团队协作指南,并能通过 AI 助手进行上下文感知的指导和解释。

非 Laravel 项目可以使用吗?

JavaScript 和安全相关的通用规范仍然适用,但 Laravel/PHP 部分的规范针对性较强,非 Laravel 项目可能需要进行筛选和调整。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/guidelines-skills/raw/index.md 读取 guidelines-skills 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。