1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | wp-block-development（WordPress 官方 Agent Skills 合集子技能） | GitHub API |
| 作者/维护者 | WordPress.org 官方项目账号；子目录由 Automattic、rtCamp、XWP 三家机构员工共同维护 | GitHub API |
| 来源链接 | https://github.com/WordPress/agent-skills/tree/trunk/skills/wp-block-development | — |
| 许可证 | GPL-2.0-or-later（仓库 LICENSE 文件明确写明） | 网页抓取（LICENSE 原文） |
| GitHub Stars / Forks | 1,948 / 287（整个合集仓库口径，覆盖 18 个子技能） | GitHub API |
| 最新版本 | README 自评 “v1”，无正式 Git Release/Tag | 网页抓取（README） |
| 安装方式 | npx skills add 单命令安装 / 仓库脚本批量安装 / 手动复制目录 |
网页抓取（README） |
2. 功能介绍与亮点
覆盖 WordPress（Gutenberg）区块开发全流程：block.json 元数据定义、register_block_type(_from_metadata) 注册、属性与序列化、supports 声明、动态渲染（render.php/render_callback）、区块废弃与迁移（deprecations/migrations）、viewScript 与 viewScriptModule 的取舍，以及 @wordpress/scripts/@wordpress/create-block 构建测试工作流。配套 10 篇专题参考文档（属性序列化、block.json 字段详解、创建新区块、调试排错、废弃迁移、动态渲染、内部区块组合、注册方式、包装属性、构建测试）与 1 个纯本地文件扫描的确定性检测脚本 list_blocks.mjs。
内容紧跟 WordPress 核心最新变化：明确讲解了 WordPress 6.9 起强制要求 apiVersion: 3 的原因，以及 7.0 版本编辑器 iframe 化对区块样式隔离、视口单位等带来的兼容性迁移要点。README 公开披露：技能文本最初由 GPT-5.2 Codex 基于官方 Gutenberg/WordPress 文档生成，再经 WordPress 贡献者人工审核编辑（遵循 WordPress 官方 AI 使用准则）。同一仓库另有 17 个姊妹技能覆盖插件开发、REST API、性能优化、静态分析等 WordPress 全栈场景，可搭配安装。
3. 适用场景
固定分类：前端与设计。适用于 WordPress 主题/插件开发者、Gutenberg 区块作者，以及使用 Claude Code、Codex 等 AI 编程助手做自定义 WordPress 前端组件开发的初中级开发者——尤其能帮助避免 AI 生成过时（pre-Gutenberg）区块代码、遗漏废弃迁移导致“Invalid block”报错等常见失误。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README 专门列出
.claude/skills/安装路径，支持全局与项目两种作用域 - Codex：✅ 原生支持——
.codex/skills/专属路径，多处安装示例以 Codex 为目标之一 - OpenClaw：⚠️ 未见专门验证——仓库自述“适用于任何支持项目级指令的 AI 助手”，且可经通用第三方安装器（
npx skills add，即 vercel-labs/skills）安装，该安装器官方支持 OpenClaw，但 WordPress 仓库自身文档未专门列出或测试 - Hermes Agent：⚠️ 同上，未见专门验证
5. 推荐理由
WordPress 官方项目账号亲自下场，把原本分散在 Gutenberg/WordPress 官方文档中的区块开发知识打包成可直接安装给 AI 编程助手使用的技能包，能显著降低 AI 生成过时或有缺陷的 WordPress 区块代码的概率，且完全免费开源、无外部依赖。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | WordPress.org 官方项目账号出品；子目录本身由 Automattic、rtCamp、XWP 三家机构员工共同提交维护；仓库 issue 区（如“该添加什么新技能”）吸引十余位具名开发者实质讨论并有多个外部 PR 被合并，wordpress.org 官方新闻栏目也发文介绍 |
| 可用性 | 9 | 一条 npx 命令即可安装；10 篇专题参考文档 + 1 个纯本地检测脚本，覆盖创建/注册/渲染/废弃迁移/构建测试全流程；子目录近期仍有提交更新；WordPress 核心免费，无付费依赖 |
| 安全性 | 9 | 唯一脚本 list_blocks.mjs 为纯本地文件系统扫描，无网络请求、无远程代码执行；GPL-2.0-or-later 许可证在 LICENSE 文件中明确写明；官方项目账号出品，全部内容开源可审计，未发现可疑指令 |
综合评分（三项均值）：8.3
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| Automattic/wordpress-agent-skills | Automattic 出品的实验性原型集合，专注“用自然语言描述直接生成 WordPress 主题并部署到本地 Studio 站点”，官方自述“早期阶段”、“生成主题尚不能用于生产环境” | 聚焦一键生成整站/主题，而非教 AI 助手正确编写区块代码本身；两者分别对应“生成”与“开发规范教学”两种定位 |
| sirreal/agent-skills（wordpress-trac 子技能） | 个人 WordPress 核心贡献者维护，服务于 WordPress.org Trac 工单/变更集查询、核心提交信息撰写等核心贡献流程 | 面向 WordPress 核心贡献者的内部协作场景，与面向主题/插件开发者的区块开发教学完全不重叠 |
| WooCommerce 官方插件开发工具包 | Automattic 旗下 WooCommerce 团队出品，专精 WooCommerce 插件的定稿与升级安全检查 | 限定在 WooCommerce 电商插件这一垂直场景，不覆盖通用 Gutenberg 区块的属性序列化、动态渲染、废弃迁移等主题 |
| wp-guard（第三方 WordPress 代码质量规则包） | 第三方维护的 WordPress 编码规范/安全审查规则集 | 定位为“审查已写好的代码”，而非“指导如何正确开发区块”，两者可互补但覆盖阶段不同 |
8. 用户评价
GitHub 仓库讨论区（issue #9“该添加什么新技能”）吸引了十余位具名 WordPress 开发者的实质性讨论：开发者 rushikeshmore 直接提交了新增 wp-env 技能的 PR 并邀请社区反馈；开发者 dknauss 提交 PR 分享了结合本仓库技能解决 WordPress Studio 本地环境常见冲突的经验；开发者 Xilonz 针对区块开发中的 useContext 场景提出了具体的功能改进建议。WordPress.org 官方新闻栏目也发文介绍该技能集合，引用贡献者 Brandon Payton 的说法：“AI agents work better when they have a clear feedback loop.”
9. 其他补充
该技能集合前身是 2026 年 1 月在 Automattic 个人机构账号下发布的原型项目（现已归档），随后正式移交至 WordPress.org 官方 GitHub 账号并持续扩充至 18 个子技能。README 自评为“v1”版本，注明将随社区使用反馈持续迭代；仓库同时公开 AI 创作过程说明文档，披露内容生成与人工审核的完整流程。
10. 安装使用方式
- 单技能安装：
npx skills add WordPress/agent-skills --skill wp-block-development - 批量/全局安装：克隆仓库后执行
node shared/scripts/skillpack-build.mjs --clean构建分发包，再执行node shared/scripts/skillpack-install.mjs --global（写入~/.claude/skills/等目录）或指定--dest=安装进具体项目 - 手动安装：直接复制
skills/wp-block-development/目录到对应 AI 助手的技能目录 - 安装后注意：无需重启，AI 助手下次读取项目/全局技能目录时即可发现该技能；建议同时安装同仓库的
wp-project-triage技能以获得自动项目类型检测能力
11. 注意事项
- 需要对 WordPress 7.0+/PHP 7.4.0+ 环境有基本认知；部分工作流建议本地安装 WP-CLI 与 Node.js 以运行检测脚本和
@wordpress/scripts构建工具，纯静态阅读也可用但体验打折 - 仅覆盖 Gutenberg 区块本身的开发规范，不含插件整体架构、REST API、性能优化等主题——如需这些能力需另装同仓库其他子技能
- 内容由 AI 生成后经人工审核，涉及跨版本兼容性的细节仍建议对照官方 WordPress Block Editor Handbook 做最终交叉验证
- OpenClaw、Hermes Agent 的兼容性未经仓库官方文档专门验证