GenerateBlocks Skills

为 GenerateBlocks V2/Pro 提供 LLM 优化的 Agent 技能,让 AI 编码助手生成可通过 MCP 直接发布到 WordPress 站点的合法区块标记。

Star 数
★ 143
最近更新
25 天前
主语言
PHP

30 秒速览

运行形态
Agent 插件 / 技能命令行工具
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
GitBashShell / 命令行网络访问本地文件系统
典型场景
使用 GenerateBlocks V2/Pro 搭建页面的 WordPress 开发者,想让 Claude Code 直接生成英雄区、定价表、FAQ 等区块标记
不适合
  • 不使用 GenerateBlocks/GeneratePress 的 WordPress 站点
  • 需要交互依赖自定义 JavaScript 而非 CSS 的项目
  • 没有支持 agent 的编辑器或 CLI、只想手动建站的用户
官网
gauravtiwari.org ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-10-28

这个 Agent 能做什么,适合哪些场景?

GenerateBlocks Skills 是一套面向 AI 编码助手的开源技能文档库,覆盖 GenerateBlocks 2.5.0 和 Pro 2.8.0。它包含四个技能:generateblocks-layouts(静态区块、查询循环、动态标签、ACF 字段、Pro 表单与交互区块)、html-to-generateblocks、elementor-to-generateblocks 和 figma-to-generateblocks。技能以 SKILL.md 入口加 references/ 路由参考文件的形式组织,并附带经过验证的示例和 preflight.py 校验脚本。执行模型是纯文档驱动:技能本身不运行服务,而是让 Claude Code、Codex、Cursor、Windsurf、Gemini CLI 等助手读取规则后生成区块标记字符串,再由用户手动粘贴到区块代码编辑器,或通过 Site Agent 等 MCP 插件以原始 post_content 读写方式发布。仓库已在一个真实 WordPress 7.1.3 编辑器中验证,捆绑的 build_css() 编译器与原生 2.5 Styles Builder 逐字节一致(1,453 个样式对象)。插件源码遵循 GPL-2.0-or-later,技能文档遵循 MIT。

仓库提供四个技能目录(generateblocks-layouts、html-to-generateblocks、elementor-to-generateblocks、figma-to-generateblocks),每个包含 SKILL.md 入口、references/ 参考文件(authoring-contract.md、recovery-rules.md、dynamic-tags.md、query-block.md、pro-forms.md、mcp-publishing.md 等)和 examples/ 示例。AI 助手读取技能后产出 GenerateBlocks V2 区块标记:核心使用 generateblocks/element、/text、/media、/shape 和 generateblocks/query 系列区块,样式写在可编辑的 styles 属性中并编译为本地 css。发布有两条路径:手动粘贴到区块编辑器的代码编辑器(Ctrl+Shift+Alt+M),或通过暴露原始 post_content 读写的 MCP 服务器(推荐作者的 Site Agent 插件)配合 verify_roundtrip.py 校验。安装用 install.sh 交互式部署到各工具目录,或导入 importable/ 下的 .skill/.zip 包。每次写入前应运行 preflight.py <file> --id-scope <SCOPE> 校验。

  1. 使用 GenerateBlocks V2/Pro 搭建页面的 WordPress 开发者,想让 Claude Code 直接生成英雄区、定价表、FAQ 等区块标记
  2. 要从 Elementor 或 Figma 设计迁移到干净 GenerateBlocks 区块的团队
  3. 用 ACF repeater 字段(如 team_members)生成动态团队网格或查询循环的站点维护者
  4. 通过 Site Agent MCP 插件让 agent 把生成的区块直接写入线上或测试站页面的发布流程
  5. 需要 GeneratePress Elements 循环模板、FSE 模板等全站模板的建站者
  6. 要为 Bricks、Kadence 之外的 GenerateBlocks 生态维护 AI 技能的前端开发者

如何安装或部署这个 Agent?

快速安装使用仓库自带的多工具安装器:

git clone https://github.com/wpgaurav/generateblocks-skills.git
cd generateblocks-skills
chmod +x install.sh
./install.sh

交互式选择工具,或一键安装:

./install.sh --all
./install.sh claude
./install.sh cursor codex

Claude Code 技能安装到 ~/.claude/skills/,Cursor 到 ~/.cursor/skills/;Codex 的原生技能目录安装方式见 wiki 的 Installation 指南。也可不用安装器,直接在 Claude Code/Cursor/Windsurf 中引用技能文件,或上传 importable/ 目录下的 .skill/.zip 归档。

如何使用这个 Agent?

