用途:为 Fireflies 集成搭建可复现的本地开发循环,避免把真实转录、参会人名单、摘要或密钥复制到开发机。
主要能力:把 GraphQL 响应建模为数据加可选错误,保留可空性;为成功、部分数据、校验失败、授权失败、限流和延迟处理分别维护夹具;用虚构 ID、说话人、句子、摘要和时间戳创建合成会议;记录完整 GraphQL 信封结构(含 errors 与 extensions);将传输层置于可注入接口后,本地测试路由到确定性 mock 服务器;为可空字段、分页、部分数据和脱敏添加契约测试;实时测试保持可选、只读、范围窄,且无显式测试密钥时禁用;记录经审查的 schema 变更后如何刷新夹具。
使用方式:先梳理集成的操作与所选字段,再创建合成夹具;认证操作从批准的密钥管理器注入 FIREFLIES_API_KEY,仅以 Authorization: Bearer REDACTED_KEY 发送到 https://api.fireflies.ai/graphql,不得打印、提交、放入 URL、转发到浏览器或写入证据;Webhook 签名密钥是独立凭据,不可复用为 API 密钥。用 Read、Glob、Grep 检查代码与证据,仅在获批的实现或文档变更中使用 Write/Edit。
限制与边界:调用本技能本身不授权查询 Fireflies、获取会议内容、创建 AskFred 线程、上传媒体、更改账户状态、重放事件或部署。记录实时响应、将本地进程连到生产或存储任何真实会议衍生内容前需审批。夹具漂移只能依据当前 schema 证据更新并审查差异;快照出现密钥须停止、必要时吊销并按事故流程从历史移除;仅 mock 通过后,发布前需运行授权的只读契约通道。输出应包含操作面、环境、授权类别、字段组、验证结果、无内容指标、决策与简明通过/失败回执,且不得含密钥或会议衍生内容。