用途：与 Linear 项目管理交互，可查询议题、更新状态、创建工单并管理工作流，基于 Linear GraphQL API。
连接方式：当智能体环境中存在已认证的 Linear MCP 工具时应优先使用（以工具可用性判断，不依赖特定 MCP 服务器名称）；仅当 MCP 工具不可用，或明确需要原始 API/curl 访问时，才使用 API key 与下方 GraphQL 指令。Windows PowerShell 等价命令见 references/windows.md。若 LINEAR_API_KEY 缺失且无已认证 MCP 工具，需先请用户提供后再继续。可先检查环境变量： [ -n "$LINEAR_API_KEY" ] && echo "LINEAR_API_KEY is set" || echo "LINEAR_API_KEY is NOT set"
标识符：Linear 议题有两种标识。人类可读标识（如 ALL-1234，团队键+编号）用于展示和搜索查询；UUID（查询结果中的 id 字段）是所有变更操作（更新、评论等）所必需的。工作流为：用人类可读标识搜索或查询，从结果中提取 id（UUID），再在变更操作中使用该 UUID。
认证：所有请求使用 GraphQL，API key 放在 Authorization 头：
curl -s -X POST https://api.linear.app/graphql
-H "Content-Type: application/json"
-H "Authorization: $LINEAR_API_KEY"
-d '{"query": "YOUR_GRAPHQL_QUERY"}'
常见查询：获取已分配的未完结议题；按优先级筛选议题（优先级值：0 无、1 紧急、2 高、3 中、4 低）；获取议题详情；按标识符搜索议题。常见变更：更新议题状态（先查询工作流状态列表取得 stateId，再执行 issueUpdate）；为议题添加评论（commentCreate）；创建新议题（issueCreate，需 teamId、title 等）。
端到端示例：将议题移动至 In Progress——步骤 1 搜索议题 ALL-1234 获取 UUID；步骤 2 列出工作流状态找到 In Progress 状态的 UUID；步骤 3 用两者的 UUID 执行 issueUpdate。
状态类型：backlog 未开始、unstarted Todo、started 进行中、completed 已完成、canceled 不处理。
限制与缺失：除上述内容外，官方未提供更多细节；使用前需确保 LINEAR_API_KEY 可用或已认证 MCP 工具存在。