Back to Details

linear-claude-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

When to Use This Skill

何时使用此技能

Manage Linear issues, projects, and teams
Use this skill when working with manage linear issues, projects, and teams.
管理Linear的任务、项目与团队
当你需要管理Linear的任务、项目与团队时，使用此技能。

Linear

Linear

Tools and workflows for managing issues, projects, and teams in Linear.
用于在Linear中管理任务、项目与团队的工具和工作流。

⚠️ Tool Availability (READ FIRST)

⚠️ 工具可用性（请先阅读）

This skill supports multiple tool backends. Use whichever is available:
  1. MCP Tools (mcp__linear) - Use if available in your tool set
  2. Linear CLI (
    linear
    command)     - Always available via Bash
  3. Helper Scripts - For complex operations
If MCP tools are NOT available, use the Linear CLI via Bash:
bash
undefined
此技能支持多种工具后端。使用任何可用的工具即可：
  1. MCP Tools (mcp__linear) - 如果你的工具集中有此工具，请使用它
  2. Linear CLI（
    linear
    命令）     - 可通过Bash随时使用
  3. 辅助脚本 - 用于复杂操作
如果MCP工具不可用，请通过Bash使用Linear CLI：
bash
undefined

View an issue

View an issue

linear issues view ENG-123
linear issues view ENG-123

Create an issue

Create an issue

linear issues create --title "Issue title" --description "Description"
linear issues create --title "Issue title" --description "Description"

Update issue status (get state IDs first)

Update issue status (get state IDs first)

linear issues update ENG-123 -s "STATE_ID"
linear issues update ENG-123 -s "STATE_ID"

Add a comment

Add a comment

linear issues comment add ENG-123 -m "Comment text"
linear issues comment add ENG-123 -m "Comment text"

List issues

List issues

linear issues list

**Do NOT report "MCP tools not available" as a blocker** - use CLI instead.

---
linear issues list

**不要将“MCP工具不可用”报告为障碍** - 改用CLI即可。

---

When to Use This Skill

何时使用此技能

Manage Linear issues, projects, and teams
Use this skill when working with manage linear issues, projects, and teams.
管理Linear的任务、项目与团队
当你需要管理Linear的任务、项目与团队时，使用此技能。

🔐 Security: Varlock Integration

🔐 安全性：Varlock集成

CRITICAL: Never expose API keys in terminal output or Claude's context.
至关重要：切勿在终端输出或Claude的上下文环境中暴露API密钥。

Safe Commands (Always Use)

安全命令（请始终使用）

bash
undefined
bash
undefined

Validate LINEAR_API_KEY is set (masked output)

Validate LINEAR_API_KEY is set (masked output)

varlock load 2>&1 | grep LINEAR
varlock load 2>&1 | grep LINEAR

Run commands with secrets injected

Run commands with secrets injected

varlock run -- npx tsx scripts/query.ts "query { viewer { name } }"
varlock run -- npx tsx scripts/query.ts "query { viewer { name } }"

Check schema (safe - no values)

Check schema (safe - no values)

cat .env.schema | grep LINEAR
undefined
cat .env.schema | grep LINEAR
undefined

Unsafe Commands (NEVER Use)

不安全命令（切勿使用）

bash
undefined
bash
undefined

❌ NEVER - exposes key to Claude's context

❌ NEVER - exposes key to Claude's context

linear config show echo $LINEAR_API_KEY printenv | grep LINEAR cat .env
undefined
linear config show echo $LINEAR_API_KEY printenv | grep LINEAR cat .env
undefined

Setup for New Projects

新项目设置

  1. Create 
    .env.schema
    with 
    @sensitive
    annotation:
    bash
    # @type=string(startsWith=lin_api_) @required @sensitive
LINEAR_API_KEY=
  2. Add 
    LINEAR_API_KEY
    to 
    .env
    (never commit this file)
  3. Configure MCP to use environment variable:
    json
    {
  "mcpServers": {
    "linear": {
      "env": { "LINEAR_API_KEY": "${LINEAR_API_KEY}" }
    }
  }
}
  4. Use 
    varlock load
    to validate before operations
  1. 创建带有
    @sensitive
    注解的
    .env.schema
    ：
    bash
    # @type=string(startsWith=lin_api_) @required @sensitive
