用途:按方法论在 Linear 中建立或扩展项目追踪,而非直接做 API 增删改查。适合用户要求“设置 Linear 追踪”“把这个项目纳入 Linear”等场景。
必要用法:先读 Chat rules:RESPONSE.md;认证:AUTH.md;完整方法:METHODOLOGY.md。第一步探测 Linear MCP,失败则按 AUTH.md 处理并停止,不得臆造 API 调用。
操作顺序:1)按仓库名搜索 Linear 并询问用户,确认项目是否已被追踪,不可假设空白;不存在则全新初始化,已存在则停止并先枚举 issues、milestones、labels、docs、状态更新,逐类征得用户同意后再写入,保守扩展,并扫描仓库中未镜像的路线图文档。2)确定北极星目标,README 作为愿景通常足够,并明确指出;第 5 问(为何追踪)决定形态,见方法论目标到形态表。3-4)确定类型与结构:建议类型为 Product/Tool/Drop/Marketing,里程碑与真实阶段 1:1,分离工程、发布、推广轨道,仅在有真实信号时才写日期,形态不清优先参考第 17 节。5)回填:优先 CHANGELOG,其次路线图,再次 git log;默认功能级,已发布包按发布粒度;只有证据充分才算完成,文档写“完成”不等于证据,需佐证。
写作规范:标题不超过 8 个词;描述不超过 3 句或 5 个项目符号;评论不超过 3 行;优先截图而非长文。6)建立关联:使用真实的 blockedBy/blocks;及早暴露纯 UI 项;把 README 添加为 Linear 项目文档。7)安装纪律:把追踪协议写入始终加载的 Agent 指令(CLAUDE.md、AGENTS.md、.cursor/rules/ 等),使用真实团队、项目、里程碑名称;未完成此步则初始化不算完成。8)诚实性:仅在里程碑或健康度时刻做状态更新,日期滑动前先标 atRisk。9)完成检查:评分不低于 16/20 且无致命 0 分,或执行完整第 26 节审计。
设置后:提示用户通过 finish linear-tracking install 补齐常驻指令;可选 Cursor 每周健康检查见 AUTOMATION.md;给出一个下一步动作。限制:需可用的 Linear MCP 与认证,后续所有写入都需用户逐类确认,不得假设空白状态或编造接口调用。