SuperAPI AI 工具集

linear-reference-architecture

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:为 Linear 集成建立以代码仓库为依据的参考架构,明确权限归属、数据流、故障隔离与对账机制,保留宿主应用原有边界,而非套用通用服务拓扑。

主要能力:分离凭证获取、Linear 适配器、策略/授权、Webhook 入口、持久队列、Worker 与对账组件;定义稳定标识、幂等性、分页检查点、部分错误处理与速率预算归属;将变更命令置于策略与审批检查之后,使读取与对账可独立运行;围绕操作元数据与投递 ID 设计可观测性并严格脱敏。

使用方式:用 Read、Glob、Grep 检查代码、配置与证据;WebFetch 仅用于 Linear 官方文档与包元数据;Write/Edit 仅用于已知目标文件的实现。认证上,个人 API 密钥仅用于所有者控制的脚本,用户委托应用用 OAuth with PKCE,已批准的自动化可用客户端凭证授权;个人密钥使用 Authorization: <API_KEY>,OAuth 令牌使用 Authorization: Bearer <ACCESS_TOKEN>,凭证存于服务端密钥管理器。Webhook 入口须校验原始正文 HMAC、五秒内确认、按投递 ID 去重并将持久工作移入队列;仍需基于游标的对账读取器。

适用场景:审查或创建 Linear 集成架构、多工作区多租户集成、事件驱动与对账并存的持久集成。

限制:不得在无所有者明确批准下创建、泄露、轮换或撤销凭证,授权 OAuth 应用,更改范围或团队访问,变更工作区数据,配置或重新启用 Webhook,导入导出数据,更改角色、SCIM 或审计流,传输诊断信息,更改付费权益或执行其他生产变更;诊断默认只读。输出需包含工作区与团队范围、认证模式(不含凭证值)、检查的文件与契约、确切操作名、证据、验证结果、已脱敏字段、剩余风险、责任人、审批状态与回滚或下一步。具体安装命令与价格信息暂未提供。