LINEAR_API_KEY=
  2. 将
    LINEAR_API_KEY
    添加到
    .env
    中（切勿提交此文件）
  3. 配置MCP以使用环境变量：
    json
    {
  "mcpServers": {
    "linear": {
      "env": { "LINEAR_API_KEY": "${LINEAR_API_KEY}" }
    }
  }
}
  4. 在操作前使用
    varlock load
    验证配置

Quick Start (First-Time Users)

快速入门（首次使用者）

1. Check Your Setup

1. 检查你的设置

Run the setup check to verify your configuration:
bash
npx tsx ~/.claude/skills/linear/scripts/setup.ts
This will check:
  • LINEAR_API_KEY is set and valid
  • @linear/sdk is installed
  • Linear CLI availability (optional)
  • MCP configuration (optional)
运行设置检查以验证你的配置：
bash
npx tsx ~/.claude/skills/linear/scripts/setup.ts
此命令将检查：
  • LINEAR_API_KEY是否已设置且有效
  • @linear/sdk是否已安装
  • Linear CLI是否可用（可选）
  • MCP配置是否正确（可选）

2. Get API Key (If Needed)

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

If setup reports a missing API key:
  1. Open Linear in your browser
  2. Go to Settings (gear icon) -> Security & access -> Personal API keys
  3. Click Create key and copy the key (starts with 
    lin_api_
    )
  4. Add to your environment:
bash
undefined
如果设置检查报告缺少API密钥：
  1. 在浏览器中打开Linear
  2. 进入设置（齿轮图标）-> 安全与访问 -> 个人API密钥
  3. 点击创建密钥并复制密钥（以
    lin_api_
    开头）
  4. 将其添加到你的环境中：
bash
undefined

Option A: Add to shell profile (~/.zshrc or ~/.bashrc)

选项A：添加到shell配置文件（/.zshrc或/.bashrc）

export LINEAR_API_KEY="lin_api_your_key_here"
export LINEAR_API_KEY="lin_api_your_key_here"

Option B: Add to Claude Code environment

选项B：添加到Claude Code环境

echo 'LINEAR_API_KEY=lin_api_your_key_here' >> ~/.claude/.env
echo 'LINEAR_API_KEY=lin_api_your_key_here' >> ~/.claude/.env

Then reload your shell or restart Claude Code

然后重新加载shell或重启Claude Code

undefined
undefined

3. Test Connection

3. 测试连接

Verify everything works:
bash
npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"
You should see your name from Linear.
验证所有功能是否正常工作：
bash
npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"
你应该会看到你在Linear中的用户名。

4. Common Operations

4. 常见操作

bash
undefined
bash
undefined

Create issue in a project

在项目中创建任务

npx tsx scripts/linear-ops.ts create-issue "Project" "Title" "Description"
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
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"
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
npx tsx scripts/linear-ops.ts project-status "Phase 1" completed

Show all commands

查看所有命令

npx tsx scripts/linear-ops.ts help

