关于 linear-setup
指导如何依据项目目标、仓库历史和路线图建立 Linear 跟踪的技能。它要求写入前先检查现有内容，并将跟踪规则加入 Agent 指令。
主要功能
- 01先验证 Linear MCP 访问权限
- 02变更前检查现有跟踪内容
- 03规划里程碑与工单结构
- 04依据仓库证据回填工作
- 05将跟踪规则写入 Agent 指令
适用场景
- 01根据仓库创建 Linear 项目
- 02谨慎扩展现有跟踪内容
- 03依据变更日志和 git 历史记录已完成工作
MCP 相关
写入前先探测 Linear MCP；若访问失败则停止。该技能通过 Linear 建立并维护项目跟踪。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/linear-setup确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
ALWAYS_ON.mdAUTH.mdAUTOMATION.mdEXAMPLES.mdMETHODOLOGY.mdRESPONSE.md详细介绍
Linear 设置
聊天规则：RESPONSE.md。身份验证：AUTH.md。完整方法：METHODOLOGY.md。
步骤 0 — 身份验证
探测 Linear MCP。失败时 → 按照 AUTH.md 中适用于此 Agent 的步骤操作；停止。切勿编造 API 调用。
操作顺序
按顺序执行。设置早期关卡，是因为出错会破坏正在运行的工作流。
1. 已有跟踪记录？（§1a）
按仓库名称在 Linear 中搜索，并且询问用户。切勿假设一切从零开始。
- 没有 → 全新初始化；继续。
- 有 → 停止。列出 issues／里程碑／标签／文档／状态更新 → 总结 → 在进行任何写入之前，按类别逐一确认是／否。谨慎扩展。扫描仓库，查找尚未镜像的路线图文档（§4.7）。
2. 北极星（§1b）
通常 README 中的愿景就足够了——明确说出你的判断。问题 5（为什么要跟踪？）决定采用哪种形式——参见 METHODOLOGY 中的目标→形式表。
3–4. 类型 + 结构（§2–§3）
建议的类型：产品 / 工具 / 发布 / 营销。里程碑应与实际阶段一一对应。将工程、发布、推广分为不同轨道。只有在有真实信号时才设置日期。结构不明确时，优先参考 §17。
5. 回填（§4）
CHANGELOG > 路线图 > git 日志。默认按功能级别回填；已发布的包按版本回填。只有有证据时才标记为已完成。文档写着“已完成”≠证明——需交叉验证（§4.8）。
编写（工单）
标题不超过 8 个词。描述不超过 3 句话或 5 个要点。评论不超过 3 行。优先使用截图，而非文字说明（§10）。
6. 建立关联（§4、§10、§11）
使用真实的 blockedBy／blocks。尽早呈现仅涉及 UI 的事项（§11）。将 README 添加为 Linear 项目文档。
7. 安装规范（§5）
将跟踪协议写入始终加载的 Agent 指令（CLAUDE.md / AGENTS.md / .cursor/rules/），并填写真实的团队／项目／里程碑名称。未完成此步骤，初始化就不算完成。
8. 如实记录（§6、§9）
仅在里程碑或健康状况关键节点发布状态更新。日期即将延误前，将状态设为 atRisk。
9. 完成检查（§18、§26）
评分量表达到 16/20 以上且没有关键项得 0 分，或完成完整的 §26 审计。
设置完成后
如果尚未设置，请引导用户配置始终启用的跟踪：finish linear-tracking install。可选：配置 Cursor 每周健康检查：AUTOMATION.md。只提供一个后续操作。