用途:在仓库侧建立 Miro CI 门禁,使拉取请求检查保持无凭据,把真实 Miro 调用留给受保护、明确限定的通道,避免测试意外改动协作看板,并产出可复核的证据。
主要能力:拆分格式化、单元、schema、安全与 fixture 测试和受保护的实时通道;断言 PR/fork 通道没有凭据上下文、无法调用实时辅助函数;固定依赖并依据官方响应契约校验捕获的 fixture;按安装串行化受保护实时任务,断言应用/团队/看板守卫,使用有界、先读的测试;为创建项标记运行身份、核对后仅清理确认属于本次运行的 ID;在数据泄露、写入不明确、清理残留、schema 异常或配额策略违规时使门禁失败。
使用方式:用 Read、Glob、Grep 检查仓库、配置名、适配器、测试与证据;仅用 WebFetch 查阅当前官方 Miro 文档;确认模式、目标环境、租户、看板和审批边界后再用 Write 或 Edit。这些工具不调用已认证的 Miro API 或部署 CLI,需实现客户端、配置与测试改动后,返回精确的操作命令或经审批的实时执行交接。REST 使用 OAuth 2.0 授权码模式与最窄 Miro scope,加密令牌记录绑定用户、应用、授权团队与已授予 scope,绝不打印访问令牌、刷新令牌、客户端密钥、授权码或看板内容。
适用场景:需要把 Miro 相关测试纳入 CI 且区分无凭据与实时通道的仓库。
限制:不得向 fork 暴露凭据、不得在并行任务间共享轮换令牌、未经仓库与看板所有者批准不得启用破坏性实时测试;负责人或确切目标不明确时应暂停。输出需包含通道/信任映射、fixture 来源、受保护资源守卫、测试结果、已用额度、清理回执与门禁结论,并说明未检查或未更改的内容。示例回执:unit=46/46; schemas=12/12; fork-secrets=0; live-read=passed; live-writes=0; cleanup-residue=0。