SuperAPI AI 工具集

notion-known-pitfalls

通用与其它

查看项目

更新于 10-16 06:20

技能介绍

用途:该技能用于审计 Notion 集成中反复出现的身份、访问、版本、分页、Webhook 与写操作错误,适合在发布评审或排查问题时使用,在采取任何实际操作前产出可审计的决策或产物。

前提条件:需要当前第一方 Notion 文档以及所选集成经过验证的 API 版本契约;指定工作区所有者、内容或数据所有者、操作所有者;使用已批准的非生产夹具,并清除密钥与工作区内容。

主要能力与检查点:区分数据库与数据源;区分能力与内容访问权限;检查分页是否遗漏、对象结构是否过时;不把 Webhook 当作账本;写操作重试需保证幂等。需核对连接模型、工作区绑定、能力、共享内容与密钥生命周期;追溯数据库、数据源、页面、块、文件、搜索与 Webhook 假设;检查分页、大小限制、未知字段、错误类别、Retry-After 与重试预算;检查幂等性、前置状态、读回、补偿与破坏性操作审批;检查 Webhook 签名、重复、顺序、聚合、获取当前值与对账行为;按可利用性、数据影响、复现性与修复难度排序发现。

使用方式:使用 Read、Glob、Grep 检查文档、配置、代码、夹具与证据;仅对已批准的仓库产物使用 Write 与 Edit。仅调用工具不等于授权网络访问、凭据、工作区内容、用户数据、文件传输、部署、能力或共享变更、写入、花费或删除。使用实时凭据或内容确认疑似缺陷前需要审批;仓库检查默认只读。

限制与错误处理:不要通过扩大访问权限来修复 404 而未证明身份;不要假设单次搜索或查询页是完整的;不要静默将旧载荷强制转换为当前写入。输出需包含缺陷清单、证据、影响、误报说明、整改措施、负责人与验证测试,并明确假设、所有者、过期时间与证据缺口。