安装后,直接向助手发出带技能引用的指令,例如:

Read skills/generateblocks-layouts/SKILL.md and create a testimonial slider with 3 cards

或典型发布流程:

Read skills/generateblocks-layouts/SKILL.md, then generate a testimonial grid with 3 cards and insert it as a new section at the top of /about on my staging site.

生成的标记可粘贴到区块编辑器的代码编辑器(Ctrl+Shift+Alt+M),需以具有 unfiltered_html 权限的用户操作且不要点"Attempt Block Recovery";自动化路径需先阅读 references/mcp-publishing.md,要求 MCP 服务器以不透明字符串读写原始 post_content,写入后用 verify_roundtrip.py 校验读回内容。始终先在测试站验证。

这个 Agent 有哪些优点和局限?

优点
  • 针对 GenerateBlocks 2.5.0/Pro 2.8.0 实测验证,build_css() 编译器与原生 Styles Builder 逐字节一致(1,453 个样式对象)
  • 参考文件极细粒度:27 个动态标签的精确语法、"Attempt Recovery" 错误的完整成因与修复、JSON 属性顺序等易错点都有明确规则
  • install.sh 一次命令支持 Claude Code、Cursor、Windsurf、Codex、Gemini CLI、Copilot、Cline/Roo、Aider 等多工具
  • 带 preflight.py 和 verify_roundtrip.py 校验脚本,能在写入前发现标记问题并在 MCP 写入后核对读回
局限
  • 锁定于 GenerateBlocks/GeneratePress 生态;不使用这些插件的站点无适用价值
  • 交互仅限 CSS 加 GB Pro 内置 JS 区块,不支持自定义 JavaScript、外部 URL 和非占位图片
  • 条件规则、表单动作、overlay 触发器等 UI 管理设置需在 wp-admin 手动配置
  • 通过 MCP 写入有真实风险:返回 200 的写入仍可能损坏区块,需逐字节校验读回内容

这个 Agent 与同类方案有什么区别?

作者的同类项目包括 bricks-skills(Bricks Builder JSON)、kadence-skills(Kadence Blocks)和 WordPress-skills(125+ 个 WordPress/设计/SEO 技能);MCP 发布路线对比中,Site Agent 被推荐用于 GenerateBlocks,另有 WordPress MCP Adapter、Novamira、WPVibe 和 Respira 等替代。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
GenerateBlocks Skills 当前 66 · 存在缺口 Agent 插件 / 技能免费 ★ 143 25 天前 PHP Codex · Claude Code
TermFold Debian 编程终端 62 · 存在缺口 桌面应用免费 + 模型费 ★ 36 1 个月前 Kotlin Codex · Claude Code
Agent Graph 53 · 缺口较多 自托管服务免费 + 模型费 ★ 239 5 天前 Python —
Mirafold 87 · 表现良好 命令行工具免费版 + 付费版 ★ 20 2 个月前 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
66/ 100 五分制 3.3 / 5
信任安全 18/29
可靠稳定 9/14
适用触发 14/18
规范维护 12/18
有效结果 9/13
证据核验 4/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

证据显示产品默认只读、文件输出,实时写入要求先读 mcp-publishing.md、快照 content.raw、写后原样读回,且明确'转换请求不等于发布授权';共享 Global Styles/Design Tokens 需显式 opt-in,Site Agent 的 PHP/文件工具默认关闭。扣分点:敏感数据处理仅提及 Application Password 与 unfiltered_html,无凭据存储/传输的系统说明;install.sh 未在包内,其行为无法静态审计;作者身份未经验证但标注清晰,未扣身份分。

可靠稳定9 / 14 · 3.2/5

各 SKILL.md、AGENTS.md、CLAUDE.md 之间版本号、加载规则、验证流程相互一致;独立转换包内嵌布局依赖,避免路径断链;recovery-rules.md 与 verify_roundtrip.py 按具体损坏类型命名失败原因。扣分点:一致性主要靠声明维护,脚本本体未在包内,静态审阅只能采信其描述。

适用触发14 / 18 · 3.9/5

覆盖静态区块、查询循环、ACF、条件、Pro 表单、整站模板及三类转换,并提供 Claude/Cursor/Codex/Gemini 等多客户端安装矩阵,并诚实注明'不保证每个客户端自动加载'。能力边界一节明确列出无外部 URL、无自定义 JS、占位图等限制,达到满分。扣分点:触发词列表存在但未见路由判定的冲突消解规则。

规范维护12 / 18 · 3.3/5

