用途:该技能用于产出基于目标仓库现状的 Webflow 方案或实现,以当前官方文档和项目已安装版本为准,发现阶段保持只读,并将准备与线上变更分离。
主要能力:定位所有 Webflow 客户端构造与直接 API 调用,按令牌、站点、环境和读写意图分组;建立统一配置边界,校验令牌变量名、API 基础 URL 与预期站点 ID 且不记录值;将分页封装为带显式页数与条目上限的迭代器,原样保留游标或偏移;围绕 HTTP 状态、Webflow 代码、消息、详情与重试头集中归一化错误;对共享同一 API 密钥的调用方使用共享限流器,让官方 SDK 退避在有界任务策略内运行;在迁移调用方前添加契约测试与一次只读集成冒烟测试。
使用方式:使用 Read 读取仓库说明与相关文件,Glob 清点清单与 Webflow 集成路径,Grep 定位 API 主机、ID、作用域与凭据名;WebFetch 仅用于当前官方 Webflow 文档;Write 用于用户要求的新产物,Edit 用于证据检查后对现有文件做最小改动。认证方面,Data API 调用使用为集成选择的 bearer 令牌:单站点工作用站点令牌,工作区令牌仅用于其支持的工作区/读取用例,用户授权应用用 OAuth;作用域由确切端点推导,绝不读取、回显、持久化令牌值或将其放入命令、补丁、示例、日志与报告。
适用场景:集中化客户端、分页、重试、多租户隔离,以及需要区分文档事实、仓库证据与推断的 Webflow 集成工作。
限制:默认只读检查;任何创建、更新、删除、发布、取消发布、归档、部署、撤销令牌或注册 webhook 前,须展示确切环境与资源 ID、拟议变更、验证方法与回滚措施,仅在用户明确授权时进行,生产发布或破坏性操作需重新明确批准。SDK 返回结构与方法名须来自已安装包类型或当前官方参考,不得凭记忆示例。官方 SDK 含针对限流响应的指数退避,但应用仍需有界工作队列与业务级重试策略。Content Delivery API 可用其文档化基础 URL 进行缓存的实时条目读取,但不能替代 Data API 写入。遇到 429 循环应遵守 Retry-After、限制尝试次数并协调共享同一密钥的调用方;出现跨租户结果应停止,并在任何写入路径前要求经验证的站点 ID 允许列表。输出需包含检查的项目与版本、已验证的 Webflow 身份、相关端点与作用域契约、拟议或已做变更、验证证据、线上变更状态、回滚就绪度与剩余风险。