用途:将 Notion 集成的安全、隐私、访问、版本与变更规则转成仓库级与运行时门禁,在真正执行操作前产出可审计的决策或工件。适合以策略即代码方式约束 Notion 集成。
主要能力:覆盖密钥处理、版本校验、对象类型正确性、分页、重试、能力范围、内容共享、租户绑定、Webhook 校验、破坏性操作与证据留存。策略检查可查看密钥名称与指纹但不读取值;运行时检查需把凭据绑定到预期工作区与环境。可添加静态检查(凭据、旧对象操作、不安全日志、无界重试、缺审批)、测试(页面/数据源标识、分页、Webhook 签名、幂等、租户隔离)与运行时守卫(环境、写入范围、并发、载荷大小、破坏性操作),并定义带签名与时限的例外。
使用方式:先准备当前第一方 Notion 文档与所选集成已测试的 API 版本契约、指定工作区/内容/操作负责人、去敏的非生产夹具。把每条策略翻译为负责人、范围、机器检查、人工门禁、证据与例外到期。用 Read、Glob、Grep 检查文档、配置、代码与证据,用 Write、Edit 仅写已批准的仓库工件;仅调用不授权网络、凭据、工作区内容或删除等操作。执行前演练允许、拒绝、过期例外、租户不匹配、不安全重试与回滚路径。
限制与边界:密钥与 Webhook 规则归安全负责,内容范围归数据负责人,强制上线归发布负责人,单一角色不得自批例外。仅警告的密钥规则不足以用于生产;不自动修复对象标识或破坏性请求;政策证据缺失时按关闭处理。输出控制目录、实现点、测试、门禁输出、例外登记、负责人与上线计划,并明确假设、到期与证据缺口。