用途:把 Attio 集成改动转化为确定性的拉取请求证据,将离线契约测试与显式启用的只读 API 冒烟测试分开。
主要能力:检查变更端点、请求方法、作用域与响应形态;为成功响应、结构化 Attio 错误、分页终止和重试分类添加夹具测试;校验快照是否对令牌、记录值、webhook 密钥和个人数据做脱敏;添加默认禁用的实时任务,仅执行已批准的只读请求(如列出对象);在 PR 证据中记录测试命令、夹具版本与冒烟测试处置。
使用方式:用 Read、Glob、Grep 检查工作流、夹具、客户端代码与密钥名;WebFetch 仅用于获取当前官方 Attio 文档;确认目标文件、约束与验证计划后再用 Write 或 Edit。测试 https://api.attio.com/v2 的响应封装与应用侧归一化,分页按端点区分(limit/offset 或 pagination.next_cursor)。认证使用单工作区访问令牌或 OAuth,仅授予冒烟测试所需端点作用域,通过 CI 密钥存储以 Bearer 凭据传入。
适用场景:Attio 集成变更的 CI 门禁。限制:常规 PR CI 不得创建、更新或删除记录;变更类冒烟测试需具名一次性工作区、受限夹具、清理验证和仓库所有者批准;实时任务需显式环境配置,在 fork 上直接跳过;不得在日志、快照、测试名或产物中暴露访问令牌。错误处理:fork 无密钥仅跳过实时任务;夹具与文档不符需确认实时端点并有意刷新夹具;冒烟返回 403 检查所需作用域,不要盲目扩大;检测到变更则使任务失败并移除变更请求。