references/ 目录有 _index.md 路由器、紧凑 authoring-contract.md 与按需加载设计,信息架构清晰(3 分);Limitations 一节具体且可执行。扣分点:仓库本身许可证未标注(仅 Site Agent 标 GPL-2.0-or-later);维护责任为单一作者,无治理或社区支持路径;install.sh、build-bundles.sh、CHANGELOG 均不在包内,安装与变更记录只能依赖 README/Wiki 链接。

有效结果9 / 13 · 3.5/5

输出契约明确:写文件而非聊天、preflight.py 校验、真实编辑器复核、raw readback,可直接落地;深度参考按需加载控制 token 成本。扣分点:真实价值依赖生成块在目标站点的编辑器校验,包内静态证据只能证明流程设计合理而非结果可用;对作者其他产品(Site Agent 等)的交叉推广占用篇幅。

证据核验4 / 8 · 2.5/5

验证声明具体到可核对的程度(1,453 个样式对象、800 个未调参种子、native_css_2_5_0.json fixture、验证日期与环境),且有配套脚本与示例可复跑。扣分点:所有验证均为作者自述,无第三方或 CI 佐证(跨源佐证仅 1 分);future-dated 的 2026 验证记录无法在静态审阅中核实;README 基本区分事实陈述与推断(Figma skill 明确要求区分测量与推断),但推广段落与事实混排。

风险与缓解建议
  • 仓库未标注许可证,企业使用前先确认授权条款。
  • install.sh 不在审阅包内:运行前自行审读该脚本,注意它会覆盖目标规则文件(README 已提示先备份无关指令)。
  • 实时写入 WordPress 属高风险操作:务必先在 staging 验证,启用快照与 raw readback;未经授权不要让代理写入生产站点。
  • 所有'已验证'声明均为作者自述(含 2026 年日期),使用前应在自己的目标版本上复核。
  • README 含对作者自有产品的推广,采用 MCP 路线时可对比表中的中立备选(如官方 mcp-adapter 或纯 REST)。
证据充分度:低 评估于 2026年11月22日 审查版本 5ea1ab9f82e9
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/generateblocks-skills.svg?lang=zh)](https://followagents.com/zh/agents/generateblocks-skills)
<a href="https://followagents.com/zh/agents/generateblocks-skills"><img src="https://followagents.com/badge/generateblocks-skills.svg?lang=zh" alt="FARS 评测"></a>

常见问题

这项技能本身收费吗?
免费开源(插件源码 GPL-2.0-or-later,技能文档 MIT)。作者另有 Design Systems Library、AI Skills Library 等产品,但技能不依赖它们即可使用。
生成的标记如何进入真实站点?
两条路径:手动粘贴到区块编辑器的代码编辑器(需 unfiltered_html 权限),或通过 Site Agent 等能读写原始 post_content 的 MCP 服务器/REST 自动化。
哪些 AI 工具受支持?
安装器明确支持 Claude Code、Cursor、Windsurf、Codex CLI、Gemini CLI、GitHub Copilot、Cline/Roo Code 和 Aider;Codex 需按 wiki 指南做原生技能目录安装。
为什么区块在编辑器中显示"unexpected or invalid content"?
常见原因是可视化画布粘贴、wp_kses 过滤、parse_blocks 属性顺序漂移或点了"Attempt Block Recovery";recovery-rules.md 收录了全部已知成因及修复方法。
可以直接让 agent 写生产站吗?
不建议。文档强调始终先在测试站验证,Site Agent 对已发布页面的修改会先落地为可审阅的 autosave,PHP 执行等开发工具默认关闭。
GenerateBlocks Skills 官网是什么?
GenerateBlocks Skills 的 GitHub 仓库填写的官网是 https://gauravtiwari.org/tools/html-to-generateblocks-converter/。这个链接由仓库作者设置;源码在 GitHub(wpgaurav/generateblocks-skills)。
GenerateBlocks Skills 开源吗?
源码公开在 GitHub(wpgaurav/generateblocks-skills),但仓库没有声明通用的开源许可证,能不能复用、修改并不明确。在此基础上开发前,建议先看 README 或询问作者。
GenerateBlocks Skills 安全吗?
FollowAgents 的 FARS 评审(2026年11月22日)给 GenerateBlocks Skills 的“信任与安全”打了 18/29 分。评审检查的 8 项安全措施没有完全缺失的。
GenerateBlocks Skills 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-10-28,在最近 30 天内。
GenerateBlocks Skills 是谁开发的?
GenerateBlocks Skills 由 GitHub 账号 wpgaurav 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念