linear
作者 Joannis用于通过命令行进行问题跟踪和项目协同的 Linear 技能。可用来列出 issue、查看状态、分流待办、更新状态，并将日常工程输出更少猜测地关联回 Linear。
该技能得分为 78/100，说明它很适合需要 Linear CLI 工作流来做 issue 跟踪和工单管理的用户。仓库提供了足够的触发提示和命令示例，值得安装；但用户也应预期会有一些环境/初始化前提，且其覆盖范围比完整工作流工具包更窄。
- 前置说明中明确给出了 Linear issue、工单分流、状态变更以及 PR 到 issue 关联的触发指引。
- 提供了列出、查看和更新 issue 的具体命令示例，有助于让 agent 更少依赖猜测。
- 操作前提写得很清楚：必须设置 `LINEAR_ISSUE_SORT=priority`，从而减少隐藏的失败模式。
- 工作流覆盖面不够理想：摘录里展示了常见命令，但面向更广泛决策规则或边缘情况的指引较少。
- 没有提供安装命令、支持文件或相关引用，因此是否能顺利采用取决于用户是否已经具备可用的 Linear CLI。
linear 技能概览
linear 技能的作用
linear 技能帮助代理通过命令行使用 Linear 进行 issue 跟踪、分诊，以及轻量级项目协作。它最适合的场景不是“写一段关于 Linear 的好看提示词”，而是“真正以可预测的方式查找、查看、更新或关闭一个 issue”。
适合 issue 跟踪工作流的场景
如果你需要用 Linear 做 Issue Tracking，例如列出 ticket、检查状态、分诊工作，或者把日常工程产出关联回已跟踪的 issue，那么就应该用 linear 技能。它更适合开发者、代理和运维类工作流——在这些场景里，issue 状态比界面导航更重要。
为什么值得安装
当你想要的是可重复的 CLI 工作流，而不是一段泛泛的助手回答时，这个 linear 指南就很实用。它的核心价值在于减少 issue 状态、团队选择，以及可能导致命令无法运行的环境设置方面的歧义。
如何使用 linear 技能
安装并验证命令
使用 npx skills add Joannis/claude-skills --skill linear 安装，然后确认你的环境里可以访问这个 CLI。源文件说明 Linear 通过 Homebrew 安装在 /opt/homebrew/bin/linear，因此在 Apple Silicon 机器上，路径假设很重要。
先设置必要的环境变量
在大多数命令生效之前，先设置 LINEAR_ISSUE_SORT：
export LINEAR_ISSUE_SORT=priority
这在实际使用中不是可选项。如果跳过这一步，linear 的安装可能会成功，但使用时会失败；这也是最常见的落地阻碍。
按正确顺序读取正确的文件
先看 SKILL.md，因为这里包含实际的操作规则。然后只在需要时再检查仓库中的其他内容。这个仓库里没有额外的 rules/、resources/ 或 scripts/ 目录，所以安装决策主要取决于技能正文本身，而不是隐藏的辅助资源。
把模糊目标转成可执行提示词
想把 linear 用好，最好一开始就明确四件事：团队、动作、状态筛选条件和输出意图。比如：“Use linear skill to list active issues for team WDY, filter to started and unstarted, and summarize blockers.” 这比“检查 Linear”更强，因为它给了技能足够的结构去选择正确的命令路径。
linear 技能 FAQ
linear 技能只适合开发者吗？
不是。任何需要用 Linear 做 Issue Tracking 的人都能用，但它尤其适合已经习惯终端工作流的开发者和技术代理。如果你只是偶尔查一下状态，CLI 可能会显得比你真正需要的更重。
这个技能的主要边界是什么？
linear 技能关注的是由 CLI 驱动的 issue 操作，而不是完整的项目管理策略，也不是复杂的 workspace 管理。如果你的任务依赖只能在 UI 中完成的操作、复杂权限，或者组织内定制工作流，那么就要预期结合本地约定一起使用。
使用前需要特殊上下文吗？
需要。你必须知道正确的团队名称或 issue key，还要设置必需的 LINEAR_ISSUE_SORT。没有这些输入，技能只能猜；而猜测恰恰是拖慢 issue 跟踪工作流的原因。
直接用普通提示词，不用技能可以吗？
有时可以，但如果你想要可重复的命令并减少遗漏的假设，专门的 linear 技能会更好。普通提示词可以让系统帮你更新一个 ticket；而当你需要在多个 issue 或多个团队之间持续一致地执行同一种动作时，技能的价值就更明显。
如何改进 linear 技能
给出准确的 issue 上下文
改进 linear 技能输出最有效的方法，是同时提供团队、issue key 和目标状态迁移。比如“Update WDY-123 to started and show the next command if the update fails”就比“把 ticket 移一下”好得多。具体信息越足，来回确认越少，CLI 路径也越确定。
说清工作流目标，而不只是命令
如果你只问一个命令，得到的答案可能会很窄。若你直接描述工作流——例如“triage 新 issue，列出活跃项，然后关闭已完成工作”——技能就能选择更合适的默认值，也更不容易建议无关的状态或筛选条件。
注意常见失败模式
最常见的失败点是没有设置 LINEAR_ISSUE_SORT、团队标识用错，以及把 Linear 的状态标签混淆，比如 unstarted、started 和 completed。如果结果看起来不对，先检查这些输入，再考虑改提示词。
用真实例子反复迭代
在为团队打磨 linear 指南时，拿一个真实 issue 和一个真实团队名作为测试用例反复验证。如果第一次不能干净地列出、查看并更新那个 issue，就把提示词收紧到明确的命令目标、预期状态，以及任何分页或输出限制。