关于 linear-issues
通过已连接的 Linear MCP 服务处理 Linear 工作的 Skill,规定 ID 解析、未请求写入的确认要求及变更核验方式。
主要功能
- 01使用 Linear MCP 工具
- 02将名称解析为 UUID
- 03未请求的写入须先确认
- 04变更后重新读取对象
适用场景
- 01创建或更新 Linear issue
- 02添加简短的 issue 评论
- 03核验变更并报告其 URL
MCP 相关
所有 Linear 操作都必须使用 Linear MCP 服务,不得改用 GraphQL API 或网页界面。若未连接服务,则提供服务 URL 和连接配置方式。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ lwlee2608/ agent-skills --skill linear-issues安装后在 Claude Code 中输入/linear-issues确认已加载。
详细介绍
使用 Linear
所有 Linear 操作都通过已安装的 Linear MCP 服务完成。
规则
-
使用 Linear MCP 工具(
mcp__linear__*:list_issues、get_issue、create_issue、update_issue、list_comments、create_comment等)。调用前先读取实际架构,因为 Linear 会在不通知的情况下重命名工具。 -
绝不退而求其次使用 GraphQL API 或网页界面。 如果未连接 Linear MCP 服务,请停止操作,并告知用户将
https://mcp.linear.app/mcp(HTTP 传输)添加到其 Agent。在 Claude Code 中:claude mcp add --transport http linear https://mcp.linear.app/mcp -
写入前先将名称解析为 ID。 团队、状态、标签和受指派人字段都需要 UUID;显示名称会导致失败或静默无操作。先调用对应的
list_*工具。 -
评论应简短。 1–3 句话。先说结果,用 PR 链接代替粘贴差异内容,不要写开场白、不要重述工单内容、不要写结束语、不要用表情符号。
Root cause: config loader reads `retry_count` but the YAML key is `retryCount`, so it binds 0. Fixed in #482. -
不要手动将已关联 PR 的问题移至 Done。 合并后,已关联的 PR(分支名称,或标题/正文中的
Fixes ENG-482)会将问题移至 Done。仅当没有关联 PR 或用户提出要求时,才手动设置。 -
未经用户要求的写入操作,必须先确认。 问题、状态变更和评论对整个团队可见。如果用户要求执行写入操作,则直接执行。
验证
- 写入后重新读取对象;报告标识符和 URL(
ENG-482 — https://linear.app/…)。 - 如果评论超过约 3 句话,请精简。