用途：帮助在 Miro 集成中决定使用官方 Node 客户端还是原生 REST 适配器，并把供应商传输细节封装在窄适配器后，使认证轮换、响应漂移、重试和测试替身可独立验证。
主要能力：清点现有 HTTP/SDK 调用、令牌查找、重试、分页与响应假设；在需要协议控制时选原生 REST，在官方客户端接口已验证且足够时选客户端；通过接受租户上下文而非原始凭据的适配器暴露领域操作；在边界校验外部响应并保留未知字段以诊断漂移；集中处理安全重试分类、速率头、超时与脱敏错误元数据；固定依赖，运行契约夹具加有界实时读取，并记录观察到的 API/客户端版本。
使用方式：用 Read、Glob、Grep 检查仓库、配置名、适配器、测试与证据；仅用 WebFetch 获取当前官方 Miro 文档；确认模式、目标环境、租户、看板与审批边界后再用 Write 或 Edit。这些工具不调用已认证的 Miro API 或部署 CLI，需实现客户端、配置与测试变更后返回精确运维命令或经审批的交接。认证使用 OAuth 2.0 授权码与最窄 Miro 权限范围，加密令牌记录绑定用户、应用、授权团队与权限，禁止打印访问令牌、刷新令牌、客户端密钥、授权码或看板内容。
适用场景：Miro REST API v2 集成、多租户适配器设计、分页与重试治理、契约测试与迁移评估。
限制：@mirohq/miro-api 是官方 Node.js 客户端；集合助手可为异步迭代器，调用方须保留分页与有界终止；官方示例简化了存储与会话，生产适配器须提供持久化租户绑定实现。未经所有者批准与兼容性证据，不得切换客户端、从 OpenAPI 重新生成或更改生产调用方的重试语义；负责人或目标不确定时应暂停。输出需返回客户端选择、固定版本、操作映射、分页契约、校验边界、租户隔离测试与迁移风险，并说明未检查或未更改的内容。