
Linear Setup
Skill按方法论把仓库接入 Linear 跟踪:先确认是否已有项目,以 README 等为北极星规划项目类型与里程碑,依据 CHANGELOG、路线图和 git 记录有据可查地回填已完成的工作,连好 issue 依赖,并把跟踪约定写进 CLAUDE.md、AGENTS.md 或 Cursor 规则。需要 Linear MCP。
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. Auth: AUTH.md. Full method: 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. One next action.
相關資源

Linear Discipline
Skill在已写好 Linear 跟踪约定的仓库里,让 agent 每次会话都遵守:先搜索再建 issue,开工时改为进行中、交付后才标完成,结束前回写状态或评论;对尚未接入的仓库只询问一次是否运行 linear-setup,拒绝后写入跳过标记。需要 Linear MCP。
tjcages/linear10
Linear Methodology
SkillLinear 跟踪技能包的入口:以项目的北极星目标和真实路线图为锚,按请求分派到 linear-setup(接入与回填)、linear-sync(对账与整理)、linear-monitor(健康检查)或 linear-finish-install,并在整个会话中执行 linear-discipline。需要 Linear MCP。
tjcages/linear10
Linear Monitor
Skill对 Linear 项目做健康检查:找出临近截止却进展不足的里程碑与 issue、超过 7 天没有评论的进行中任务、没有里程碑的孤立 issue,并留意常见反模式;默认只读或在已有 issue 下评论,不批量新建、不调整结构。可由 Cursor 自动任务定期运行,需要 Linear MCP。
tjcages/linear10
Linear Sync
Skill对照仓库的实际情况同步、审计或整顿已有的 Linear 项目:列出全部 issue、里程碑、标签与文档,按 20 分制评分并给出差距清单,逐类征得确认后再依次修复孤立 issue、里程碑、依赖与跟踪约定,最后重新评分对比前后。需要 Linear MCP。
tjcages/linear10
Linear Finish Install
Skill完成 Linear 跟踪技能包的安装:把「每次会话以 Linear 为准」的常驻规则写进 Cursor 用户规则,或 ~/.claude/CLAUDE.md、AGENTS.md 等全局指令文件,并调用 Linear MCP 验证授权;在 Cursor 中还可选配每周健康检查的自动任务。
tjcages/linear10
Requesting Code Review
Skill完成任务或合并前,按 git 提交区间派发独立的评审子代理,对照计划与需求检查实现,并按严重、重要、次要分级处理反馈。obra/superpowers 技能集之一。
obra/superpowers301k