用途:在准备上线或变更权限前,对 Linear 集成做生产就绪审查,产出有证据支撑的 go、conditional-go 或 no-go 决策,而非脱离实际部署的勾选清单。
主要能力:检查认证方式(个人 API 密钥、带 PKCE 的 OAuth、客户端凭据授权)、令牌类型与作用域、密钥存储与轮换撤销;审查 Webhook 接收端(公网 HTTPS、原始请求体签名校验、5 秒内返回 200、去重与对账);核对请求与复杂度限制、数据最小化、导出与保留、可观测性脱敏、幂等、队列行为与漏事件对账;演练依赖中断、令牌失败、限流、重复 Webhook、回滚与停用路径。
使用方式:用 Read、Glob、Grep 检查代码、配置与证据;WebFetch 仅用于 Linear 官方文档与包元数据;Write/Edit 仅用于已明确目标文件的实现。个人密钥用 Authorization: <API_KEY>,OAuth 令牌用 Authorization: Bearer <ACCESS_TOKEN>,凭据存于服务端批准的密钥管理器。
适用场景:上线前评审、权限变更、生产访问审批、回滚与停用验证。
限制:不得创建、泄露、轮换或撤销凭据,不得授权 OAuth 应用、变更作用域或团队访问、改动工作区数据、配置或重新启用 Webhook、导入导出数据、变更角色/SCIM/审计流、传输诊断信息或变更付费权益,除非获得责任方明确批准。证据缺失时标记为未完成,不得由配置推断就绪;回滚未测试则对实质变更路径返回 no-go;共享配额无归属须先指定预算负责人;敏感日志须在脱敏与数据清理验证前阻止上线。输出需包含工作区与团队范围、认证模式(不含凭据值)、检查的文件与契约、操作名、证据、验证结果、脱敏字段、剩余风险、责任方、审批状态与回滚或下一步。具体命令与官方文档细节暂未提供。