SuperAPI AI 工具集

notion-ci-integration

部署与运维

查看项目

更新于 10-15 23:27

技能介绍

用途:为 Notion 集成契约构建 CI 检查,在不暴露令牌、不改动生产内容的前提下,对 SDK、schema、fixture 或迁移进行门禁校验。该流程在任何实际动作前产出可审计的决策或产物。

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

契约原则:CI 默认只校验本地契约。任何实时冒烟测试都需要专用非生产连接、显式共享的 fixture 内容、有界读取以及固定的已测试 API 版本。依赖可变字段、端点、版本、限制或交付行为前,应重新核对带日期的证据图。

认证:在支持的情况下使用短时 CI 密钥下发,并使用最小权限的非生产令牌。对值进行掩码,并阻止 fork 任务获取密钥。

操作步骤:定义离线单元、schema、分页、错误、webhook 签名和迁移 fixture;在依赖与契约矩阵中固定 SDK 和已测试 API 版本;将无密钥的拉取请求任务与受信任分支的实时冒烟测试分离;使实时通道只读、限定 fixture 范围、有时间上限并限制并发;捕获脱敏后的状态、错误码和请求标识,不记录响应内容;以精确 fixture、负路径、回滚证据和具名归属作为晋级门禁。

工具纪律:使用 Read、Glob、Grep 检查文档、配置、代码、fixture 和证据;仅对经批准的仓库产物使用 Write 和 Edit。仅调用本身不授权网络访问、凭据、工作区内容、用户数据、文件传输、部署、能力或共享变更、写入、花费或删除。

审批边界:启用密钥、实时读取、写入、计划任务或第三方 CI 访问前,需仓库管理员和工作区负责人批准。

错误处理:fork 拉取请求绝不能获得 Notion 凭据;被跳过的受信任实时任务不算通过,应单独报告;不得根据实时生产响应自动更新快照。

输出:返回 CI 信任矩阵、任务定义、fixture 清单、密钥来源、门禁结果和修复负责人,并明确假设、负责人、到期时间和证据缺口。

示例:拒绝重新引入旧对象结构的拉取请求;仅在受保护的受信任分支上运行只读机器人身份探测。

验证:演练并记录以下路径的预期与实际结果:fork 隔离、密钥掩码、离线确定性、负 fixture、实时读取边界、回滚门禁。

资源:当前第一方证据图——依赖可变行为前重新核对带日期的来源。将观察到的租户行为视为特定环境证据,而非 Notion 的通用保证。