用途:在 Linear 中建立受控的议题生命周期工作流,从发现到创建、更新、关联、评论和归档,把每次写入都当作可审查、可回滚的业务操作。
主要能力与要点:先解析经过认证的查看者、组织、目标团队、工作流状态、标签与负责人(只读查询);再把业务转换翻译为明确的创建/更新/评论/关联计划,使用稳定 ID;校验必填字段、可见性、重复策略以及 Triage 是否改变默认初始状态;对敏感或个人字段做遮蔽后预览精确的 mutation 变量;获批后一次只执行一个 mutation,并同时验证 GraphQL 错误与负载成功。
契约事实:issueCreate 需要团队 ID;未提供状态 ID 时,Linear 会选择该团队的第一个 Backlog 状态,或在启用时选 Triage。SDK 使用动词在前的 mutation 名称,如 createIssue、updateIssue、archiveIssue。议题创建后前三分钟内的更改视为创建的一部分,不产生活动日志条目。
认证:个人 API key 仅用于负责人控制的脚本,Authorization: <API_KEY>;用户委托应用使用带 PKCE 的 OAuth;已批准自动化可使用已启用的 client-credentials 授权。OAuth 令牌使用 Authorization: Bearer <ACCESS_TOKEN>。凭据存储在服务端经批准的密钥管理器中。
审批边界:未经责任人明确批准,不得创建、泄露、轮换或撤销凭据,不得授权 OAuth 应用、更改范围或团队访问、创建/变更/归档/删除工作区数据、配置或重新启用 webhook、导入导出数据、更改角色、SCIM 或审计流、传输诊断信息、更改付费权益或执行其他生产 mutation。未请求实施时保持只读诊断。
输出与错误处理:返回工作区与团队范围、不含凭据值的认证模式、检查的文件与契约、精确操作名、收集的证据、验证结果、遮蔽后的敏感字段、剩余风险、责任人、审批状态及回滚或下一步。团队或状态未找到时停止并列出可见候选项,不得静默回退到第一个团队;重复议题先按批准的外部键或规范 URL 对账;出现 GraphQL 错误视为未解决并按 ID 验证;回滚优先使用补偿更新或归档,不要随意删除历史。
限制:资料未提供具体定价、界面截图、平台兼容范围与实施步骤细节。