Linear Claude Skill - Linear 项目管理集成

技能概述

Linear Claude Skill 是一个用于在 Claude 中直接管理 Linear issues、项目和团队的集成技能，支持通过 MCP 工具、Linear CLI 或辅助脚本完成项目规划和任务追踪。

适用场景

1. 软件开发项目管理 - 开发团队使用 Linear 进行 issue 追踪、项目规划和状态同步时，可直接在 Claude 中批量更新问题状态、创建子任务、管理项目进度。

2. 敏捷工作流集成 - 支持 Sprint 规划、项目阶段管理、任务分配等敏捷实践，可将代码变更自动同步到 Linear，保持项目状态与代码仓库一致。

3. 团队协作与 Bug 追踪 - 产品经理、开发者和测试人员可通过统一的工作流管理功能请求、Bug 修复和功能发布，使用标签分类和项目关联提高团队协作效率。

核心功能

1. 多工具支持 - 支持 Linear MCP 服务器（推荐）、Linear CLI 命令行工具和 TypeScript SDK 脚本，可根据环境选择最合适的操作方式，实现 issues 创建、状态更新、评论添加等操作。

2. 项目全生命周期管理 - 提供项目创建、状态更新（Backlog/Planned/In-Progress/Completed）、Initiative 关联、子任务拆分等功能，确保每个 issue 关联到项目，每个项目关联到 Initiative。

3. 安全 API 密钥管理 - 集成 Varlock 进行敏感信息管理，支持 .env.schema 注解验证，防止 API Key 在终端或 Claude 上下文中泄露，确保 Linear 集成的安全性。

常见问题

Linear Claude Skill 是什么？

Linear Claude Skill 是一个 Claude 技能插件，让你可以在 Claude 对话中直接操作 Linear 账户，包括创建 issues、更新状态、管理项目等。它支持多种工具后端（MCP 服务器、Linear CLI、SDK 脚本），可适应不同的使用环境。

如何配置 Linear API Key？

首先在 Linear 设置中创建 Personal API Key（以 lin_api_ 开头），然后将其添加到环境变量 LINEAR_API_KEY 中。推荐使用 Varlock 管理密钥，创建 .env.schema 文件并添加 @sensitive 注解，然后通过 varlock load 验证配置。

MCP 工具和 Linear CLI 有什么区别？

MCP（Model Context Protocol）是推荐的操作方式，提供官方服务器支持，可靠性高，适合大部分操作。Linear CLI 是备用方案，当 MCP 不可用时通过命令行完成相同操作。辅助脚本适用于批量操作或复杂的多步骤任务。

如何批量更新 Linear issues 状态？

使用辅助脚本 npx tsx scripts/linear-ops.ts status Done ENG-101 ENG-102 ENG-103 可批量更新多个 issues 的状态。对于 3 个以上的批量操作，推荐使用 Linear-specialist 子代理并行执行以提高效率。

Linear 项目如何链接到 Initiative？

使用 npx tsx scripts/linear-ops.ts link-initiative <project-name> <initiative-name> 命令可将现有项目关联到 Initiative。每个项目应链接到 Initiative 以确保在路线图中可见。创建新项目时可直接指定关联的 Initiative。