GenerateBlocks Skills
为 GenerateBlocks V2/Pro 提供 LLM 优化的 Agent 技能,让 AI 编码助手生成可通过 MCP 直接发布到 WordPress 站点的合法区块标记。
- Star 数
- ★ 143
- 最近更新
- 25 天前
- 主语言
- PHP
- FA 评分
- 66/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 GenerateBlocks V2/Pro 搭建页面的 WordPress 开发者,想让 Claude Code 直接生成英雄区、定价表、FAQ 等区块标记
- 不适合
- 不使用 GenerateBlocks/GeneratePress 的 WordPress 站点
- 需要交互依赖自定义 JavaScript 而非 CSS 的项目
- 没有支持 agent 的编辑器或 CLI、只想手动建站的用户
- 官网
- gauravtiwari.org ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-10-28
- 源码审查
- 66/100 · 存在缺口
这个 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> 校验。
- 使用 GenerateBlocks V2/Pro 搭建页面的 WordPress 开发者,想让 Claude Code 直接生成英雄区、定价表、FAQ 等区块标记
- 要从 Elementor 或 Figma 设计迁移到干净 GenerateBlocks 区块的团队
- 用 ACF repeater 字段(如 team_members)生成动态团队网格或查询循环的站点维护者
- 通过 Site Agent MCP 插件让 agent 把生成的区块直接写入线上或测试站页面的发布流程
- 需要 GeneratePress Elements 循环模板、FSE 模板等全站模板的建站者
- 要为 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 codexClaude 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?
查看各维度的扣分理由
证据显示产品默认只读、文件输出,实时写入要求先读 mcp-publishing.md、快照 content.raw、写后原样读回,且明确'转换请求不等于发布授权';共享 Global Styles/Design Tokens 需显式 opt-in,Site Agent 的 PHP/文件工具默认关闭。扣分点:敏感数据处理仅提及 Application Password 与 unfiltered_html,无凭据存储/传输的系统说明;install.sh 未在包内,其行为无法静态审计;作者身份未经验证但标注清晰,未扣身份分。
各 SKILL.md、AGENTS.md、CLAUDE.md 之间版本号、加载规则、验证流程相互一致;独立转换包内嵌布局依赖,避免路径断链;recovery-rules.md 与 verify_roundtrip.py 按具体损坏类型命名失败原因。扣分点:一致性主要靠声明维护,脚本本体未在包内,静态审阅只能采信其描述。
覆盖静态区块、查询循环、ACF、条件、Pro 表单、整站模板及三类转换,并提供 Claude/Cursor/Codex/Gemini 等多客户端安装矩阵,并诚实注明'不保证每个客户端自动加载'。能力边界一节明确列出无外部 URL、无自定义 JS、占位图等限制,达到满分。扣分点:触发词列表存在但未见路由判定的冲突消解规则。
references/ 目录有 _index.md 路由器、紧凑 authoring-contract.md 与按需加载设计,信息架构清晰(3 分);Limitations 一节具体且可执行。扣分点:仓库本身许可证未标注(仅 Site Agent 标 GPL-2.0-or-later);维护责任为单一作者,无治理或社区支持路径;install.sh、build-bundles.sh、CHANGELOG 均不在包内,安装与变更记录只能依赖 README/Wiki 链接。
输出契约明确:写文件而非聊天、preflight.py 校验、真实编辑器复核、raw readback,可直接落地;深度参考按需加载控制 token 成本。扣分点:真实价值依赖生成块在目标站点的编辑器校验,包内静态证据只能证明流程设计合理而非结果可用;对作者其他产品(Site Agent 等)的交叉推广占用篇幅。
验证声明具体到可核对的程度(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)。
常见问题
这项技能本身收费吗?
生成的标记如何进入真实站点?
哪些 AI 工具受支持?
为什么区块在编辑器中显示"unexpected or invalid content"?
可以直接让 agent 写生产站吗?
GenerateBlocks Skills 官网是什么?
GenerateBlocks Skills 开源吗?
GenerateBlocks Skills 安全吗?
GenerateBlocks Skills 还在维护吗?
GenerateBlocks Skills 是谁开发的?
谢谢反馈,我们会据此改进页面。