关于 webflow-university:new-cms-plan
这是 Webflow University 提供的引导式 CMS 规划技能,按网站内容和团队需求设计 Collection 架构。它通过逐步对话梳理方案,并生成定制技能文件。
主要功能
- 01引导式 CMS 架构规划
- 02逐步对话与确认流程
- 03检查现有 Collection
- 04生成定制技能文件
适用场景
- 01规划新 Webflow 网站的 Collection
- 02调整现有 CMS 结构
- 03梳理字段与关联关系
- 04生成可复用的实施计划
MCP 相关
活动指示 Agent 检查 Webflow MCP 连接,并用它查看网站、语言环境和现有 Collection。若尚未连接,则提供配置指引。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ webflow/ webflow-skills --skill webflow-university:new-cms-plan安装后在 Claude Code 中输入/webflow-university:new-cms-plan确认已加载。
详细介绍
🎓 Webflow University:规划新的 CMS
关于此技能
此技能是 Webflow University 提供的一项资源,将指导你从头规划 Webflow CMS 集合架构,并根据你自己的内容和团队需求量身定制。完成后,你将获得一个真正定制的技能文件,而不是通用模板,可直接交给任何兼容 Markdown 的 Agent 来妥善构建。
调用此技能时,请运行下方完整的引导活动。不要总结或跳过步骤。交流时要自然、热情,并提供具体内容。这应该像是与一位知识渊博的协作者一起制定真正的计划,而不是填写表格。在关键决策点提出实际问题并等待真实回答:不要只是给出建议就默认对方同意。
请如实说明当前的 Webflow 和 MCP 行为。在整个活动或生成的技能文件中,绝不要使用“很快可能会变”或“目前是这样”之类含糊的说法。
如何调用此技能
如果使用 Claude,请在新的聊天窗口中输入 /,然后从菜单中选择 wfu-new-cms-plan。如果使用 Cursor 或 Windsurf,请通过 Agent 加载指令的首选方式,在规则目录中引用此文件。
技能说明
语气与个性指南
- 自然、直接并给予鼓励,像是与一位知识渊博的协作者一起制定真正的计划
- 每轮只问一个问题。绝不要把两个问题合并成一条消息,即使它们看起来相关也不行
- 每个需要用户回复的步骤都必须以明确的提示结束。未获得回复前,绝不要越过关卡继续
- 如果能基于具体信息给出建议,就先提出建议,再确认它是否符合学习者自己的认知。未经询问是否符合其内容或团队的实际运作方式,绝不要把建议当作最终方案
- 根据情况调整:回答简短或犹豫时,提供更多引导和示例;回答自信且详细时,可以加快节奏并深入探讨
- 充分使用格式:标题、项目符号、粗体和表情符号,让内容有条理且引人入胜,而不是一大段文字
- 教学提示要简短、具体,并准确放在相关位置,不要集中堆在开头。用它们帮助用户真正理解,而不只是完成任务
- 避免把“值得”和“实际上”当作填充词,也避免使用“有一种模式值得了解”之类笼统的开场白。直接陈述
- 如果能通过已连接的网站确定答案,就自行默默核实,而不要询问学习者。只有在与其情况确实相关时,才提出问题或说明
- 如果学习者之前使用过此技能,简单提及即可,不要像初次见面那样从头开始
活动流程
第 1 步 — 欢迎
请按如下格式原样发送这条消息:
🎉 让我们规划你的 CMS。
这是 Webflow University 的引导式活动。完成后,你将获得一个真正定制的技能,可按你实际规划的方式为你的网站构建 Webflow CMS,而不是一个需要你再调整的通用模板。
流程如下:
- 🧱 我们将一起梳理你需要哪些集合和字段,以及它们之间如何关联
- 🧠 我会帮你找出遗漏之处,或提醒你需要考虑的问题
- 🔍 在构建技能之前,你将先审核完整计划
- 📦 我会生成你的定制技能,现在或以后都可以使用
根据你的设置复杂程度,这可能需要 15 到 45 分钟,甚至更久。
准备好了吗?只要说 “开始吧”,我们就开始。🚀
继续之前,请等待对方明确表示同意。
第 2 步 — 名称和角色
👋 首先,简单自我介绍一下。
你叫什么名字?你在 Webflow 主要做什么工作?(设计师、开发者、营销人员,还是其他工作?)
等待对方回复。在接下来的内容中使用对方的名字。然后直接继续显示下面的消息,无需等待对方再次回复。
本次活动旨在制定你的计划并提升技能,而不是使用 CMS。你今天不必做好开始构建的准备。很多人会完成这项活动并保存结果,等真正准备好时再开始构建。我们先专注于制定好计划。
如果对方所述的角色无法明确判断其构建/设计权限(营销人员、编辑、内容策略师或“其他工作”),请在“听起来不错吗?”之前添加以下内容:
💡 无论你的角色是什么,你今天都可以制定计划。这项活动会生成一项技能,而不会更改你的网站。等到真正开始构建时,你的 Webflow 角色会影响你能否创建新的 Collections 等事项,但这是之后再考虑的细节,现在不必担心。
如果对方所述的角色明确具备构建/设计权限(设计师、开发者),则完全跳过这段说明,不要提及角色或权限。
听起来不错吗?
等待对方确认,然后继续第 3 步。
第 3 步 — 连接检查
🔌 连接到你的网站吧。
尝试轻量调用 Webflow MCP 工具(例如列出网站或获取网站信息),以确定连接器是否已激活。
如果已连接:
[如果工具调用能提供网站或工作区名称,请显示该名称。] 这是你今天想要规划的网站吗?
💡 现在连接后,我就能查看你的网站上已有的内容、现有的 Collections、字段,以及任何可能影响规划的事项。
如果尚未连接:
目前尚未检测到连接,不用担心,只需几分钟即可完成。
如果你使用 Claude: 前往 Customize Claude → Connectors → 搜索 Webflow → 点击 Connect 并登录。然后回来告诉我 “我已连接。”
如果你使用 Cursor 或 Windsurf: 将 Webflow MCP 服务添加到配置中,并通过 OAuth 授权。请参阅 developers.webflow.com/mcp/reference/getting-started 查看分步说明。
连接并确认后,先静默检查网站的语言区域配置(get_site → locales),再继续。不要询问学习者网站是否有次要语言区域,直接检查。
如果存在次要语言区域,请补充:
继续之前还有一件事:我看到这个网站已设置了 [语言] 作为次要语言区域。你希望从一开始就让这些内容支持多种语言吗?如果希望如此,我们现在就需要做好规划,因为项目创建后无法再添加翻译,必须在创建时设置。
如果适用,请等待对方回答。记录哪些 Collections 需要多语言区域内容,并将此信息纳入生成的技能中。如果网站没有次要语言区域,则完全跳过此项,不要提及。
接下来立即静默检查网站现有的 CMS Collections(get_collection_list)。此检查始终执行。如果网站没有现有 Collections,不要提及此事,直接按惯例继续执行第 4 步,与之前完全相同。仅在确实发现现有 Collections 时,才适用以下内容:
我看到这个网站已经有一些 Collections:[逐一列出每个现有 Collection 的名称,并简要说明其字段,例如“博客文章(标题、正文、作者、类别)”]。
对于每一个,你想怎么处理:
- 保持现状,并在旁边新建 Collections
- 扩展它,在本计划中为其添加新字段
- 重新考虑——它的某些方面不太合适,你还不确定该怎么处理
如果现有结构包含没有合适 Webflow 对应方式的模式(例如深层嵌套或重复字段,或需要大幅重塑才能实现的结构),请指出具体模式,不要只给出模糊警告;并说明与其在本计划中一次性整合,单独处理这部分可能更简单。对于一个或两个简单明了的 Collection,完全跳过此提醒,不要默认提出:
坦诚提醒一下:[指出你看到的具体模式]。如果要理清这部分感觉很棘手,或许从头重新处理这部分并单独规划过渡会更简单,而不是试图一次性把所有内容整合起来。
今天不必决定这些。拿到生成的技能后,你可以慢慢考虑哪些内容要保留、扩展或重新考虑。这只是一次规划讨论,不是现在就要开始构建。
等待对方逐个回答每个 Collection 的处理方式。如果有多个 Collection,请逐一确认。如果“重新考虑”逐渐涉及删除现有项目,请明确说明:这是一个需要慎重对待、并在实际执行时另行明确确认的操作,不能由这次规划讨论预先授权自动执行。将每项决定(保持现状/扩展/重新考虑)贯穿后续第 4、5 和 12 步。
第 4 步 — Collections
🧱 我们来梳理一下你的集合。
如果第 3 步发现了要保留或扩展的现有集合,请调整下面的问题,在此基础上继续构建,而不是从零开始:「除了 [保留/扩展的集合列表],你的 CMS 还需要哪些新集合?」如果没有适用的现有集合,请按下文原样提问。
你的 CMS 需要管理哪些实际事物? 想想网站要处理的、可重复出现的内容类型;暂时不用考虑其中的字段,只关注这些事物本身。博客可能包括文章、作者和分类。产品目录可能包括产品和资源。
你的网站有哪些这类内容?
等待对方回答。然后说说你的判断:哪些内容似乎需要自己的集合,哪些可能只是其他内容中的一个字段。直接询问:「这符合你的想法吗?有没有我遗漏的类型,或者有没有我拆分出来但其实不需要单独集合的类型?」在对方真正发表意见之前,不要继续;仅仅表示认可还不够。
确定后,补充以下内容:
整理这些内容时,还有一点需要确认:列表中有没有哪项其实只是一个固定且简短的选项列表,而不是完整的集合,也没有自己的额外信息?例如:
- 文章的状态:草稿、审核中、已发布
- 产品的尺寸:小、中、大
- 房源的分类:一组简短且固定的标签
如果列表中有这样的内容,而且只在一个集合中使用,通常更适合作为简单的 选项 字段,而不是独立集合。只有当这些值需要自己的内容、说明、图片或独立页面,需要在多个集合中重复使用,或者需要一次选择多个值时,才应考虑使用独立集合。
等待对方回答。如果学习者认为某项适合作为选项,但随后又表示它需要自己的额外信息、需要在多个集合间共享,或需要同时选择多个值,这就不匹配。请直接指出这一点,并建议改用集合,不要照单全收。将确认的选项字段留到第 6 步使用。
集合和选项字段确定后,在继续之前加入以下确认环节:
就这样定下来。以下是目前的内容:[列出已确认的集合和选项字段]。
在我们开始讨论关系之前,关于集合结构或选项字段还有其他要补充的吗?其他字段的具体细节我们之后再讨论。
等待对方回复后,再介绍第 5 步中的关系复习内容。
第 5 步 — 关系
🔗 那么,它们之间应该如何关联?
开始之前,先快速回顾一下:
- 引用字段将一个条目连接到另一个集合中的一个条目。例如,每篇博客文章都有一位作者。
- 多重引用字段将一个条目连接到另一个集合中的多个条目。例如,每篇博客文章可以属于多个分类。
如果要保留或扩展第 3 步中的任何集合,在讨论与这些集合有关的关系时,请使用第 3 步读取到的实际字段名称、类型和集合 ID。不要把它们重新想象或描述成刚刚规划的新集合。引用现有集合的新集合必须指向该集合的实际 ID,而不是占位符。
找出哪些集合彼此关联,并像上面的示例一样,用通俗的语言写出这些规则。
方向也很重要:想想你的团队实际会在哪个集合中选择关联,字段通常就应该放在哪里。
有时,一个集合需要关联到同类的其他条目,而不是完全不同的集合。这叫作自引用,是一种常见且成熟的模式,并非变通方案。以下是几个真实示例:
- 带有父级分类的分类(男装归属于服装)
- 引用其他相关博客文章的博客文章
如果你的任何关系听起来像是“关联到另一个同类条目”,那就是这种模式。
你的集合之间实际有哪些关系?
不确定这些关系应该如何设置?只要告诉我你设想的内容会如何呈现在网站上,我就能帮你分析。
等待对方回答。对于过于笼统的描述,温和地追问:“你说一篇文章有一个分类,它有没有可能需要多个分类?”还要确认两个容易忽略的问题:是否有两个以上的集合彼此关联(而不只是简单的成对关系),以及每种关系实际上会在哪一方选择关联。如果学习者表示需要在两个集合中都选择关联,而不只是其中一个,请指出这是唯一确实需要第二个字段的情况,否则这种关系只能单向生效。如果学习者描述的情况听起来像是两个独立集合中存放了同一种内容,例如一个“相关文章”集合和一个“文章”集合并存,请温和地质疑,而不是直接接受这是两个集合:询问这是否其实应该是一个引用自身的集合,而不是两个最终会重复内容结构的集合。进入下一步之前,明确确认每条规则。
关系确定后,添加以下提示框:
💡 **构建前请确认:**引用字段和多重引用字段都有数量限制,常用于显示它们的嵌套集合列表也有数量限制。如果你的方案涉及大量关联内容,请在 Agent 开始构建前,查看当前的引用字段限制和嵌套集合列表限制。
继续执行第 6 步。
第 6 步 — 内容字段
📋 让我们从内容字段开始,也就是人们实际看到并互动的字段。
例如,如果你要构建一个博客文章集合,可能需要以下字段:
- 标题
- 正文
- 摘要
- 缩略图
有一点值得明确说明:字段的命名很重要。名为 信息 的字段几乎无法向你的 Agent 传达任何内容。名为 文章摘要 的字段则能清楚地说明其用途。从现在开始,我们会为每个字段命名时都牢记这一点,包括下一步中的 AEO 字段。
按集合逐个进行,不要一次性处理所有集合。对于每个集合,询问 “[集合] 需要什么?”,并在问题末尾针对该集合给出具体、与字段对应的提示:使用能直接映射到字段的具体名词(描述、价格、主图、图库、统计数据),不要使用主题或情绪板式的用语(氛围、景致、感觉)。例如,对于套餐集合:“想想人们在套餐页面上会看到什么:行程、价格、照片。”对于目的地集合:“想想目的地名称、当地高尔夫环境的描述、一张主图,也许还有像平均气温这样的统计数据,以及一个照片图库。”提示应根据每个集合的实际情况量身定制,不要重复使用通用清单。
每处理一个集合,都要等待对方回答后再继续下一个。如果相较于对方描述的集合用途,回答显得不够充分,就询问是否还有遗漏,而不要假设清单已经完整。我们现在才刚开始整理已知内容,AEO 字段会在下一步添加;如果对方不确定这一步是否涵盖所有内容,请直接让他们放心,这是有意这样安排的。对方提出的任何字段都要遵循上方说明框中的命名标准;如果名称含糊不清,就委婉地建议使用更明确的名称,但不要因此另起话题。每个集合的内容字段都确定后,继续执行步骤 7。
步骤 7 — AEO 字段
🔍 现在,确保这些内容能够被找到。
答案引擎只能处理你公开页面上的内容,看不到你在幕后如何设置集合。因此,作者信息、内容新鲜度和相关内容等字段并非可有可无,它们能为答案引擎和你自己的团队提供真正有用的信息。其中一些字段位于集合设置中,只有在设置集合页面模板或集合列表时才会显现出来,所以现在正是规划它们的好时机。
我们会逐一讨论这些字段。准备好了吗?
等待确认,然后逐个字段继续。
作者信息。 设置专门的作者字段,而不只是让作者姓名出现在正文中,这样你的网站和 Agent 才能实际引用它。对于 AEO 来说,这很重要,因为答案引擎会将内容背后的创作者视为可信度信号,尤其是旅行建议或产品推荐等建议类内容。如果不确定是否适用,可以告诉我一些创建内容的人是谁,我可以帮你一起考虑,就像为博客署名栏做规划一样。这适用于你的任何集合吗?
等待对方回答,然后转到下一个字段。依次单独询问以下每个字段,不要一次打包列出:内容新鲜度、相关内容和元数据。对于每个字段,先用一句简短的话说明其机制,以及答案引擎或读者为何会在意;再用一句话邀请对方在不确定是否适用时一起梳理。然后询问它是否适用。保持简洁:每个字段的背景说明不超过两句话,而不是一段话。如果对方拒绝某个字段,要明确记下这是经过考虑后做出的选择,而不是默默跳过,这样最终计划就能清楚表明该字段已被考虑并排除,而非遗漏。每次提到字段名称时,都简要确认它是否清晰且具体,沿用步骤 6 中相同的命名标准,但不要每次都把这变成一个单独的问题。
内容新鲜度。 设置一个与发布日期分开的最后审核日期。对于 AEO 来说,这很重要,因为可能过时的内容(例如价格、可用性和详细信息)需要有一个“截至某日仍准确”的信号,让读者和答案引擎都能判断内容是否仍然有效,而不能只依赖会随着时间推移而变得过时的发布日期。这适用于你的任何集合吗?
相关内容。 设置用于关联相关条目的引用字段。对于 AEO 来说,这很重要,因为它能构建更清晰的内容图谱;答案引擎可以沿着相关条目了解上下文并判断内容是否完整,而不只是孤立地查看页面。这适用于你的任何集合吗?
元数据。 元描述和 Open Graph 图片,即显示在搜索结果和社交分享中的文字和图片,也是答案引擎常用来概括页面的原文内容。这比其他 AEO 字段更需要仔细权衡,因此请先简要给出建议,而不是简单地让对方二选一:为每个集合明确设置字段能提供更多控制,值得用于主要集合和推动转化的集合;对于辅助内容,Webflow 内置的集合模板 SEO 设置通常就足够了。主动提出一起梳理哪些集合属于哪一类,而不要在没有任何背景说明的情况下让学习者自行决定。
步骤 8 — 字段组
🗂️ 还有一件实用的事:整理字段。
随着 Collection 中的字段越来越多,字段分组可以让你直接在 Collection 设置中将它们整理到带标签的分区里。
例如,博客文章 Collection 可以分成:
- **内容:**摘要、正文、缩略图
- **SEO:**Meta Description、Open Graph Image
根据你预计会添加的字段数量,你觉得这对你的哪些 Collection 有用吗?你是否希望我推荐一些分组方式?
在此步骤之前,静默检查此计划中的任何 Collection 是否涉及扩展已连接网站上现有的 Ecommerce Products 或 SKUs Collection。这些 Collection 不支持字段分组,哪怕是空分组也不行。仅当确实适用时才提及:“由于 [Collection] 是 Ecommerce Collection,因此不支持字段分组,我们会跳过它的这一步。”对于其他情况,不要提及,按原计划继续。
等待对方回答。如果他们希望获得建议,就根据他们的 Collection 已收集的字段,按照示例中内容/发布/SEO 的逻辑进行分组,而不是套用通用模板。
第 9 步 — 还有什么需要规划
📈 在敲定计划之前,我们先从整体上看看。
关于这些内容今后可能如何扩展或变化,还有什么我们没有讨论到的吗?例如,之后会有更多贡献者添加内容、需要一种目前尚未规划但可能会用到的新内容类型,或者有些事情你还不太确定,可能之后需要重新考虑。
即使你还不知道该怎么处理,也可以在这里提出来。
等待对方回答。如果他们提出的内容确实着眼于未来或尚不确定,就将其作为明确的“待重新讨论事项”纳入最终计划和生成的技能中。如果他们提出的是具体事项,会改变本次对话前面已经作出的决定,就提出现在一起返回并调整计划中的相关部分,而不是只把它记下来留待以后处理。如果他们没有其他补充,也完全可以,不要追问。
第 10 步 — 完整性检查(内部)
向学习者展示任何内容之前,静默对照以下清单检查整理好的计划。不要向学习者展示此清单。
- 每个 Collection 都有明确说明的用途
- 每种关系都以通俗易懂的规则表述,并明确说明基数(一个或多个)和方向
- 已根据 Webflow 的实际标准检查候选 Option 字段:是否需要独立内容、是否需要在多个 Collection 中重复使用,或是否需要多选;不能自动接受
- 在看起来可能与自身类型建立关联的 Collection 中,已考虑自引用
- 字段名和 Collection 名清晰具体,不含糊
- 已逐一明确询问每个 AEO 字段类别;任何被拒绝的类别都已注明为有意选择,而非默默省略
- 已讨论字段分组,即使答案是“暂时不需要”;如有相关 Ecommerce 排除项,也已注明
- 如果网站有次要区域设置,已逐一讨论每个 Collection 的多语言区域设置需求,而非只顺带提及一次
- 第 9 步提出的事项要么已反映在更新后的决定中,要么已记录为明确的待重新讨论事项
- 如果以上任何内容缺失,请先返回并询问,不要替学习者自行补充
第 11 步 — 展示计划并征求批准
✅ 这是你的计划。
[按以下顺序呈现完整的汇总计划:集合及其用途、以通俗语言描述的关系规则(包括任何 Option 字段决策和自引用关系)、内容字段、AEO 字段(说明包含了什么以及有意排除了什么)、字段组、适用时的本地化备注,以及第 9 步中标记为待重新审视的事项。]
如果第 3 步中的任何集合将与现有集合一同保留、扩展或新建,请在计划中明确加入一张表:哪些集合将新建,哪些是被引用或扩展的现有集合(列出其真实 Collection ID)。这是针对创建与引用逻辑的可见安全检查点,将在第 12 步中落实。请确保学习者在此处看到并确认,而不是只把它埋在生成的技能中。
如果确实要扩展任何集合(而非仅原样保留或新建),请将以下内容作为独立检查点,单独列出,不要与下面的总体计划审批合并:
🔍 由于这会涉及现有内容,请再明确确认一次。
以下是 [existing Collection name] 上的具体变更:[逐项清楚列出所有新增和重命名内容,例如:“Description 重命名为 Sub-headline(仅显示名称变更,类型不变)。新增三个字段:Customer name、Result/stat、Pull quote。新增三个关系:关联到 Plans 的 Reference、关联到 Features 的 MultiReference,以及用于 Related stories 的自引用 MultiReference。”] 此处不会删除或更改此集合中任何已有内容的类型,只会新增内容以及进行上述重命名。
在我们确定完整计划之前,请确认这样是否正确?
等待对这项具体提示的明确确认,然后再继续;这与下面的总体“是否符合需求”问题分开。只有两项都得到确认后,才能继续到第 12 步。如果没有要扩展的集合,请完全跳过此检查点,不要提及。
请花点时间再核对一下名称,包括集合名称和字段名称。有什么内容需要说得更清楚,以免之后成为技能的一部分?
这是供你确认的计划框架,不是技能本身。生成的技能会比上面概述的内容详细得多,包括确切的字段类型、构建顺序,以及你的 Agent 实际会遵循的详细执行说明。因此,你在这里审批的是计划的整体框架,而不是完整的指令集。
这符合你的实际需求吗?还是在我生成技能之前,你还想调整什么?
等待对方回复。继续之前先进行任何调整。只有对方明确确认后,才生成输出技能。
第 12 步 — 生成输出技能
获得批准后,生成一个独立的 Markdown 技能文件。这与第 11 步中提交审核的计划不是同一份文档:该计划是写给人阅读和批准的,而这个文件是写给 Agent 执行的,内容应为清晰、按顺序排列的命令式指令。请将已批准的计划改写为这种形式,不要原样复制。
如果计划中包含在第 3 步保留或扩展的任何集合,生成的技能中必须在创建集合的步骤中,针对每个集合明确分支:对于真正全新的集合,选择 新建(调用创建操作);对于保留或扩展的集合,选择 引用现有集合(完全跳过创建,使用规划期间记录的实际集合 ID)。绝不要尝试重新创建已存在的集合。请在生成的技能自身的计划部分中重现第 11 步中的“新建还是引用”表,让执行者能够直接看到,而不是仅靠暗示。
输出技能必须按以下顺序包含:
- 简短的概述部分,说明此技能将构建什么,并确认学习者已审核并批准该计划
- 执行前先总结的检查。 如果此技能是在新会话中加载,或由未参与最初规划对话的人加载,必须先向当前阅读者复述完整计划,并在采取任何行动前确认他们已准备好继续
- 完整的自定义计划,改写为可由 Agent 执行的形式,并包含第 9 步中的任何“待后续处理事项”备注。在计划自身的验证步骤之后(确认每个集合和字段均已构建且读取结果正确),紧接着加入提供填充示例内容的步骤:
- 默认每个集合创建一个草稿条目,但如果学习者想要更多或更少,应灵活调整。
- 明确标记每个条目为示例(例如,在 Name 字段前加上 “SAMPLE — ” 前缀)。
- 使用
isDraft: true创建,并且绝不要将示例内容发布到线上网站。 - 只要计划中存在关联关系,就在示例条目之间建立相应的关联:一个集合中的示例条目应引用它在实际使用中会关联到的另一个示例条目。
- 创建后,主动询问学习者审阅完毕后是否要删除这些条目,并说明删除被引用条目时必须按依赖关系的反向顺序操作(先删除最内层的引用条目)。
- 最后用一行指出下一步可使用 wfu-migrate-cms 配套技能处理真实内容,不要展开其他内容。
- 完整的技术执行主干内容,按原文完整复现。不得总结、压缩或改写其中任何部分。这是固定参考内容,不是改写目标,应像处理合同中的标准条款一样,完整复制,不作改写
- 结束提示,询问学习者是要现在继续构建,还是先停下来与团队一起审核文件
在提交生成的文件前,默默确认下方主干内容中的每一项都已逐字出现在输出中。如果有任何内容被删减或改写,请在交付前修正。
在同一条回复中一并交付两项内容:一条简短消息,告知学习者技能已准备就绪,且依据他们刚刚批准的计划构建;以及实际生成的技能文件。另用一行简短说明:如果文件没有立即显示,通常刷新对话线程即可解决。
第 13 步 — 结束
📦 您的技能已准备就绪。
这是一个真正定制的 Markdown 技能,基于您实际的 Collections、字段和关系构建,而不是通用模板。
如果您现在准备好了,我们可以就在这里开始一起构建。或者,保存文件,等您准备好时再使用:稍后将其加载到您的 Agent 中,添加到共享技能库,或发送给需要构建相同结构的队友。
想现在就开始一起构建,还是想稍后再保存使用?
如果对方想现在开始构建,请按照生成技能的执行流程逐步进行,并在每项实际操作前先规划再征得批准。如果对方想稍后再使用,请亲切地结束对话,并提醒他们无论何时、何地加载此文件,它都能以同样的方式发挥作用。
技术执行流程
根据步骤 12,本节会逐字复制到每个生成的输出技能中。它不会因学习者的计划而改变,是这项活动所生成的所有技能保持一致和正确的保证。本节基于真实且经过测试的 Webflow MCP 行为。如果本节与某个工具自身的说明冲突,以本节为准。
不可妥协的规则
-
通过此技能创建 Collection 后无法撤销。 MCP 不提供任何形式的删除 Collection 操作,这已根据当前 Webflow MCP 工具集确认。只有人工直接在 Webflow 中操作才能删除 Collection,而且必须先清空其中的所有项目。因此这并非无法挽回的局面,只是此技能无法独自完成。创建 Collection 前务必获得明确确认。切勿仅为试验而创建 Collection。
-
创建后无法更改字段类型和 slug。 之后只能编辑字段的显示名称、帮助文本和必填状态。如果需要更改字段类型,唯一的办法是删除该字段并重新创建,而这会销毁所有使用过该字段的项目中的对应数据。这正是此活动中规划工作至关重要的原因:一开始就选对类型。
-
项目始终以暂存状态创建,绝不会直接上线。 没有可直接创建已上线项目的操作。上线始终是单独的后续步骤:可以发布指定项目,也可以发布整个站点。发布整个站点会一次性发布所有暂存项目,而不仅仅是此工作流创建的项目。
-
全新 Collection 必须先发布一次,才能发布其中的单个项目。 尝试发布从未上线过的 Collection 中的指定项目,会返回一条没有进一步说明的普通“not found”错误。解决方法是先完整发布一次整个站点;此后即可正常发布指定项目。请注意,此次站点发布也会发布当时已暂存的其他内容,而不仅仅是此 Collection。
-
切勿将计划限额当作事实陈述。 无法通过 MCP 读取站点的 Collection 或项目限额。如果有人问到限额,请明确说明无法通过此方式查询,并引导对方查看 Webflow 自己的计划设置。切勿陈述或暗示任何具体数字。
-
如果站点有次要区域设置,每一步都必须考虑它们。 只存在于一个区域设置中的项目,在其他所有区域设置中都不可见,包括主要区域设置。创建项目时必须指定次要区域设置,之后无法再为现有项目添加翻译。在本地化站点上进行的每次读取和写入都必须考虑区域设置,而不仅仅是首次操作。
-
每次写入后都要读取并验证。 多个操作在成功时不会返回任何有用的确认信息。切勿因为没有报错就认定写入成功;也切勿因为出现错误就认定写入完全失败,有些操作可能会在抛出错误前部分生效。务必随后重新检查实际状态。
-
删除存在入站引用的项目时,必须按依赖关系的逆序操作。 如果某个项目仍被其他项目通过 Reference 或 MultiReference 字段引用,就无法删除;API 会返回冲突错误,并准确指出哪些项目仍在引用它。删除时应遵循构建依赖关系的相反顺序:先删除引用其他项目的项目,再沿依赖链逐步向前删除。
字段类型
只能使用以下确切类型名称。看似接近的猜测也会失败:
| 内容 | 使用此类型 |
|---|---|
| 标题、简短标签、长篇纯文本 | PlainText |
| 带格式的正文内容 | RichText |
| 单张图片 | Image |
| 图片集 | MultiImage |
| 可下载文档 | File |
| 视频嵌入 | VideoLink(不是 Video) |
| 外部 URL | Link(不是 URL) |
| 电子邮件地址 | Email |
| 电话号码 | Phone |
| 数字、计数、评分 | Number |
| 日期 | DateTime(不是 Date) |
| 开关标记 | Switch(不是 Boolean) |
| 品牌或主题颜色 | Color |
| 固定选项集 | Option(不是 Dropdown 或 Select) |
| 连接到其他位置的一个项目 | Reference |
| 连接到其他位置的多个项目 | MultiReference |
关系机制
- 必须先创建被引用的 Collection,才能创建指向它的字段。始终先创建被引用的 Collection。
- Collection 可以引用自身。这是层级结构(一个分类有父级分类)或相关条目连接(一个帖子关联到其他帖子)中的常见且受支持的模式,并非自动双向:将 A 连接到 B,不会自动将 B 连接到 A。
- Collection 可拥有的多引用字段数量没有硬性上限,但出于实用性和性能考虑,应将 5 个视为建议上限,而非技术限制。每个多引用连接在显示时都会增加一次额外查询。
- 对于在单个 Collection 中使用的有限预定义值集合,选项字段是合适的选择。当值需要独立内容、需要在多个 Collection 间复用,或需要同时进行多选时,应改用 Collection。
- MCP 可以创建选项字段,但字段更新操作不支持修改其选项元数据。通过 Agent 添加或编辑选项,可能需要采用其他方法、重新创建字段,或直接在 Webflow 中手动编辑,而不能原地更新。
- 选项字段值既可以使用其名称,也可以使用其底层 ID 写入,但筛选或查询时只能使用 ID,不能使用名称。按名称筛选会静默返回零条结果,且不会报错提示有误。
- 必须确认引用字段的目标属于正确的 Collection。不存在的 ID 和来自错误 Collection 的有效 ID 可能返回相同错误,因此应直接确认目标 Collection,而不要仅凭错误信息推断。
字段组
- 字段组用于整理 Collection 设置中字段的显示方式,不会影响底层数据。
- 更新字段组时,每次都必须发送完整的字段组集合;这会替换整个分组配置,而不是添加到现有配置中。省略某个字段组就会将其移除。
- Collection 内置的名称和 slug 字段不能加入字段组。
- Ecommerce Collection 完全不支持字段组,哪怕是空字段组也不行。
- 每个 Collection 最多可有 50 个字段组。这是工具层面的实际限制,并非计划限制,可以明确说明。
操作顺序与批处理
- 按依赖顺序构建:先创建被引用的 Collection 及其条目,再创建引用它们的 Collection 和字段,然后进行连接和填充。
- 一次创建多个条目时,较大的批次也适用于创建新条目。更新现有条目时应使用较小的批次,因为更新批次中只要有一条无效记录,就可能导致整个批次被丢弃,而不仅仅是该条目。
- 批量写入前,先验证准备发送的内容。创建操作通常以整个批次为单位,要么全部成功,要么全部失败;其中一条记录无效,就会导致该批次中的内容全部无法创建。
报告与验证
- 执行任何批量操作后,都要重新检查当前实际状态,不要只相信响应结果。有些操作会准确确认执行情况,另一些则几乎不提供确认信息。
- 清楚说明实际创建、更新或连接了哪些内容,并指出任何意外情况,不要把预期结果说成实际结果。
- 如果有内容被跳过(例如某个区域设置,或未通过验证的条目),应明确说明,不要默默略过。
- 新创建的 Collection 或条目可能不会立即显示在 Webflow 界面中。如果学习者表示看不到刚刚创建的内容,建议先刷新页面或标签页,再判断是否失败。
每次实际操作前先制定计划
在创建、连接或填充任何内容之前,先说明具体计划并等待批准。将结构、连接和内容生成视为三个独立的批准环节,而不是一次笼统批准就涵盖所有操作。
连接前先验证
对于任何引用字段或多重引用字段,在最终确定连接前,请确认关系与计划一致。撤销已填充的连接很困难,也可能导致数据丢失。
参考资源
- CMS Collections | The Webflow Way — 一般结构规划指南
- Option field overview
- Reference field overview
- Nest Collection lists
- Collection fields
- CMS Field Types & Item Values
- Webflow MCP server overview
备注
此技能是 Webflow University 资源,旨在以单个 .md 文件的形式分发,可附加到「Build & scale a CMS with MCP」课程中,也可作为独立下载内容,与其配套的现有内容迁移技能一起分享。
参与者具备以下条件时,效果最佳:
- 支持 Webflow MCP 的 AI Agent
- 已在计划操作的网站上授权 Webflow MCP
- 对 Webflow Collections 有基本了解
此活动的输出是第二个独立的技能文件,它会根据每位学习者自己的计划重新生成。该文件是一个独立完整的 Markdown 文件:可在不同会话中加载、交由不同的 Agent 使用,或由完全不同的人使用;在执行任何操作前,它都会概述自身内容并确认已准备就绪。