See [Project Management Commands](#project-management-commands) for full reference.

---
npx tsx scripts/linear-ops.ts help

请参阅[项目管理命令](#项目管理命令)获取完整参考。

---

When to Use This Skill

何时使用此技能

Manage Linear issues, projects, and teams
Use this skill when working with manage linear issues, projects, and teams.
管理Linear的任务、项目与团队
当你需要管理Linear的任务、项目与团队时，使用此技能。

Project Planning Workflow

项目规划工作流

Create Issues in the Correct Project from the Start

从一开始就在正确的项目中创建任务

Best Practice: When planning a new phase or initiative, create the project and its issues together in a single planning session. Avoid creating issues in a catch-all project and moving them later.
最佳实践：当规划新阶段或新举措时，在同一个规划会话中同时创建项目及其任务。避免先在临时项目中创建任务，之后再移动它们。

Recommended Workflow

推荐工作流

  1. Create the project first:
    bash
    npx tsx scripts/linear-ops.ts create-project "Phase X: Feature Name" "My Initiative"
  2. Set project state to Planned:
    bash
    npx tsx scripts/linear-ops.ts project-status "Phase X: Feature Name" planned
  3. Create issues directly in the project:
    bash
    npx tsx scripts/linear-ops.ts create-issue "Phase X: Feature Name" "Parent task" "Description"
npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "Sub-task 1" "Description"
npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "Sub-task 2" "Description"
  4. Update project state when work begins:
    bash
    npx tsx scripts/linear-ops.ts project-status "Phase X: Feature Name" in-progress
  1. 先创建项目：
    bash
    npx tsx scripts/linear-ops.ts create-project "Phase X: Feature Name" "My Initiative"
  2. 将项目状态设置为已规划：
    bash
    npx tsx scripts/linear-ops.ts project-status "Phase X: Feature Name" planned
  3. 直接在项目中创建任务：
    bash
    npx tsx scripts/linear-ops.ts create-issue "Phase X: Feature Name" "Parent task" "Description"
npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "Sub-task 1" "Description"
npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "Sub-task 2" "Description"
  4. 当工作开始时更新项目状态：
    bash
    npx tsx scripts/linear-ops.ts project-status "Phase X: Feature Name" in-progress

Why This Matters

为什么这很重要

  • Traceability: Issues are linked to their project from creation
  • Metrics: Project progress tracking is accurate from day one
  • Workflow: No time wasted moving issues between projects
  • Organization: Linear views and filters work correctly
  • 可追溯性：任务从创建时就与项目关联
  • 指标：项目进度跟踪从第一天起就是准确的
  • 工作流：无需浪费时间在项目之间移动任务
  • 组织性：Linear的视图和筛选功能可以正常工作

Anti-Pattern to Avoid

应避免的反模式

❌ Creating issues in a "holding" project and moving them later:
bash
undefined
❌ 在“临时”项目中创建任务，之后再移动它们：
bash
undefined

Don't do this

不要这样做

create-issue "Phase 6A" "New feature" # Wrong project
create-issue "Phase 6A" "New feature" # 错误的项目

Later: manually move to Phase X # Extra work

之后：手动移动到Phase X # 额外的工作


---

---

Project Management Commands

项目管理命令

project-status

project-status

Update a project's state in Linear. Accepts user-friendly terminology that maps to Linear's API.
bash
npx tsx scripts/linear-ops.ts project-status <project-name> <state>
Valid States:
InputDescriptionAPI Value
backlog
Not yet startedbacklog
planned
Scheduled for futureplanned
in-progress
Currently activestarted
paused
Temporarily on holdpaused
completed
Successfully finishedcompleted
canceled
Will not be donecanceled
Examples:
bash
undefined
更新Linear中项目的状态。接受与Linear API映射的用户友好术语。
bash
npx tsx scripts/linear-ops.ts project-status <project-name> <state>
有效状态：
输入值描述API值
backlog
尚未开始backlog
planned
已计划在未来进行planned
in-progress
当前正在进行started
paused
暂时搁置paused
completed
已成功完成completed
canceled
不会再进行canceled
示例：
bash
undefined

Start working on a project

开始处理一个项目

npx tsx scripts/linear-ops.ts project-status "Phase 8: MCP Decision Engine" in-progress
npx tsx scripts/linear-ops.ts project-status "Phase 8: MCP Decision Engine" in-progress

Mark project complete

标记项目完成

npx tsx scripts/linear-ops.ts project-status "Phase 8" completed
npx tsx scripts/linear-ops.ts project-status "Phase 8" completed

Partial name matching works

部分名称匹配有效

npx tsx scripts/linear-ops.ts project-status "Phase 8" paused
undefined
npx tsx scripts/linear-ops.ts project-status "Phase 8" paused
undefined

link-initiative

link-initiative

Link an existing project to an initiative.
bash
npx tsx scripts/linear-ops.ts link-initiative <project-name> <initiative-name>
Examples:
bash
undefined
将现有项目关联到一个举措。
bash
npx tsx scripts/linear-ops.ts link-initiative <project-name> <initiative-name>
示例：
bash
undefined

Link a project to an initiative

将项目关联到举措

npx tsx scripts/linear-ops.ts link-initiative "Phase 8: MCP Decision Engine" "Q1 Goals"
npx tsx scripts/linear-ops.ts link-initiative "Phase 8: MCP Decision Engine" "Q1 Goals"

Partial matching works

部分匹配有效

npx tsx scripts/linear-ops.ts link-initiative "Phase 8" "Q1 Goals"
undefined
npx tsx scripts/linear-ops.ts link-initiative "Phase 8" "Q1 Goals"
undefined

unlink-initiative

unlink-initiative

Remove a project from an initiative.
bash
npx tsx scripts/linear-ops.ts unlink-initiative <project-name> <initiative-name>
Examples:
bash
undefined
将项目从举措中移除关联。
bash
npx tsx scripts/linear-ops.ts unlink-initiative <project-name> <initiative-name>
示例：
bash
undefined

Remove incorrect link

移除错误的关联

npx tsx scripts/linear-ops.ts unlink-initiative "Phase 8" "Linear Skill"
npx tsx scripts/linear-ops.ts unlink-initiative "Phase 8" "Linear Skill"

Clean up test links

清理测试关联

npx tsx scripts/linear-ops.ts unlink-initiative "Test Project" "Q1 Goals"

**Error Handling:**
- Returns error if project is not linked to the specified initiative
- Returns error if project or initiative not found
npx tsx scripts/linear-ops.ts unlink-initiative "Test Project" "Q1 Goals"

**错误处理：**
- 如果项目未关联到指定的举措，将返回错误
- 如果项目或举措未找到，将返回错误

Complete Project Lifecycle Example

完整项目生命周期示例

bash
undefined
bash
undefined

1. Create project linked to initiative

1. 创建关联到举措的项目

npx tsx scripts/linear-ops.ts create-project "Phase 11: New Feature" "Q1 Goals"
npx tsx scripts/linear-ops.ts create-project "Phase 11: New Feature" "Q1 Goals"

2. Set state to planned

2. 设置状态为已规划

npx tsx scripts/linear-ops.ts project-status "Phase 11" planned
npx tsx scripts/linear-ops.ts project-status "Phase 11" planned

3. Create issues in the project

3. 在项目中创建任务

npx tsx scripts/linear-ops.ts create-issue "Phase 11" "Parent task" "Description" npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "Sub-task 1" "Details"
npx tsx scripts/linear-ops.ts create-issue "Phase 11" "Parent task" "Description" npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "Sub-task 1" "Details"

4. Start work - update to in-progress

4. 开始工作 - 更新为进行中

npx tsx scripts/linear-ops.ts project-status "Phase 11" in-progress
npx tsx scripts/linear-ops.ts project-status "Phase 11" in-progress

5. Mark issues done

5. 标记任务完成

npx tsx scripts/linear-ops.ts status Done ENG-XXX ENG-YYY
npx tsx scripts/linear-ops.ts status Done ENG-XXX ENG-YYY

6. Complete project

6. 完成项目

npx tsx scripts/linear-ops.ts project-status "Phase 11" completed
npx tsx scripts/linear-ops.ts project-status "Phase 11" completed

7. (Optional) Link to additional initiative

7.（可选）关联到额外的举措

npx tsx scripts/linear-ops.ts link-initiative "Phase 11" "Q2 Goals"

---
npx tsx scripts/linear-ops.ts link-initiative "Phase 11" "Q2 Goals"

---

When to Use This Skill

何时使用此技能

Manage Linear issues, projects, and teams
Use this skill when working with manage linear issues, projects, and teams.
管理Linear的任务、项目与团队
当你需要管理Linear的任务、项目与团队时，使用此技能。

Tool Selection

工具选择

Choose the right tool for the task:
ToolWhen to Use
MCP (Official Server)Most operations - PREFERRED
Helper ScriptsBulk operations, when MCP unavailable
SDK scriptsComplex operations (loops, conditionals)
GraphQL APIOperations not supported by MCP/SDK
为任务选择合适的工具：
工具使用场景
MCP（官方服务器）大多数操作 - 推荐使用
辅助脚本批量操作，当MCP不可用时
SDK脚本复杂操作（循环、条件判断）
GraphQL APIMCP/SDK不支持的操作

MCP Server Configuration

MCP服务器配置

Use the official Linear MCP server at 
mcp.linear.app
:
json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.linear.app/sse"],
      "env": { "LINEAR_API_KEY": "your_api_key" }
    }
  }
}
WARNING: Do NOT use deprecated community servers. See troubleshooting.md for details.
使用位于
mcp.linear.app
的官方Linear MCP服务器：
json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.linear.app/sse"],
      "env": { "LINEAR_API_KEY": "your_api_key" }
    }
  }
}
警告：请勿使用已弃用的社区服务器。详情请参阅troubleshooting.md。

