SuperAPI AI 工具集

notion-common-errors

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:该技能用于对 Notion API 调用失败进行分类,并依据观察到的响应状态与结构化错误码,选择一条有界的恢复路径。适用于处理认证、权限、资源受限、ID 错误、载荷无效、冲突、限流与服务故障等场景。

主要能力:捕获脱敏后的响应信封与原始操作;将状态码和结构化错误码映射到认证、授权、校验、身份、并发、限额或服务类;在改代码前核对所选 API 版本与页面、数据库、数据源身份;按类别执行对应动作,如修正输入、恢复访问、按指示等待、协调冲突或暂停等待服务恢复;仅对可重试类别在严格次数与时间预算内重试;用最小权限读取或夹具验证原故障已消失。

使用方式:使用 Read、Glob、Grep 检查文档、配置、代码、夹具与证据;Write 与 Edit 仅用于已批准的仓库产物。调用本身不授权网络访问、凭据使用、工作区内容访问、用户数据、文件传输、部署、能力或共享变更、写入、花费或删除。能力变更、内容共享、令牌轮换、写入重放、批量重试或支持披露前需获得批准。

限制与注意:不能把所有 404 都当作不存在,不可访问内容与错误标识符可能无法区分;应遵守 Retry-After 而非固定休眠;未知错误码应隔离而非猜测。输出需包含观察证据、类别、可能原因、已排除原因、恢复动作、重试预算与验证结果,并明确假设、负责人、过期时间与证据缺口。需以当前第一方 Notion 文档和所选集成的已测试 API 版本契约为前提,并指定工作区、内容或数据及操作负责人,使用已批准的非生产夹具。观察到的租户行为仅属环境特定证据,不构成 Notion 的普遍保证。