SuperAPI AI 工具集

notion-reliability-patterns

通用与其它

查看项目

更新于 10-15 23:27

技能介绍

用途:针对某个具体的 Notion 操作,分析并应用重试、幂等、检查点、熔断、死信与对账等可靠性模式,在采取实际动作前产出可审计的决策或工件,用于加固失败场景。

前提:需要当前第一方 Notion 文档与所选集成经过测试的 API 版本契约;指定工作区负责人、内容或数据负责人、操作负责人;使用合成或获批的非生产夹具,并移除密钥与工作区内容。

主要能力与流程:定义成功、确认、幂等标识、检查点、超时歧义与补偿;将失败分类为永久、瞬态、速率、冲突、访问与未知;仅在不变式明确时选用有界重试、幂等记录、租约、熔断、死信或对账;在确认创建前持久化响应标识,在推进读检查点前持久化目标状态;演练重复、乱序、超时、崩溃、毒消息与下游部分失败;记录运维恢复、重放授权、可观测性与回滚。返回操作状态机、不变式、重试矩阵、恢复存储、测试证据、运行手册与剩余风险,并明确假设、负责人、有效期与证据缺口。

使用方式:用 Read、Glob、Grep 检查文档、配置、代码、夹具与证据;仅对获批的仓库工件使用 Write 与 Edit。仅调用本身不授权网络访问、凭据、工作区内容、用户数据、文件传输、部署、能力或共享变更、写入、支出或删除。死信重放、检查点回退、回填、补偿或绕过熔断需操作负责人批准,执行前记录批准人与有界恢复窗口。

限制与注意:可靠性行为取决于操作是读取、创建、更新、Webhook 信号、分页提取、文件生命周期还是下游副作用;不能仅凭 HTTP 方法推断重试安全性;依赖可变字段、端点、版本、限制或投递行为前应复查带日期的证据映射。不要在无去重证据时重试超时的创建;不要为保持队列绿色而丢弃毒消息;不要用过期的缓存内容作为权威写入源。观察到的租户行为只属特定环境证据,并非通用 Notion 保证。