五个 Webflow 代理技能,让 AI 编码代理真正能够与 Webflow 合作

发布: (2026年2月24日 GMT+8 08:20)
10 分钟阅读
原文: Dev.to

Source: Dev.to

Vercel Skills CLI 输出,来自安装 224 Industries 的 Webflow Agent Skills

什么是代理技能?

代理技能是包含指令、脚本和参考文档的文件夹,AI 代理可以按需发现并加载——可以把它们视为知识包。当代理遇到缺乏上下文的任务时(例如,构建 Webflow Designer 扩展),它会读取相关技能并快速了解。

该格式最初由 Anthropic 开发并作为开放标准发布。现在它已被越来越多的代理产品支持,包括:

  • OpenAI Codex
  • Claude Code
  • Cursor
  • GitHub Copilot
  • Gemini CLI
  • OpenCode
  • Roo Code
  • Factory’s Droid
  • …and many others.

每个技能包含一个 SKILL.md 入口文件、参考文档和辅助脚本。代理会解析这些文件,以了解 API 的工作方式、应遵循的模式以及需要避免的错误。

为什么我们构建这些

224 Industries 是一家位于澳大利亚布里斯班的 Webflow 高级合作伙伴。自 2016 年以来,我们为技术和 SaaS 公司打造了营销网站,例如:

我们在工作流中每天使用 AI 编码代理。问题在于:Webflow 的 API 在其网站上有详尽的文档,但代理在编写代码时并没有这些文档在上下文窗口中。于是只能靠猜测,导致出现幻觉式的方法和错误的输出。

Agent Skills 解决了这个问题。 代理不再需要猜测 Webflow Designer API 的工作方式,而是可以在需要时准确读取结构化的参考文档。自从我们在内部使用这些技能后,团队的产出质量立刻提升,于是我们决定将其开源。

五项技能

webflow-designer-api

使用 Webflow Designer API——可以通过构建 Designer 扩展(嵌入在 Webflow Designer 中的 iframe)或为 Designer API Playground 生成代码片段来操作。涵盖内容:

  • 元素操作、样式、组件、页面、变量、资产
  • 错误处理、CLI 使用、UI 设计模式

这是我们使用最频繁的技能。它包含每个 webflow.* 方法的参考以及针对构建扩展与在 Playground 中原型设计的工作流专用指南。

webflow-browser-api

通过 Browser API 在 JavaScript 中控制 Webflow Analyze 和 Optimize。涵盖内容:

  • 全局 wf 对象
  • 同意管理(针对 OneTrust 和 TrustArc 的 CMP 集成)
  • 实验变体跟踪
  • 自定义访客属性

当需要管理跟踪同意、集成 CMP,或基于访客属性个性化体验时,此技能非常有用。

webflow-code-components

使用 DevLink 构建、定义并导入 React 代码组件到 Webflow。涵盖内容:

  • declareComponent 定义及全部 11 种 prop 类型
  • Shadow DOM 样式、Webpack 打包、SSR 行为
  • CLI 导入工作流

如果你在为 Webflow 构建自定义 React 组件,这项技能为代理提供完整的 DevLink 背景——从 prop‑type 定义到 Tailwind、Emotion、Material UI 等框架的特定样式指南。

webflow-webhooks

接收并验证 Webflow webhook。包括:

  • HMAC‑SHA256 签名验证
  • 所有 14 种事件类型及其负载模式
  • 仪表盘创建和 API 创建 webhook 的设置指南
  • 常见调试模式

该技能提供了带有正确签名验证和时间戳校验的 Express.js webhook 处理程序的可运行代码示例。

webflow-enterprise-api

仅限企业版的 API 端点,涉及工作区管理、审计日志、站点活动、301 重定向、robots.txt 配置以及常用文件。涵盖内容:

  • 所有端点、必需的作用域、分页

仅对 Webflow Enterprise 工作区相关,但它填补了代理在这些端点上几乎没有上下文的空白。

Source:

如何安装

最快的方式是使用 Vercel Skills CLI

# 安装全部五个技能
npx skills add 224-industries/webflow-skills

# 只安装一个
npx skills add 224-industries/webflow-skills --skill webflow-designer-api

# 查看可用的技能
npx skills add 224-industries/webflow-skills --list

