用途:该技能帮助在 Webflow CMS 中安全地管理内容生命周期,覆盖创建、更新、发布、取消发布、归档与删除操作,把准备阶段与线上变更分离,默认只读检查。
主要能力:先核实站点、集合、区域、字段结构和当前暂存/线上状态;将源数据按文档字段类型规范化,拒绝未知字段并保留 item ID 与 slug 以便回滚;先生成暂存项,输出含 item ID、变更字段、原线上状态和预期结果的差异;在预览中验证有限样本,检查引用、slug、区域、资源 ID 和富文本结构;变更后重新读取暂存与线上端点并记录 isDraft、isArchived 和 lastPublished 证据。
关键契约:暂存内容可预览但不一定线上;线上项可保留未发布的暂存变更;已在线上项设置 isDraft: true 并不会取消发布,取消发布需用线上项取消发布端点;单项发布与整站发布是不同操作,计划发布无法通过 CMS API 控制;归档在下次整站发布时从线上站点移除但保留在 CMS,删除则是不同的破坏性操作。
认证:数据 API 调用使用为集成选择的 bearer token,站点令牌用于受控单站点工作,工作区令牌仅用于受支持的工作区/读取场景,OAuth 用于用户授权应用;作用域由确切端点推导。切勿读取、回显、持久化令牌值,也不要把令牌放进命令、补丁、示例、日志或报告。
使用方式:使用 Read 读取仓库说明和相关文件,Glob 清点清单与 Webflow 集成路径,Grep 定位 API 主机、ID、作用域和凭据名称;WebFetch 仅用于当前官方 Webflow 文档;Write 用于用户要求的新产物,Edit 用于证据检查后对现有文件的最小改动。
审批边界:默认只读检查。任何创建、更新、删除、发布、取消发布、归档、部署、令牌撤销或 webhook 注册之前,须展示确切环境与资源 ID、拟议变更、验证方法和回滚或补偿动作;仅当用户请求明确授权该变更时才继续,生产发布或破坏性工作需重新明确批准。
限制与错误处理:模式验证失败时停止批次并报告字段名与预期 Webflow 类型;线上线下不匹配时在调用方选择权威状态前不重试写入;部分批次成功时记录逐项回执,仅在核对后重试失败 ID。输出需区分文档事实、仓库证据与推断。官方参考包括 Webflow 开发者文档和 Data API v2 索引。