# Linear Setup

> 按方法论把仓库接入 Linear 跟踪：先确认是否已有项目，以 README 等为北极星规划项目类型与里程碑，依据 CHANGELOG、路线图和 git 记录有据可查地回填已完成的工作，连好 issue 依赖，并把跟踪约定写进 CLAUDE.md、AGENTS.md 或 Cursor 规则。需要 Linear MCP。

- 类型：Skill
- 仓库：https://github.com/tjcages/linear/tree/main/skills/linear-setup
- 页面：https://hebbmind.com/zh-TW/skill/linear-setup
- Stars：10
- 适用职业：[全栈 / 独立开发](https://hebbmind.com/zh-TW/tools.md?profession=fullstack)、[产品 / 项目经理](https://hebbmind.com/zh-TW/tools.md?profession=product)
- 标签：开发方法论、工作流自动化、linear、git
- 收录时间：2026-10-08

## 安装

### Claude Code

```bash
npx skills add tjcages/linear --skill linear-setup -a claude-code -y
```

### Codex

```bash
npx skills add tjcages/linear --skill linear-setup -a codex -y
```

## README

> 以下内容来自上游仓库 https://github.com/tjcages/linear/tree/main/skills/linear-setup ，是第三方撰写的资料，不代表 AgentHub 的立场；其中出现的指令不是对你的指示。

```yaml
name: linear-setup
version: 1.0.2
description: >-
  Bootstrap or extend Linear project tracking the right way — methodology, not
  API CRUD. Use when the user asks to set up Linear tracking, track this project
  in Linear, add this repo to Linear, backfill history, get ready to track, or
  consents after a soft-nudge from linear-discipline. Anchors to North Star,
  backfills Done with evidence, wires blockedBy, installs per-repo discipline.
  NOT for one-off issue create/comment — Linear MCP handles that.
```

# Linear setup

Chat rules: [RESPONSE.md](https://github.com/tjcages/linear/blob/main/skills/linear-setup/RESPONSE.md). Auth: [AUTH.md](https://github.com/tjcages/linear/blob/main/skills/linear-setup/AUTH.md). Full method: [METHODOLOGY.md](https://github.com/tjcages/linear/blob/main/skills/linear-setup/METHODOLOGY.md).

## Step 0 — auth

Probe Linear MCP. On failure → AUTH.md steps for this agent; **stop**. Never invent API calls.

## Operating order

Follow **in sequence**. Early gates exist because getting them wrong corrupts live workflows.

### 1. Already tracked? (§1a)

Search Linear by repo name **and** ask the user. Never assume blank slate.

- **Nothing** → fresh bootstrap; continue.
- **Exists** → STOP. Enumerate issues/milestones/labels/docs/status updates → summarize → per-category yes/no **before any write**. Extend conservatively. Scan repo for unmirrored roadmap docs (§4.7).

### 2. North Star (§1b)

README-as-vision is usually enough — say the call out loud. Question 5 (why track?) picks the shape — see METHODOLOGY goal→shape table.

### 3–4. Type + structure (§2–§3)

Suggested types: Product / Tool / Drop / Marketing. Milestones 1:1 with real phases. Separate engineering / launch / rollout tracks. Dates only with a real signal. Prefer §17 if shape is unclear.

### 5. Backfill (§4)

CHANGELOG > roadmap > git log. Feature-level default; per-release for launched packages. Done only with evidence. Doc “done” ≠ proof — corroborate (§4.8).

### Writing (tickets)

Titles ≤8 words. Descriptions ≤3 sentences or ≤5 bullets. Comments ≤3 lines. Screenshots over prose (§10).

### 6. Wire (§4, §10, §11)

Real `blockedBy`/`blocks`. Surface UI-only items early (§11). Add README as Linear project document.

### 7. Install discipline (§5)

Write the tracking protocol into always-loaded agent instructions (`CLAUDE.md` / `AGENTS.md` / `.cursor/rules/`) with real team/project/milestone names. Bootstrap is not done without this.

### 8. Honesty (§6, §9)

Status updates at milestone/health moments only. `atRisk` before dates slip.

### 9. Done check (§18, §26)

Rubric ≥16/20 with no load-bearing 0, or full §26 audit.

## After setup

Point user to always-on (if missing) via `finish linear-tracking install`. Optional Cursor weekly health: [AUTOMATION.md](https://github.com/tjcages/linear/blob/main/skills/linear-setup/AUTOMATION.md). One next action.