用途:为 Firecrawl v2 集成执行发布就绪门禁,产出可支撑 go/no-go 决策的证据。没有工件、测试、负责人或确切发布引用的勾选不算证据。
前提:目标仓库或集成路径与期望的运维结果;来源授权、数据分级与环境策略;当前 Firecrawl 文档、按需凭据及审批负责人。
契约要求:使用当前 v2 端点或明确隔离的旧路径、官方 SDK 接口、完整异步分页、有文档的重试性、签名 webhook、明确的抓取/批处理上限、当前计费控制与已批准的缓存/留存行为。自托管发布需具备超出 Compose 评估的生产控制。
认证:已认证的 Cloud 操作从批准的密钥管理器注入 FIRECRAWL_API_KEY,REST 请求使用 Authorization: Bearer。切勿打印、提交、传输密钥或将其放入 URL。无密钥访问仅在当前文档明确允许且工作负载接受其限制时适用。
主要步骤:固定应用发布、依赖/锁文件、契约来源、配置哈希、环境、负责人、目标策略与回滚候选;核查密钥托管身份、团队归属、密钥/格式/端点/IP 限制、轮换、fork-CI 隔离及源码与工件中无密钥;核查域名授权、URL 规范化、范围/限制、允许的格式/动作/头/代理、留存/缓存/ZDR 与删除;测试 SDK/REST 响应处理、来源状态、分页、取消、402/403/429、Retry-After、有界服务端重试、部分结果、webhook HMAC/幂等与下游去重;核查成本上限、按量付费策略、队列/并发余量、仪表盘、SLO 告警、事件归属、供应商升级与降级模式;运行一次有界预发金丝雀(使用已批准的无内容断言),再测试回滚且不重放或重复已接受页面。仅当必需门禁通过且审批附上时给出 go;例外需记录负责人与到期时间。
工具纪律:用 Read、Glob、Grep 检查代码、配置、测试与证据;Write/Edit 仅用于已批准的实现或文档变更。不得仅因调用本技能就调用 Firecrawl、轮换密钥、更改账户设置、抓取目标或部署。
审批边界:安全/数据/产品/运营控制需具名审批,上线、计划/支出变更、例外与回滚豁免需发布负责人审批。
输出:发布记分卡,含证据链接、确切版本、门禁结论、金丝雀与回滚结果、例外、负责人、到期时间与最终 go/no-go 决定。
错误处理:必需证据缺失即判门禁失败,不得记为未知通过;金丝雀内容或支出超策略即停止发布并回滚;回滚导致下游记录重复则保持发布阻塞直至幂等修复。
限制:具体端点、SDK 方法、计划限制、价格、留存选项与自托管发布细节需以官方 Firecrawl 文档为准,本资料未提供这些具体数值。