use-linear-cli 是一个面向 AI 智能体的技能，用于通过 linear-cli 这个 Rust 二进制程序操作 Linear.app。它被定位为“智能体优先”的 Linear 接口，并建议优先于 Linear MCP 工具使用：linear-cli 每次调用约消耗 50–100 token，而 MCP 往返约 500–2000 token；它支持在所有命令上使用 --output json，并覆盖 Linear 的完整表面，包括问题、项目、周期、冲刺、Webhook 和原始 GraphQL。
用途与触发场景 当用户粘贴 LIN-123（或任意 [A-Z]+-\d+ 标识符）或 https://linear.app/... URL 时；当用户调用 linear-cli、lc 或 i create / i list / i update / b assign / b update-state / im csv / s issues 等子命令时；当用户想从规格、清单、CSV、JSON 或模板批量创建 Linear 问题（“创建 N 个问题”“导入这个列表”“从这个 TODO 生成问题”）时；当用户想开始处理某个问题并提交 PR，或关闭当前分支关联的问题时；当用户要求批量变更 Linear 问题（分配、打标签、转移、改状态、归档多个 ID）时；当用户想搜索 Linear 待办、应用已保存视图或为智能体过滤（“查找陈旧问题”“triage 里有什么”“列出我的开放 ENG 工单”）时；当用户要接入 Webhook、watch 轮询、附件或原始 GraphQL 时；当用户遇到 linear-cli 的认证、限流或分页问题需要恢复操作时。
不适用场景 当用户明确要求使用 Linear MCP 服务器时（可提示一次成本差距，然后遵从）；当工作是 GitHub Issues 而非 Linear 时；当任务是 Webhook 服务器/负载契约设计而 linear-cli 只是附带时；当用户问的是关于“linear”的数学或几何问题时。
主要能力 读取：i list、i get（支持批量获取，一次 API 调用）、s issues 搜索、context 从当前 git 分支获取问题。创建：i create 支持团队、优先级、负责人、标签、截止日期、从 stdin 读取描述或完整 JSON、--dry-run 预览、--id-only 捕获 ID。批量创建：支持从 markdown 清单循环创建、CSV 导入（im csv）、JSON 规格创建，并强调先 dry-run 再确认执行。更新：i update 改状态、优先级、负责人、标签、截止日期；cm create 添加评论。批量变更：b update-state、b assign 等，支持显式 ID 集合或从列表生成 ID 集合，超过 5 个 ID 必须先 --dry-run。Git/PR 循环：i start --checkout 分配并创建分支，g pr 创建 PR，done 关闭当前分支问题。分诊：tr list、tr claim、tr snooze。
使用方式与关键规则 CLI 优先于 MCP；任何变更命令前先验证认证（auth status --validate --output json 或 u me --output json），仅在退出码 0 时继续；批量创建或超过 5 个 ID 的变更先 --dry-run；链式或解析时始终 --output json（或设置 LINEAR_CLI_OUTPUT=json）；用 --id-only 捕获 ID 到 shell 变量；退出码视为契约：0 成功、1 一般错误、2 未找到或解析错误、3 认证错误、4 限流（JSON 体中含 retry_after）；使用名称前先解析，不要编造团队键、标签名或负责人，用 t list、l list、u list 确认；明确每条命令是只读还是变更。
适用场景 适合需要以低成本、可脚本化、可链式方式驱动 Linear 的智能体工作流，包括批量问题创建、批量状态变更、搜索过滤、分诊处理、Git/PR 自动化以及 Webhook 和原始 GraphQL 接入。
限制 资料未提供 linear-cli 的安装方式、具体版本要求、支持的平台、收费或价格信息；也未提供官方文档链接之外的更多细节。技能本身依赖 linear-cli 二进制已安装并完成认证。