关于 woocommerce-backend-dev
woocommerce-backend-dev 是用于编写和修改 WooCommerce 后端 PHP 代码的开发技能,涵盖代码结构、钩子、数据完整性、依赖注入和测试规范。
主要功能
- 01WooCommerce PHP 规范
- 02类与文件组织方式
- 03命名和编码标准
- 04钩子与依赖注入指引
- 05CRUD 数据完整性指引
- 06单元测试规范
适用场景
- 01编写 WooCommerce 后端 PHP 代码
- 02检查钩子和依赖注入用法
- 03为新功能编写单元测试
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ secondsky/ claude-skills --skill woocommerce-backend-dev安装后在 Claude Code 中输入/woocommerce-backend-dev确认已加载。
详细介绍
WooCommerce 后端开发
本技能提供指导,帮助你按照项目标准和约定开发 WooCommerce 后端 PHP 代码。
说明
添加或修改后端 PHP 代码时,请遵循 WooCommerce 项目约定:
- 创建新的代码结构:请参阅 file-entities.md,了解创建类和组织文件的约定(但新建单元测试文件时,请参阅 unit-tests.md)。
- 命名约定:请参阅 code-entities.md,了解方法、变量和参数的命名方式。
- 编码风格:请参阅 coding-conventions.md,了解一般编码标准和最佳实践。
- 使用钩子:请参阅 hooks.md,了解钩子回调约定和文档编写规范。
- 依赖注入:请参阅 dependency-injection.md,了解 DI 容器的用法。
- 数据完整性:请参阅 data-integrity.md,了解执行 CRUD 操作时如何确保数据完整性。
- 编写测试:请参阅 unit-tests.md,了解单元测试约定。
核心原则
- 始终遵循 WordPress 编码标准。
- 使用类方法,而不是独立函数。
- 默认将新的内部类放在
src/Internal/中。 - 使用
Automattic\WooCommerce命名空间进行 PSR-4 自动加载。 - 为新功能编写全面的单元测试。
- 提交更改前运行代码检查和测试。
- 在适用时,使用 bun 而不是 npm/bunx 管理 Node.js 软件包。
版本信息
要确定 @since 注释中应使用的下一个 WooCommerce 版本号:
- 在 trunk 分支中读取
includes/class-woocommerce.php里的$version属性。 - 如果存在
-dev后缀,请将其移除。 - 示例:如果 trunk 显示
10.4.0-dev,则使用@since 10.4.0。 - 注意:审查针对 trunk 的 PR 时,即使 trunk 中的版本相较于已发布版本看起来像是“未来版本”,也应以 trunk 中的版本为准。
评论
支持 Markdown