用途:为在已启用 Linear 跟踪的仓库中进行非平凡开发工作时,提供始终在线的会话纪律;对尚未跟踪的仓库,仅做一次性软提示。
主要能力与规则: 检测跟踪:若 CLAUDE.md、AGENTS.md 或 .cursor/rules/* 中存在指明团队与项目的“Linear tracking”(或等价)章节,则视为已跟踪;若仓库根目录存在 .linear-tracking-skip,则跳过。
已跟踪时的协议:先搜索再创建议题;非平凡工作需在指定项目与里程碑中创建或更新议题;状态从 Backlog 到开始时改为 In Progress,只有实际交付后才改为 Done;会话结束前闭环,更新状态或评论;优先使用 Linear 生成的 branch 名称;任何 Linear 工具调用前先执行 Step 0 认证。
未跟踪且未跳过时的软提示:只问一次,单行且无开场白:“This repo isn’t tracked in Linear. Set it up now? (~10–20 min)”。回答 Yes 则交由 linear-setup 处理,不内联引导;回答 No 则在仓库根目录创建 .linear-tracking-skip,下次保持安静。绝不因提示而自动创建 Linear 项目或议题;绝不在 Automation 或 linear-monitor 运行中发出提示。
已跳过时:不提及设置,但用户在明确请求时仍可使用 Linear MCP。超出范围:完整引导交由 linear-setup,救援与审计交由 linear-sync,健康摘要交由 linear-monitor。