MCP Reliability (Official Server)

MCP可靠性（官方服务器）

OperationReliabilityNotes
Create issue✅ HighFull support
Update status✅ HighUse 
state: "Done"
directly
List/Search issues✅ HighSupports filters, queries
Add comment✅ HighWorks with issue IDs
操作可靠性说明
创建任务✅ 高完全支持
更新状态✅ 高直接使用
state: "Done"
列出/搜索任务✅ 高支持筛选、查询
添加评论✅ 高支持任务ID

Quick Status Update

快速更新状态

bash
undefined
bash
undefined

Via MCP - use human-readable state names

通过MCP - 使用易读的状态名称

update_issue with id="issue-uuid", state="Done"
update_issue with id="issue-uuid", state="Done"

Via helper script (bulk operations)

通过辅助脚本（批量操作）

node scripts/linear-helpers.mjs update-status Done 123 124 125
undefined
node scripts/linear-helpers.mjs update-status Done 123 124 125
undefined

Helper Script Reference

辅助脚本参考

For detailed helper script usage, see troubleshooting.md.
有关辅助脚本的详细用法，请参阅troubleshooting.md。

Parallel Agent Execution

并行Agent执行

For bulk operations or background execution, use the 
Linear-specialist
subagent:
javascript
Task({
  description: "Update Linear issues",
  prompt: "Mark ENG-101, ENG-102, ENG-103 as Done",
  subagent_type: "Linear-specialist"
})
When to use 
Linear-specialist
(parallel):
  • Bulk status updates (3+ issues)
  • Project status changes
  • Creating multiple issues
  • Sync operations after code changes
