用途:该技能用于在升级或复现 Attio API 问题时,收集最小必要的诊断证据,并在写入或分享诊断包之前完成脱敏与内容审核。
前提:需要已命名的事件、仓库和失败操作;针对令牌、webhook 密钥、ID 和个人数据的脱敏规则;确切的端点引用与预期请求形态;以及最终诊断包经批准的目标位置。
工具纪律:使用 Read、Glob、Grep 检查配置名称、客户端代码、现有日志与测试,避免不必要地打开密钥文件;仅在获取最新官方 Attio 文档时使用 WebFetch;仅在批准的路径下,经审核后使用 Write 或 Edit 写入脱敏产物。
收集约定:收集路径模板而非含客户数据的 URL;保留状态码、内容类型、文档化错误字段、重试时机与分页模式;记录 scope 名称但绝不记录令牌值;不得转储完整记录、属性值、环境变量、请求头或 webhook 载荷。
认证:若批准进行有限复现,使用进程内存中现有的 Bearer 凭据。诊断包可声明凭据类型、工作区别名与已授权 scope,但不得包含凭据或可重复使用的签名材料。
操作步骤:先定义事件问题与最小证据字段;清点本地调用方、端点路径模板、方法、超时、重试策略与分页模式;在安全前提下捕获一份脱敏失败指纹和一次有限控制请求;仅在解释验证行为所需时添加对象或列表 schema 标识符;扫描候选诊断包中的令牌特征、授权头、webhook 密钥、记录值、邮箱、电话和完整 ID;人工审核脱敏输出,然后写入批准的诊断包与校验和。
审批边界:不得为诊断进行广泛的工作区枚举,不得收集原始 CRM 响应,在诊断包的确切内容与目标位置经审核前不得传输。
输出:返回诊断包清单、脱敏报告、请求指纹、观测与预期契约对比、复现结果、校验和与共享处置。
错误处理:发现密钥特征时停止、脱敏并从开头重新扫描;证据包含个人数据时替换为带类型的占位符或计数;复现会修改数据时改用夹具或明确申请可丢弃目标批准;诊断包无法回答事件问题时移除噪声,仅收集缺失字段。
限制与边界:资料未提供具体命令、安装方式、收费信息或平台支持范围;所有操作需遵循上述审批与脱敏要求。