Linear 研发助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_af163eaa/z-linear-yan-fa-zhu-shou。
技能介绍
解决的问题
Linear 本身的 API 能力不缺,缺的是一条稳定、可复制的任务链路。团队日常跟踪研发工作时,反复要做的事情其实很固定:建几个 Issue 并设好优先级、把本周 Cycle 的进度拉出来汇总、把已完成项批量流转到 Done、查某个项目下还没被阻塞的条目、给 Issue 补上负责人与标签。这些动作如果每次都靠人肉在 UI 里点,或者自己临时拼 GraphQL 请求,很容易出现参数不一致、状态流转遗漏、Key 泄漏之类的问题。
Linear 研发助手 的价值在于把这些动作标准化,让你用一句自然语言描述意图,技能就通过 Linear 官方 API 或 linear-mcp 完成执行,并返回结构化结果。
核心能力与工作方式
技能覆盖三层跟踪范围:Issue、Cycle、项目进度,主要动作包括:
- 建单与设优先级:快速创建一批 Issue,并按 P0/P1 等策略赋值,避免手动逐个新建。
- Cycle 规划与进度汇总:查看本周或指定 Cycle 的完成情况,输出可读的进度摘要。
- 批量状态流转:把符合条件的完成项统一推进到
Done,适合迭代收尾时的批量清理。 - 未阻塞项查询:按项目维度筛出当前未被阻塞的条目,辅助排期决策。
- 关联维护:给 Issue 补负责人与标签,保证责任归属清晰。
执行流程分为五步:接收意图与必要参数 → 校验参数完整性,缺失时询问或用默认偏好补全 → 调用官方 MCP/API(通过 mcporter 或对应客户端工具)→ 解析返回并格式化输出 → 对敏感动作展示预览并二次确认。所有凭证都通过环境变量 LINEAR_API_KEY 注入,不会写死在脚本里。
适用边界与注意点
- 需要有效 Key:Linear 为海外 SaaS,需正常网络出口;Key 在 Settings → Security & access 免费生成,不存在免 Key 路径。
- 写操作有确认门槛:支付、下单、删除、改写等动作会先展示预览再执行,不会绕过确认直接改动远端数据。
- 只覆盖跟踪域:技能聚焦 Issue / Cycle / 项目进度,不做需求拆解、代码生成或 CI 集成。
- 异常分三级处理:参数缺失走询问重试,需确认的动作走预览确认,Key 无效或服务不可达则 fail-open 报错并给出排查指引,不会静默崩溃。
如果你的团队已经在用 Linear,这个助手适合作为日常跟踪的默认入口,而不是替代深度定制的自动化流水线。
使用场景
- 迭代启动时批量创建 Issue 并统一设置 P0/P1 优先级,确保需求快速进入跟踪池。
- 周期结束前自动汇总本周 Cycle 的完成项与未完成项,输出结构化进度摘要。
- 批量将已验收的 Issue 流转到 Done 状态,清理迭代收尾时的遗留条目。
- 查询特定项目下未被阻塞的 Issue,快速识别可用资源以调整任务分配。
适合人员
- 使用 Linear 管理迭代的研发团队负责人,需要快速标准化 Issue 创建与优先级分配。
- 负责多项目进度同步的 PMO,需要周期性汇总各 Cycle 完成情况用于向上汇报。
- 跟进项目排期的技术 Leader,需要实时掌握未阻塞项以调整资源分配策略。