关于 woocommerce-dev-cycle
面向 WooCommerce 贡献者的开发工作流技能,集中提供测试、代码质量、PHP lint、JavaScript 和 TypeScript 国际化以及 Markdown 检查指引。
主要功能
- 01PHP 和 JavaScript 测试指引
- 02代码质量与 lint 流程
- 03PHP lint 问题模式
- 04JS/TS 国际化指引
- 05Markdown lint 指引
适用场景
- 01开发时运行指定的 WooCommerce 测试
- 02提交前检查分支改动
- 03修复 PHP lint 和国际化问题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ woocommerce/ woocommerce --skill woocommerce-dev-cycle安装后在 Claude Code 中输入/woocommerce-dev-cycle确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
code-quality.mdjs-i18n-patterns.mdmarkdown-linting.mdphp-linting-patterns.mdrunning-tests.md详细介绍
WooCommerce 开发周期
本技能提供 WooCommerce 开发工作流指南,包括运行测试、代码质量检查和故障排查。
说明
遵循以下 WooCommerce 开发工作流指南:
- 运行测试:请参阅 running-tests.md,了解 PHP 和 JavaScript 测试命令、测试环境设置和故障排查
- 代码质量:请参阅 code-quality.md,了解代码检查、代码风格修复,以及依赖项变更的锁文件流程
- PHP 代码检查模式:请参阅 php-linting-patterns.md,了解常见的 PHP 代码检查问题及修复方法
- JS/TS 国际化模式:请参阅 js-i18n-patterns.md,了解可翻译字符串模式和占位符用法
- Markdown 代码检查:请参阅 markdown-linting.md,了解 Markdown 文件的代码检查和格式设置
开发工作流
标准开发工作流:
- 修改代码
- 运行相关测试:
pnpm run test:php:env -- --filter YourTestClass - 运行代码检查:
pnpm --filter=@woocommerce/plugin-woocommerce lint:changes:branch(PHP 和 JS;CI 的 Lint 作业会运行此命令;请先使用git add添加新文件,因为未跟踪的文件会被跳过;对于目标分支不是 trunk 的 PR,请追加其已获取的基分支,例如origin/release/X.Y) - 修复所有问题:使用
pnpm --filter=@woocommerce/plugin-woocommerce lint:php:fix修复 PHP 问题;JS 没有分支修复器,因此请手动修复 JS(参见 code-quality.md) - 仅在测试通过后提交更改
关键原则
- 修改后务必运行测试,以验证功能
- 开发期间使用特定的测试筛选条件运行相关测试
- 仅修复当前分支代码中的代码检查错误
- 测试失败时会提供详细输出,展示预期值与实际值
- 测试环境会自动处理 WordPress/WooCommerce 的设置
评论
支持 Markdown