When to use direct execution:
  • Single issue queries
  • Viewing issue details
  • Quick status checks
  • Operations needing immediate results
See sync.md for parallel execution patterns.
对于批量操作或后台执行，请使用
Linear-specialist
子Agent：
javascript
Task({
  description: "Update Linear issues",
  prompt: "Mark ENG-101, ENG-102, ENG-103 as Done",
  subagent_type: "Linear-specialist"
})
何时使用
Linear-specialist
（并行）：
  • 批量状态更新（3个及以上任务）
  • 项目状态变更
  • 创建多个任务
  • 代码变更后的同步操作
何时使用直接执行：
  • 单个任务查询
  • 查看任务详情
  • 快速状态检查
  • 需要即时结果的操作
有关并行执行模式，请参阅sync.md。

Critical Requirements

关键要求

Issues → Projects → Initiatives

任务 → 项目 → 举措

Every issue MUST be attached to a project. Every project MUST be linked to an initiative.
EntityMust Link ToIf Missing
IssueProjectNot visible in project board
ProjectInitiativeNot visible in roadmap
See projects.md for complete project creation checklist.
每个任务必须关联到一个项目。每个项目必须关联到一个举措。
实体必须关联到如果缺失
任务项目在项目看板中不可见
项目举措在路线图中不可见
完整的项目创建清单请参阅projects.md。

Conventions

约定

Issue Status

任务状态

  • Assigned to me: Set 
    state: "Todo"
  • Unassigned: Set 
    state: "Backlog"
  • 分配给我：设置
    state: "Todo"
  • 未分配：设置
    state: "Backlog"

Labels

标签

Uses domain-based label taxonomy. See docs/labels.md.
Key rules:
  • ONE Type label: 
    feature
    , 
    bug
    , 
    refactor
    , 
    chore
    , 
    spike
  • 1-2 Domain labels: 
    security
    , 
    backend
    , 
    frontend
    , etc.
  • Scope labels when applicable: 
    blocked
    , 
    breaking-change
    , 
    tech-debt
bash
undefined
使用基于领域的标签分类法。请参阅docs/labels.md。
关键规则：
  • 一个类型标签：
    feature
    、
    bug
    、
    refactor
    、
    chore
    、
    spike
  • 1-2个领域标签：
    security
    、
    backend
    、
    frontend
    等
  • 适用时使用范围标签：
    blocked
    、
    breaking-change
    、
    tech-debt
bash
undefined

Validate labels

验证标签

npx tsx scripts/linear-ops.ts labels validate "feature,security"
npx tsx scripts/linear-ops.ts labels validate "feature,security"

Suggest labels for issue

为任务推荐标签

npx tsx scripts/linear-ops.ts labels suggest "Fix XSS vulnerability"
undefined
npx tsx scripts/linear-ops.ts labels suggest "Fix XSS vulnerability"
undefined

SDK Automation Scripts

SDK自动化脚本

Use only when MCP tools are insufficient. For complex operations involving loops, mapping, or bulk updates, write TypeScript scripts using 
@linear/sdk
. See 
sdk.md
for:
  • Complete script patterns and templates
  • Common automation examples (bulk updates, filtering, reporting)
  • Tool selection criteria
