SuperAPI AI 工具集

miro-hello-world

测试与质量

查看项目

更新于 10-15 23:27

技能介绍

用途:这是一个 Miro 只读连接探针技能,用于在启用写入前,用最小的 REST 请求证明授权上下文正确。仅凭 HTTP 成功响应不足以判定通过,还需租户与作用域上下文匹配,产出的证据用于让下一步决策明确可复核。

主要能力:检查集成配置(不读取凭据值);确认令牌上下文与预期团队;请求一页限定于已批准团队的看板列表;记录状态、延迟、速率限制头、分页大小及脱敏后的看板标识;对照官方参考验证响应结构与分页游标处理;保持写入关闭并返回最小证据。

使用方式:前置条件为已批准的 OAuth 安装且具备 boards:read、预期的团队与用户上下文、测试看板或列出看板元数据的权限。当前契约:GET https://api.miro.com/v2/boards 需要 boards:read;按 team_id 或 project_id 过滤会立即索引,其他搜索过滤可能延迟数秒;看板列表响应分页,不能把单页当作完整清单;响应体可能含机密名称、描述、所有者与链接。认证使用 OAuth 2.0 授权码模式与最窄 Miro 作用域,加密令牌记录需绑定用户、应用、授权团队与已授予作用域,绝不打印访问令牌、刷新令牌、客户端密钥、授权码或看板内容。工具纪律:用 Read、Glob、Grep 检查仓库、配置名、适配器、测试与证据;WebFetch 仅用于当前官方 Miro 文档;确认模式、目标环境、租户、看板与审批边界后再用 Write 或 Edit。这些工具不调用已认证的 Miro API 或部署 CLI,需实现客户端、配置与测试改动,再返回精确操作命令或经审批的交接。

输出:返回环境、上下文匹配、作用域充分性、HTTP 状态、延迟、速率限制余量、分页/游标事实与 go/no-go,并说明未检查或未更改的内容。错误处理:401 若符合条件刷新一次后停止并修复授权;403 或 404 检查作用域、成员资格、看板可见性与租户上下文,不要猜测;429 遵守重置头并停止探针;响应结构异常时捕获脱敏 schema 差异并暂停写入。

限制:除非用户明确授权该变更并指定测试看板,否则探针不得创建示例看板或条目;当责任所有者或确切目标不确定时暂停。示例回执:environment=dev; context=matched; status=200; boards-returned=1; cursor=present; remaining-credits=99500; writes=off。