用途：把已有 WordPress 插件升级到最新 plugin-boilerplate 结构，同步构建工具、QA 配置与架构模式。
主要能力：克隆上游样板后逐区对比差异，覆盖 PHP（composer.json 与 QA）、JS 与打包（package.json、webpack.config.js）、GitHub Actions、Loader.php、主插件类、i18n 工作流、Abilities API（WordPress 6.9+）以及 .opencode 命令与 .agents/skills 智能体配置、.distignore 与 .gitignore。
使用方式：先克隆样板用于对比：git clone --depth 1 https://github.com/JUVOJustin/wordpress-plugin-boilerplate.git ./tmp/boilerplate-ref；再从目标插件读取三个身份参数：plugin-name（主 PHP 文件 Plugin Name 头）、plugin-text-domain（Text Domain 头）、plugin-namespace（composer.json 中映射到 src/ 的 PSR-4 命名空间）。随后运行 bundled 的 scripts/boilerplate-replace.php，例如：php tmp/boilerplate-ref/.agents/skills/boilerplate-update/scripts/boilerplate-replace.php --path tmp/boilerplate-ref --plugin-name "My Awesome Plugin" --plugin-namespace "My_Awesome_Plugin" --plugin-text-domain "my-awesome-plugin" --cleanup-setup。该脚本会替换占位符、删除 BOILERPLATE-DOCS 标记段并清理 setup 专用文件。脚本也支持重命名已定制插件，通过 --source-plugin-* 指定当前身份。之后按区域分派子代理进行 diff，按需确认后增量应用，最后 rm -rf tmp/boilerplate-ref。
确认规则：替换或重构文件、更换构建工具与资源管线、修改 CI/CD、引入新架构模式、删除功能资源前须向用户确认；更新依赖版本、功能等价的脚本改名、同步 QA 配置等可直接进行。
限制：实现细节须查阅样板 docs/ 下对应文档（如 abilities.mdx、bundeling.mdx、i18n.mdx、create-blocks.mdx、wp-env.mdx、acf-json-sync.mdx、work-with-ai.mdx、documentation.mdx），本技能仅提供高层指引。验证步骤包括 composer install && npm install、npm run build、composer phpstan && composer phpcs、npm run lint:js && npm run lint:style。其他平台或计费信息暂未提供。