Scripts provide full type hints and are easier to debug than raw GraphQL for multi-step operations.
仅当MCP工具不足以完成任务时使用。对于涉及循环、映射或批量更新的复杂操作，请使用
@linear/sdk
编写TypeScript脚本。请参阅
sdk.md
获取：
  • 完整的脚本模式和模板
  • 常见自动化示例（批量更新、筛选、报告）
  • 工具选择标准
脚本提供完整的类型提示，对于多步骤操作，比原始GraphQL更易于调试。

GraphQL API

GraphQL API

Fallback only. Use when operations aren't supported by MCP or SDK.
See api.md for complete documentation including:
  • Authentication and setup
  • Example queries and mutations
  • Timeout handling patterns
  • MCP timeout workarounds
  • Shell script compatibility
Quick ad-hoc query:
bash
npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"
仅作为备选方案。当MCP或SDK不支持该操作时使用。
请参阅api.md获取完整文档，包括：
  • 身份验证和设置
  • 查询和变更示例
  • 超时处理模式
  • MCP超时解决方法
  • Shell脚本兼容性
快速临时查询：
bash
npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"

Projects & Initiatives

项目与举措

For advanced project and initiative management patterns, see projects.md.
Quick reference - common project commands:
bash
undefined
有关高级项目和举措管理模式，请参阅projects.md。
快速参考 - 常见项目命令：
bash
undefined

Create project linked to initiative

创建关联到举措的项目

npx tsx scripts/linear-ops.ts create-project "Phase X: Name" "My Initiative"
npx tsx scripts/linear-ops.ts create-project "Phase X: Name" "My Initiative"

Update project status

更新项目状态

npx tsx scripts/linear-ops.ts project-status "Phase X" in-progress npx tsx scripts/linear-ops.ts project-status "Phase X" completed
npx tsx scripts/linear-ops.ts project-status "Phase X" in-progress npx tsx scripts/linear-ops.ts project-status "Phase X" completed

Link/unlink projects to initiatives

将项目关联/取消关联到举措

npx tsx scripts/linear-ops.ts link-initiative "Phase X" "My Initiative" npx tsx scripts/linear-ops.ts unlink-initiative "Phase X" "Old Initiative"

**Key topics in projects.md:**
- Project creation checklist (mandatory steps)
- Content vs Description fields
- Discovery before creation
- Codebase verification before work
- Sub-issue management
- Project status updates
- Project updates (status reports)

---
npx tsx scripts/linear-ops.ts link-initiative "Phase X" "My Initiative" npx tsx scripts/linear-ops.ts unlink-initiative "Phase X" "Old Initiative"

**projects.md中的关键主题：**
- 项目创建清单（必填步骤）
- 内容与描述字段
- 创建前的调研
- 工作前的代码库验证
- 子任务管理
- 项目状态更新
- 项目更新（状态报告）

---

When to Use This Skill

何时使用此技能

Manage Linear issues, projects, and teams
Use this skill when working with manage linear issues, projects, and teams.
管理Linear的任务、项目与团队
当你需要管理Linear的任务、项目与团队时，使用此技能。

Sync Patterns (Bulk Operations)

同步模式（批量操作）

For bulk synchronization of code changes to Linear, see sync.md.
Quick sync commands:
bash
undefined
有关代码变更与Linear的批量同步，请参阅sync.md。
快速同步命令：
bash
undefined

Bulk update issues to Done

批量更新任务为完成状态

npx tsx scripts/linear-ops.ts status Done ENG-101 ENG-102 ENG-103
npx tsx scripts/linear-ops.ts status Done ENG-101 ENG-102 ENG-103

Update project status

更新项目状态

npx tsx scripts/linear-ops.ts project-status "My Project" completed

---
npx tsx scripts/linear-ops.ts project-status "My Project" completed

---

Reference

参考

DocumentPurpose
api.mdGraphQL API reference, timeout handling
sdk.mdSDK automation patterns
sync.mdBulk sync patterns
projects.mdProject & initiative management
troubleshooting.mdCommon issues, MCP debugging
docs/labels.mdLabel taxonomy
External: Linear MCP Documentation
文档用途
api.mdGraphQL API参考、超时处理
sdk.mdSDK自动化模式
sync.md批量同步模式
projects.md项目与举措管理
troubleshooting.md常见问题、MCP调试
docs/labels.md标签分类法
外部资源： Linear MCP文档