AgentSkillsCN

Linear MCP Integration

借助 Linear MCP 服务器功能，与 Linear 中的议题、项目、团队及评论进行交互。适用场景包括：(1) 从 Linear 中获取议题的需求与验收标准；(2) 根据 Linear 议题的需求对 PR 变更进行验证；(3) 创建或更新 Linear 议题与评论；(4) 检查议题状态、标签或关联关系；(5) 按团队、被分配人或项目列出议题；或 (6) 执行任何 Linear 项目管理相关操作。需确保已正确配置并完成 Linear MCP 服务器的身份验证。

SKILL.md
--- frontmatter
name: Linear MCP Integration
description: >-
  Use Linear MCP server functions to interact with Linear issues, projects, teams,
  and comments. Use when: (1) Fetching issue requirements and acceptance criteria
  from Linear, (2) Validating PR changes against Linear issue requirements,
  (3) Creating or updating Linear issues and comments, (4) Checking issue status,
  labels, or relationships, (5) Listing issues by team, assignee, or project, or
  (6) Any Linear project management operation. Requires Linear MCP server
  configured and authenticated.

Linear MCP Integration

Use Linear MCP server functions to interact with Linear's project management system.

Prerequisites

  • •Linear MCP server configured and available
  • •Authentication: Linear API token configured in MCP server
  • •Access to Linear workspace

Quick Start

Get issue details:

typescript
mcp_Linear_get_issue({
  id: "LIN-123",
  includeRelations: true // get related/blocking issues
})

List issues:

typescript
mcp_Linear_list_issues({
  team: "Engineering",
  state: "In Progress"
})

Usage Patterns for PR Review

Fetch Issue Requirements

Step 1: Extract Issue ID from PR

  • •Look for Linear issue references in PR title/body (e.g., LIN-123, [LIN-123])
  • •Extract issue identifier

Step 2: Get Issue Details

typescript
mcp_Linear_get_issue({
  id: "LIN-123", // extracted from PR
  includeRelations: true // to get blocking/related issues
})

Step 3: Extract Requirements

  • •Parse issue description for acceptance criteria
  • •Check labels for feature tags
  • •Review comments for additional context
  • •Check relatedTo and blocks for dependencies

Validate PR Completeness

Check if PR addresses all requirements:

  1. •Get issue details with mcp_Linear_get_issue
  2. •Parse issue description for:
  • •Acceptance criteria (checkboxes, numbered lists)
  • •Feature requirements
  • •Technical specifications
  1. •Compare PR changes against requirements
  2. •Identify gaps or missing implementations

Update Issue Status

After PR review:

  • •Use mcp_Linear_update_issue to:
    • •Update status (e.g., "In Review", "Ready for QA")
    • •Add comments with review findings
    • •Link related issues

Create Review Comments

Post review findings to Linear:

typescript
mcp_Linear_create_comment({
  issueId: "LIN-123",
  body: "## PR Review Summary\n\n✅ Requirements met: ...\n⚠️ Gaps identified: ..."
})

Common Workflows

PR Review with Issue Validation

  1. •Extract issue reference from PR title/body
  2. •Fetch issue using mcp_Linear_get_issue
  3. •Parse requirements from issue description
  4. •Review PR changes against requirements
  5. •Create comment on Linear issue with review summary
  6. •Update issue status if needed

Issue Discovery

  1. •List issues for a team/project using mcp_Linear_list_issues
  2. •Filter by state, assignee, or labels
  3. •Get details for relevant issues
  4. •Cross-reference with PR changes

Integration with GitHub

When reviewing PRs:

  1. •Extract Linear issue references from PR title/body
  2. •Use Linear MCP to fetch issue requirements
  3. •Validate PR changes against requirements
  4. •Post review findings back to Linear issue

Reference Documentation

  • •MCP Functions Reference: See mcp-functions.md for function summaries and examples. The MCP server provides authoritative function definitions with complete parameter types and schemas.
  • •Linear API Documentation: developers.linear.app/docs