---

name: linear-claude-skill description: "管理 Linear 问题、项目和团队" risk: safe source: "https://github.com/wrsmith108/linear-claude-skill" date_added: "2026-02-27"

何时使用此技能

管理 Linear 问题、项目和团队

处理 Linear 问题、项目和团队管理时使用此技能。

Linear

用于在 Linear 中管理问题、项目和团队的工具和工作流。

---

工具可用性（先阅读）

此技能支持多种工具后端。使用任何可用的：

1. MCP 工具 (mcp__linear) - 如果在工具集中可用则使用
2. Linear CLI (linear 命令) - 始终可通过 Bash 使用
3. 辅助脚本 - 用于复杂操作

如果 MCP 工具不可用，通过 Bash 使用 Linear CLI：

# View an issue
linear issues view ENG-123

# Create an issue
linear issues create --title "Issue title" --description "Description"

# Update issue status (get state IDs first)
linear issues update ENG-123 -s "STATE_ID"

# Add a comment
linear issues comment add ENG-123 -m "Comment text"

# List issues
linear issues list

不要将"MCP 工具不可用"报告为阻塞问题 - 改用 CLI。

---

安全：Varlock 集成

关键：永远不要在终端输出或 Claude 上下文中暴露 API 密钥。

安全命令（始终使用）

# Validate LINEAR_API_KEY is set (masked output)
varlock load 2>&1 | grep LINEAR

# Run commands with secrets injected
varlock run -- npx tsx scripts/query.ts "query { viewer { name } }"

# Check schema (safe - no values)
cat .env.schema | grep LINEAR

不安全命令（永远不要使用）

# NEVER - exposes key to Claude's context
linear config show
echo $LINEAR_API_KEY
printenv | grep LINEAR
cat .env

新项目设置

1. 创建带 @sensitive 注解的 .env.schema：

   # @type=string(startsWith=lin_api_) @required @sensitive
   LINEAR_API_KEY=
   

2. 将 LINEAR_API_KEY 添加到 .env（永远不要提交此文件）

3. 配置 MCP 使用环境变量：

   {
     "mcpServers": {
       "linear": {
         "env": { "LINEAR_API_KEY": "${LINEAR_API_KEY}" }
       }
     }
   }
   

4. 使用 varlock load 在操作前验证

---

快速开始（首次用户）

1. 检查设置

运行设置检查以验证配置：

npx tsx ~/.claude/skills/linear/scripts/setup.ts

这将检查：

• LINEAR_API_KEY 已设置且有效
• @linear/sdk 已安装
• Linear CLI 可用性（可选）
• MCP 配置（可选）

2. 获取 API 密钥（如需要）

如果设置报告缺少 API 密钥：

1. 在浏览器中打开 Linear
2. 进入 Settings（齿轮图标）-> Security & access -> Personal API keys
3. 点击 Create key 并复制密钥（以 lin_api_ 开头）
4. 添加到环境：

# Option A: Add to shell profile (~/.zshrc or ~/.bashrc)
export LINEAR_API_KEY="lin_api_your_key_here"

# Option B: Add to Claude Code environment
echo 'LINEAR_API_KEY=lin_api_your_key_here' >> ~/.claude/.env

# Then reload your shell or restart Claude Code

3. 测试连接

验证一切正常：

npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"

你应该看到你在 Linear 中的名字。

4. 常用操作

# Create issue in a project
npx tsx scripts/linear-ops.ts create-issue "Project" "Title" "Description"

# Update issue status
npx tsx scripts/linear-ops.ts status Done ENG-123 ENG-124

# Create sub-issue
npx tsx scripts/linear-ops.ts create-sub-issue ENG-100 "Sub-task" "Details"

# Update project status
npx tsx scripts/linear-ops.ts project-status "Phase 1" completed

# Show all commands
npx tsx scripts/linear-ops.ts help

限制

• 仅在任务明确匹配上述描述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来要求澄清。