用途
该技能用于构建 Fireflies 集成的 CI 通道（CI lane），目标是在持续集成中提供契约安全（Contract-Safe）的验证能力。它强调大部分 CI 应保持离线与确定性，只有在明确授权和受控条件下才允许执行真实环境测试。
主要能力
- 静态 GraphQL 校验：收集具名 GraphQL 文档，离线校验语法与变量声明。
- 合成夹具测试：使用合成数据覆盖成功、部分数据、错误、空值、分页与限流等情形。
- Webhook 验证：针对 Webhooks V2 的 HMAC 向量，校验原始字节、畸形签名与重复事件。
- 密钥扫描：对日志与产物添加密钥及敏感输出断言。
- 受控真实测试：将可选的在线测试置于受保护密钥与显式环境审批之后，且仅限已批准的元数据与单次有界请求预算。
- 结果发布：只发布测试计数与安全的失败元数据，绝不发布响应正文。
使用方式
前置条件包括：目标仓库或集成路径及期望的操作结果；Fireflies 主体、团队、环境与数据分类；当前 Fireflies 文档、按需提供的凭据以及可问责的审批人。
认证方面，若需认证操作，应从已批准的密钥管理器注入 FIREFLIES_API_KEY，并仅以 Authorization: Bearer REDACTED_KEY 形式发送至 https://api.fireflies.ai/graphql。禁止打印、提交、放入 URL、转发至浏览器或将密钥写入证据。Webhook 签名密钥是独立凭据，不得复用为 API 密钥。
工具纪律：使用 Read、Glob、Grep 检查代码、配置、测试与证据；仅在已批准的实现或文档变更中使用 Write/Edit。不得仅因调用该技能就查询 Fireflies、获取会议内容、创建 AskFred 线程、上传媒体、更改账户状态、重放事件或部署。
审批边界：启用在线 CI、添加变更测试、存储 Fireflies 密钥或保留任何 API 响应产物之前，均需获得审批。
输出与验证
输出应包含：确切的操作或事件面、环境、授权类别、所选字段组、验证结果、无内容指标、决策以及简明的通过/失败回执。密钥与会议衍生内容不得进入通用输出。报告成功前，应重新运行最小相关的确定性检查，将实际状态与期望结果及当前契约比对，确认日志或产物中未混入密钥或会议衍生内容，并明确记录未解决的不确定性。
错误处理
无测试密钥时：跳过在线通道，但不削弱离线门禁。产物中出现真实数据时：停止发布并启动事件处理。模式校验失败时：依据当前第一方证据更新文档。
适用场景
适用于为 Fireflies GraphQL 接口与 Webhook 集成建立 CI 质量门禁、在合并前验证契约兼容性、以及需要在不接触生产会议数据的前提下进行集成测试的团队。
限制
真实测试需要显式配置的只读测试身份、选定元数据字段、严格预算，且不得使用生产会议数据。该技能本身不授权任何查询、内容获取、账户变更、事件重放或部署行为。关于具体字段、过滤器、事件、权限、套餐限制、变更操作或处理状态，需以官方 Fireflies.ai 证据为准；本资料未提供这些细节。