技能介绍

要解决的问题

在 Linear 里跟踪事项的团队，工作流通常发生在浏览器里：看到一张卡 → 复制 ID → 切到终端改代码 → 再切回去更新状态。对习惯命令行的工程师来说，这种来回切换打断专注。而日常高频操作——查自己的待办、给 issue 加评论、关联 PR、创建文档——本身并不复杂，缺的只是一个贴近终端的入口。

核心能力

@zcwl/openclaw-linear 做的事就是把 Linear 的常见操作搬进 shell。它通过 linear 命令提供几类能力：

事项管理：列出和查看 issue，创建与更新，开始处理某张 issue，发表评论、关联 PR，以及删除。
团队与项目：列出、创建、删除团队，管理成员和 autolinks；项目支持列表、查看与创建。
文档：列表、查看、创建、更新和删除 Linear 文档。
GraphQL 兜底：api 命令可直接发 GraphQL 请求，作为 CLI 未覆盖查询的后备通道。官方建议优先走 CLI，只有当某个查询没有对应子命令时再动用 api。

上手分三步：先在 Linear 账户安全设置页生成 API key；然后执行 linear auth login 完成认证；最后在项目仓库里运行 linear config 配置默认团队等参数。

配置既可用环境变量，也可写进 .linear.toml：团队 ID、工作空间、issue 排序方式（按优先级或手动）、以及 VCS 类型（git 或 jj）。配置文件按当前目录 → 项目根目录 → ~/.config 的顺序查找，因此既能做个人全局配置，也能把项目级设置提交进仓库。

适用边界

这个 CLI 的覆盖面是"常见工作流"而非全量 API。遇到 CLI 没有对应子命令的场景，得退回 api 自己拼 GraphQL，说明它不适合作为复杂查询的唯一入口。另外它依赖 linear 命令本身在 PATH 上，且需要有效的 API key；认证或配置环节出问题时，排查方向是这几处，而不是技能本身。