Linear Claude Skill
让 Claude Code 直接管理 Linear 的问题单、项目和团队：MCP、SDK 自动化与 GraphQL API 三种后端，覆盖建单、改状态、批量同步到图片上传。
SKILL.md 明确警示不得在终端或上下文中暴露 LINEAR_API_KEY，列出安全/不安全命令，推荐 varlock 掩码注入，MIT 许可，无恶意行为迹象；但 allowed-tools 授予完整 Bash 权限，外部写操作（创建/更新/批量同步 issue）默认无需用户确认，缺少回滚机制，扣分。
文档自洽，多级回退（MCP→CLI→脚本→SDK→GraphQL），有 setup 诊断、dry-run、--strict 等失败反馈设计，CHANGELOG 显示 bug 修复历史；但静态审查未执行，仅声明 smoke tests，未见针对关键路径的完整测试证据，上限 10。
触发条件（Linear 任务、issue、项目管理）在 description 中清晰，场景与示例丰富，已知陷阱有记录；但边界与非适用范围未明示，核心功能完全依赖 Linear 云服务及 npm/brew 等海外可达性，中国大陆网络环境可能不可用，且无中文支持说明，扣分。
文档分层良好（SKILL.md 引用 api/sdk/sync/projects/troubleshooting/labels），版本号 3.4.1 与 CHANGELOG、语义化发布对齐，MIT 许可明确，有维护痕迹（2026 年更新）；但发布者身份未经验证，维护责任与更新路径仅隐含于个人仓库，扣分。
宣称覆盖 issue/项目/团队全流程，提供模板、校验、批量导入、dry-run 等，边际价值高于手工 GraphQL；但静态审查无法验证实际输出正确性，且变更日志中 MCP 可靠性描述前后矛盾（曾称 50% 失败后改称高可靠），上限 7，扣 1。
有 CHANGELOG 指向提交/issue、package-lock 固定依赖版本、CI 与 smoke test 声明，属可审计一手材料；但未执行复现，测试覆盖范围未知，第三方佐证缺失，上限 5。
- 核心功能完全依赖 Linear 云服务与 npm/brew 等海外渠道，中国大陆网络可能无法使用。
- allowed-tools 授予完整 Bash 权限，批量写操作（同步、状态更新）默认无需用户确认，建议敏感变更前人工复核。
- MCP 可靠性描述在不同版本间矛盾，使用前请以官方文档为准自行验证。
- 发布者未经验证，属个人维护仓库，长期维护无保障。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 Claude Code 的 Linear 项目管理技能，把建问题单、更新状态、管理项目与发起式目标（initiative）整合为一套可复用的操作规范。它优先使用官方 Linear MCP 服务器，MCP 不可用时自动退回 Linear CLI 或 @linear/sdk 脚本，最后才用 GraphQL 直连。内置必填的问题单模板（含验收标准）、基于领域的标签体系，以及“先查重再创建”的项目规划流程。还提供 varlock 密钥掩码、图片提取与上传、批量导入和并行子代理同步等进阶能力。
读取 Linear 工作区数据（问题单、项目、团队、initiative）；通过 MCP、npm run ops 命令行或 @linear/sdk/GraphQL 创建和更新问题单、设置父子关系、批量改状态、更新项目状态并关联 initiative；强制执行六段式描述模板并用 validate-description 做前置校验；应用 25 个标签的三类标签体系并提供校验与建议；从会话 JSONL 提取图片并经 Linear S3 上传附件；用 bulk-create.ts 从 manifest 目录批量导入带媒体文件的问题单；运行 npm run setup 做环境自检。
- 用 Claude Code 管理 Linear 工作区的开发者，希望在对话中直接建单、改状态而不切换网页
- 团队负责人想在规划阶段一次性创建项目及其全部问题单，保证可追溯性
- 需要把客户反馈或回顾行动项批量导入 Linear，并附截图/录屏的团队
- 已在用 MCP 工具但担心可靠性，想要 CLI/SDK 兜底路径的团队
- 希望强制问题单带验收标准和统一标签，便于代理路由与审计的工程组织
这个 Skill 有哪些优点和局限？
- 多后端容错：MCP、CLI、SDK、GraphQL 逐级降级，不会因 MCP 缺失而卡死
- 强制六段式问题单模板与验收标准校验，提升单据质量
- 安全设计到位：varlock 掩码 API 密钥，明确列出禁止的泄漏命令
- 覆盖长尾需求：批量导入、图片上传提取、并行子代理同步、post-edit 钩子
- esbuild 预编译带来约 18 倍 CLI 启动加速，并有冒烟测试
- 强绑定 Claude Code 生态（allowed-tools、Linear-specialist 子代理、hooks），移植到其他客户端需改写
- 依赖较多：Node.js、@linear/sdk、MCP 服务器，可选组件（lin CLI、varlock）进一步增加配置面
- MCP 路径的模板校验只是指令层约定，无服务端硬门禁，需靠 lint-issues 事后审计
- 文档主要面向单一作者的实践工作流，缺少独立平台测试证据
如何安装这个 Skill？
需要 Node.js >= 20.11.0 和一个 Linear 个人 API 密钥（Settings → Security & access → Personal API keys，以 lin_api_ 开头）。安装：git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear && cd ~/.claude/skills/linear && npm install。推荐在 MCP 配置中加官方服务器：{"mcpServers":{"linear":{"command":"npx","args":["mcp-remote","https://mcp.linear.app/sse"],"env":{"LINEAR_API_KEY":"your_api_key"}}}}。可运行 npm run build 用 esbuild 预编译（冷启动约快 18 倍）。可选安装 lin CLI（brew install aaronkwhite/tap/lin 或 cargo install lincli）加速读操作。
如何使用这个 Skill？
先运行 npm run setup 自检，再用 npm run query -- "query { viewer { name } }" 验证连接。之后直接在 Claude Code 对话中说“Create a high priority issue titled 'Fix auth bug' in the ENG team”，或使用命令行：npm run ops -- create-issue "项目" "标题" "描述"；npm run ops -- status Done ENG-123；npm run ops -- project-status "Phase 1" completed；npm run ops -- help 查看全部命令。建单时 CLI 会强制要求含 Acceptance Criteria 的模板描述。
这个 Skill 与同类方案有什么区别？
源文档明确对比了 Linear 官方 MCP 服务器（mcp.linear.app）与已弃用的社区服务器（如 linear-mcp-server npm 包、jerhadf/linear-mcp-server），并强烈建议只用官方服务器以保证可靠性；此外把可选的 lin Rust CLI 定位为读操作的快速通道，不可用时静默回退到 SDK。