用途：在开发流程中通过 Linear CLI（linear）或 Linear GraphQL API 管理问题跟踪与项目。优先使用 CLI，未安装或不支持所需操作时改用 GraphQL API。
访问选择：用 command -v linear 检查 CLI 是否存在；否则用 test -n "${LINEAR_API_KEY:-}" 确认凭据可用。GraphQL 请求发往 https://api.linear.app/graphql，使用 Authorization: $LINEAR_API_KEY 与 JSON 内容类型，并用 GraphQL 变量而非拼接问题文本。HTTP 200 但含 errors 数组视为失败。切勿打印、提交或直接内联 API 密钥。
问题撰写：创建、起草、改写或扩展问题时只忠实记录问题，不做产品规划或方案设计。正文以一段通俗语言开头（In plain terms），说明哪里出错或缺失、影响谁、为何重要，不规定实现方式。只写有来源的事实，保留不确定性；不添加模板化标题、不臆造验收标准、优先级、估算、标签、依赖等规划元数据，也不锁定解决方案。仅在缺少信息会实质歪曲问题时才提问。优先复用已有问题，避免重复工单。
PR 交接：问题仍是权威问题陈述，PR 顶部用真实关系链接（Closes、Advances、Related 或 Issue），PR 的 In plain terms 段落只描述该 PR 对人们带来的变化。
CLI 配置：命令需设置 LINEAR_ISSUE_SORT，例如 export LINEAR_ISSUE_SORT=priority，否则多数命令会失败。用 linear team list 发现团队。状态包括 triage、backlog、unstarted、started、completed、canceled。
常用命令：LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager；加 -s started -s unstarted 过滤状态，--all-states 含已完成/取消；linear issue view WDY-123 --no-pager；linear issue update WDY-123 --state "Done"；linear issue pr WDY-123；linear team list。
适用场景：问题列表与查看、状态更新、创建关联 PR、新问题分诊、结合 git log 核对待关闭问题。限制：CLI 未安装时需改用 GraphQL API；未提供具体安装方式、收费与平台信息。