mcpField
L
linear

linear

github.com/johnlindquist开发2637 次安装45 周前更新
代码仓库

关于 linear

linear 是一项通过 linearis 命令行管理 Linear 问题的技能，适合需要在终端处理问题的开发团队。它涵盖搜索、状态更新、评论及团队和项目查询。

主要功能

  1. 01列出并搜索问题
  2. 02读取问题详情
  3. 03创建和更新问题
  4. 04添加评论
  5. 05查询团队、标签、项目和周期

适用场景

  1. 01按团队或负责人筛选问题
  2. 02推进问题状态并记录进展
  3. 03为问题分配负责人和优先级

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/johnlindquist/claude --skill linear

安装后在 Claude Code 中输入/linear确认已加载。

详细介绍

Linear 问题管理器

使用 linearis CLI 管理 Linear 问题。

前置条件

安装 linearis CLI：

bun add -g linearis

设置你的 API 令牌：

export LINEAR_API_KEY=lin_api_xxxxx

从以下位置获取你的 API 密钥：Linear Settings > API > Personal API keys

CLI 参考

列出问题
# List issues (default: 25)
linearis issues list

# Limit results
linearis issues list --limit 10
搜索问题
# Search by query
linearis issues search "bug"

# Filter by team
linearis issues search "authentication" --team ENG

# Filter by assignee
linearis issues search "feature" --assignee user-id

# Filter by project
linearis issues search "api" --project "Backend"

# Filter by status
linearis issues search "bug" --status "In Progress,Todo"

# Combined filters with limit
linearis issues search "urgent" --team ENG --limit 5
获取问题详情
# Read issue by ID or identifier
linearis issues read ENG-123
linearis issues read abc123-uuid
创建问题
# Basic issue (requires team)
linearis issues create "Fix login bug" --team ENG

# With description
linearis issues create "Add OAuth support" --team ENG -d "Implement Google OAuth"

# With priority (1=Urgent, 2=High, 3=Medium, 4=Low)
linearis issues create "Critical fix" --team ENG -p 1

# With assignee
linearis issues create "Review code" --team ENG --assignee user-id

# With labels
linearis issues create "Security issue" --team ENG --labels "bug,security"

# With project
linearis issues create "New feature" --team ENG --project "Q1 Roadmap"

# With status
linearis issues create "Started task" --team ENG --status "In Progress"

# Full example
linearis issues create "Implement caching" \
  --team ENG \
  -d "Add Redis caching for API responses" \
  -p 2 \
  --labels "feature,performance" \
  --project "Backend" \
  --status "Todo"
更新问题
# Update title
linearis issues update ENG-123 -t "New title"

# Update description
linearis issues update ENG-123 -d "Updated description"

# Change status
linearis issues update ENG-123 -s "In Progress"
linearis issues update ENG-123 -s "Done"

# Change priority
linearis issues update ENG-123 -p 1

# Change assignee
linearis issues update ENG-123 --assignee user-id

# Add labels (default mode: adding)
linearis issues update ENG-123 --labels "urgent,blocked"

# Replace all labels
linearis issues update ENG-123 --labels "new-label" --label-by overwriting

# Clear all labels
linearis issues update ENG-123 --clear-labels

# Set parent issue
linearis issues update ENG-123 --parent-ticket ENG-100

# Clear parent
linearis issues update ENG-123 --clear-parent-ticket

# Set cycle
linearis issues update ENG-123 --cycle "Sprint 5"

# Clear cycle
linearis issues update ENG-123 --clear-cycle
评论
# Add comment to issue
linearis comments create ENG-123 --body "Working on this now"
团队
# List all teams
linearis teams list
标签
# List all labels
linearis labels list
项目
# List projects
linearis projects list
周期
# List cycles
linearis cycles list
用户
# List users
linearis users list

工作流模式

开始处理问题
# 1. Find the issue
linearis issues search "feature name" --team ENG

# 2. Get details
linearis issues read ENG-123

# 3. Update status to In Progress
linearis issues update ENG-123 -s "In Progress"

# 4. Create branch (from issue identifier)
git checkout -b eng-123-feature-name
完成一个问题
# 1. Update status
linearis issues update ENG-123 -s "Done"

# 2. Add completion comment
linearis comments create ENG-123 --body "Completed in PR #456"
每日站会视图
# My in-progress issues
linearis issues search "assignee:me" --status "In Progress"

# Team's blocked issues
linearis issues search "" --team ENG --status "Blocked"
Bug 分类
# Find unassigned bugs
linearis issues search "label:bug" --team ENG

# Assign and prioritize
linearis issues update ENG-456 --assignee user-id -p 1

Git 集成

关联提交

在提交信息中提及问题 ID：

git commit -m "feat: implement caching

Fixes ENG-123"
创建带问题链接的 PR
ISSUE_ID="ENG-123"
gh pr create --title "feat: implement caching" --body "Closes $ISSUE_ID"

优先级值

值含义
0无优先级
1紧急
2高
3中
4低

最佳实践

  1. 使用问题 ID - 在提交/PR 中引用 ENG-123
  2. 更新状态 - 使用 linearis issues update 推动问题流转
  3. 添加评论 - 使用 linearis comments create 跟踪进度
  4. 使用标签 - 分类以便筛选
  5. 关联 PR - 将代码与问题关联
  6. 高效搜索 - 组合筛选条件以获得精确结果

评论

支持 Markdown