如果你使用 Claude Code 或 Factory 的 Droid,可以将它们作为插件添加:

/plugin add 224-industries/webflow-skills

它们同样适用于 PlaybooksContext7 的 CLI:

# Playbooks
npx p ...

# Context7
npx c7 ...

(将省略号替换为相应工具的命令。)

Laybooks / Context7 安装

# Laybooks
laybooks add skill 224-industries/webflow-skills

# Context7
npx ctx7 skills install /224-industries/webflow-skills

结构概述

每个技能都遵循 Agent Skills 规范。目录布局如下:

skills/webflow-designer-api/
├── SKILL.md                    # 入口文件,包含概览和参考索引
├── references/                 # 详细的 API 文档、指南和示例
│   ├── elements-api.md
│   ├── styles-api.md
│   ├── components-api.md
│   └── …
├── scripts/
│   └── search_references.py    # 按标签或关键字搜索参考文档
└── assets/
    └── webflow-variables.css   # 设计系统变量

SKILL.md 文件充当目录索引。它为代理提供高级概览,并指明在何处可以找到详细的参考文档。代理通常先读取技能文件,然后根据手头任务拉取所需的具体参考资料。

每个参考文件都包含带有 namedescriptiontags 的 YAML 前置元数据,方便代理(以及人类)进行搜索:

python scripts/search_references.py --search "consent"
python scripts/search_references.py --tag "styles"

我们在构建这些时学到的

  • 简洁胜过详尽。 我们技能的早期版本太冗长。代理的上下文窗口有限,把每个边缘情况都塞进一个文件会让它们变慢且不够准确。将内容拆分为聚焦的参考文件,按需加载,产生了更好的结果。
  • 结构比散文更重要。 表格、代码示例和清晰的标题比解释性段落对代理更有用。代理更快解析结构化内容,并在能够对示例进行模式匹配时生成更准确的代码。
  • Front‑matter 有助于可发现性。 为每个参考文件添加标签和描述,使代理能够搜索所需内容,而不是阅读全部。每个技能中的搜索脚本进一步简化了这一过程。

贡献

该仓库接受贡献。如果您发现不准确之处、想添加更多示例,或对新的 Webflow 相关技能有想法,欢迎提交 PR。

您也可以使用随附的脚本来创建新技能的脚手架:

node scripts/add-skill.js ""

这将自动创建文件夹结构并更新所有清单文件。


常见问题解答

哪些代理支持 Agent Skills?

Agent Skills 格式受到 Claude Code、Cursor、GitHub Copilot(via VS Code)、Gemini CLI、Roo Code、OpenHands、Goose、Factory Droid 等众多代理的支持。兼容代理的完整列表可在 agentskills.io 查看。

使用这些技能需要 Webflow Enterprise 计划吗?

不需要。五个技能中有四个可在任何 Webflow 计划下使用。webflow-enterprise-api 技能覆盖仅 Enterprise 可用的端点,因此需要 Enterprise 工作区才能使用该技能。webflow-browser-api 技能则需要在站点上启用 AnalyzeOptimize 附加组件。

可以在没有 Claude Code 的情况下使用这些技能吗?

可以。Agent Skills 是开放标准,可在任何兼容的代理上使用。您可以根据所使用的代理,通过 npx skills CLI、Playbooks 或 Context7 来安装它们。

这些技能是 Webflow 官方维护的吗?

不是。这些技能由 224 Industries 构建并维护,224 Industries 是 Webflow 高级合作伙伴。参考内容来源于 Webflow 官方文档,并由我们的团队保持最新。

npx build‑skill

使用 npx build‑skill 构建您自己的 Agent Skills。


Memberstack Agent Skills

Memberstack Agent Skills 集成到 Memberstack CLI 以及 Memberstack 生态系统的其他部分——这是在 Webflow 和 Memberstack 上构建的开发者的完美技能。

Ben Sabic 构建,224 Industries 的兼职 CTO

0 浏览
Back to Blog

相关文章

阅读更多 »

没人想负责的 Systemd Bug

TL;DR:存在一个命名空间 bug,影响 Ubuntu 20.04、22.04 和 24.04 服务器,导致随机服务故障。自 2021 年起已在系统中报告……