用途:该技能通过 Linear 的 GraphQL 端点管理工单、项目、里程碑和文档,用于协调跨技能(如 orca-security、multi-repo)的工作或跟踪修复进展。仅使用 GraphQL,不使用 linearis 等 CLI 封装。
主要能力:脚本位于 .claude/skills/linear/scripts/,共用同一 GraphQL 客户端并直接访问 https://api.linear.app/graphql。支持列出与全文搜索工单、创建/读取/更新工单、添加评论;创建项目、将工单加入项目;创建里程碑、将工单加入里程碑;创建、列出、读取项目文档。
使用方式:需先设置 API Token:export LINEAR_API_TOKEN='lin_api_xxxxx',令牌从 Linear → Settings → Security & Access → Personal API keys 获取。可用 uv run .claude/skills/linear/scripts/read-ticket.py ICE-2041 验证。优先使用脚本而非临时 curl,脚本会解析名称到 ID、规范化错误并输出 JSON。若操作无封装,可直接调用 GraphQL 端点,注意不要加 Bearer 前缀。
适用场景:为功能、缺陷或修复创建和更新工单;组织项目与里程碑;添加进度或评审评论;管理项目文档;将问题移入项目或里程碑。
限制:当前项目封装不处理截止日期;标签必须已在工作区存在;项目描述上限 255 字符,长文用 content;脚本出错时退出码为 1。技能版本 3.0,仅使用 Linear GraphQL 端点。