用途 把部署证据与 Linear 工作项建立可追溯关联,同时避免让部署流水线获得宽泛的 Issue 编辑权限。适用于关联发布、提交、拉取请求等场景,围绕稳定的 Issue 标识和经负责人批准的状态变更进行设计;若原生代码托管集成已满足需求,则优先采用它。
主要能力
- 检查部署回执、Linear 源代码集成、标识约定与当前状态流转策略。
- 依据实际缺口选择原生集成、只读证据链接或自定义变更路径。
- 从可信发布元数据解析 Issue 标识,拒绝自由格式或有歧义的 分支解析。
- 预览评论、链接、标签或状态变更,将证据记录与工作流流转权限分离。
- 部署系统给出最终状态且已获批准后,执行一次幂等更新,并重新查询 Issue、保留部署、变更与回滚回执。
必要条件 目标仓库、Linear 工作区、环境与责任人;当前安全、隐私、合规、容量与变更控制要求;仅在需要受限实时验证时才使用已批准的 Linear 凭据。
认证 仅对负责人控制的脚本使用个人 API 密钥,用户委托应用使用带 PKCE 的 OAuth,已批准的自动化使用客户端凭据授权。个人密钥用 Authorization: <API_KEY>,OAuth 令牌用 Authorization: Bearer <ACCESS_TOKEN>,凭据存放于服务端已批准的密钥管理器。应用审批、团队访问、范围变更、凭据创建/轮换/撤销及生产访问均视为负责人批准的操作。
工具与输出 用 Read、Glob、Grep 检查代码与证据,WebFetch 仅用于 Linear 官方文档与包元数据,Write/Edit 仅用于已知目标文件的实现。不得写入凭据、客户内容或未脱敏的 GraphQL 变量。输出工作区与团队范围、认证模式(不含凭据值)、检查的文件与契约、确切操作名、收集到的证据、校验结果、已脱敏字段、剩余风险、责任人、批准状态及回滚或下一步动作。
限制与边界 每次变更结果都要检查 GraphQL 错误并按 Issue ID 核对。无稳定 Issue 标识时记录未匹配证据等待复核,不得猜测更新;部署状态不确定时等待最终回执;流转未授权时只附证据不改状态。回滚应记录为新事件,不擦除原始部署证据。未获负责人明确批准,不得创建、泄露、轮换或撤销凭据,不得授权 OAuth 应用、变更范围或团队访问,不得创建/修改/归档/删除工作区数据,不得配置或重新启用 Webhook、导入导出数据、变更角色、SCIM 或审计流、传输诊断信息或变更付费权益。诊断默认保持只读。