Linear 项目管理助手

要解决什么问题

团队在 Linear 里管 issue、项目和 roadmap 时，常见痛点是：API 密钥容易出现在终端或对话上下文里；问题先堆在「临时项目」再搬家，导致看板、指标和过滤器对不上；批量改状态或同步代码变更时，不知道该用 MCP、CLI 还是 SDK。

本技能把 Linear 项目管理 收敛成可重复的工作流：优先用官方 MCP（mcp__linear），不可用时走 Linear CLI（linear） 或辅助脚本，而不是把「MCP 不可用」当成阻塞。

核心能力与关键步骤

• 安全：通过 Varlock 与 .env.schema 管理 LINEAR_API_KEY，用 varlock load 校验；禁止在输出中暴露密钥。
• 结构约定：每个 问题必须挂项目，每个 项目必须链到计划（initiative），否则在看板/路线图里会「消失」。
• 规划顺序：先建项目 → 设为 planned → 在项目中直接建 issue → 开工后再改项目状态；避免反模式「先建 issue 再移动项目」。
• 状态与标签：分配给我用 Todo，未分配用 Backlog；标签遵循类型 + 领域 + 可选范围（见文档中的 labels 分类）。
• 工具选型：日常操作用 MCP；批量（3+ issue 状态、多 issue 创建）可用 Linear-specialist 并行子代理；复杂循环/条件用 @linear/sdk；MCP/SDK 不支持时再回退 GraphQL。

首次使用可跑设置检查，确认密钥、@linear/sdk、CLI 与 MCP 配置是否就绪。

适用边界与注意点

• MCP 应使用 mcp.linear.app 官方服务器，勿用已弃用的社区版；创建/更新/搜索 issue 等在高频路径上可靠性较好。
• GraphQL 与 SDK 脚本 仅在 MCP 不足时使用，避免把简单操作过度脚本化。
• 项目生命周期、project-status 状态映射、link-initiative / unlink-initiative 等细节以技能内 projects.md、sync.md、troubleshooting.md 为准；本介绍不替代完整命令参考。