SuperAPI AI 工具集

linear-cost-tuning

部署与运维

查看项目

更新于 10-15 23:27

技能介绍

用途:分析并降低 Linear 集成的基础设施与配额成本,方式包括工作负载核算、查询预算控制和推送式(webhook)更新替代轮询。成本被理解为集成的计算、队列、存储、支持与配额消耗,不假设存在固定的按请求价格。

前提条件:目标仓库、Linear 工作区、环境与责任人;当前安全、隐私、合规、容量与变更控制要求;仅在确有必要做有界实时验证时才使用已批准的 Linear 凭据。

工具纪律:使用 Read、Glob、Grep 检查代码、配置与证据;WebFetch 仅用于当前第一方 Linear 文档与包元数据;Write/Edit 仅用于已请求且目标文件已知的实现。不得写入凭据、客户内容、未受限环境输出或未脱敏的 GraphQL 变量。

契约要点:Linear 发布的是请求与复杂度预算而非统一单价;轮询不被鼓励,支持时 webhook 是主要变更信号;过滤、显式分页、窄字段选择与按更新时间排序可同时降低查询复杂度和本地处理。

认证:个人 API key 仅用于所有者控制的脚本;用户委派应用用 OAuth with PKCE;批准的自动化可用已启用的 client-credentials 授权。个人密钥用 Authorization: <API_KEY>,OAuth 用 Authorization: Bearer <ACCESS_TOKEN>,凭据存于批准的密钥管理器。

主要步骤:按工作流度量请求、复杂度、负载字节、排队时间、重试、存储增长与人工负担;区分必要新鲜度与习惯性轮询,用已验证 webhook 替换支持范围内的轮询循环;设置低于共享限制的每工作负载请求与复杂度预算;减少字段、分页大小、扇出、重复读取与保留期;用合成数据做负载测试并对比吞吐、新鲜度与失败恢复;在展示金额节省前与工作区所有者核实当前套餐条款。

限制与审批边界:未经责任所有者明确批准,不得创建/泄露/轮换/吊销凭据、授权 OAuth 应用、变更作用域或团队权限、变更工作区数据、配置或重启用 webhook、导入导出数据、变更角色/SCIM/审计流、传输诊断信息或变更付费权益;诊断保持只读。

输出:工作区与团队范围、不含凭据值的认证模式、检查的文件与契约、确切操作名、收集的证据、验证结果、脱敏字段、剩余风险、责任人、审批状态及回滚或下一步。错误处理:无基线先埋点;配额与价格分开报告;webhook 缺口保留有界对账任务;语义被改变的优化应拒绝。