mcpField
L
linear-issues

linear-issues

github.com/lwlee2608生产力1126 次安装1 天前更新
代码仓库

关于 linear-issues

通过已连接的 Linear MCP 服务处理 Linear 工作的 Skill,规定 ID 解析、未请求写入的确认要求及变更核验方式。

主要功能

  1. 01使用 Linear MCP 工具
  2. 02将名称解析为 UUID
  3. 03未请求的写入须先确认
  4. 04变更后重新读取对象

适用场景

  1. 01创建或更新 Linear issue
  2. 02添加简短的 issue 评论
  3. 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 服务完成。

规则

  1. 使用 Linear MCP 工具(mcp__linear__*:list_issues、get_issue、create_issue、update_issue、list_comments、create_comment 等)。调用前先读取实际架构,因为 Linear 会在不通知的情况下重命名工具。

  2. 绝不退而求其次使用 GraphQL API 或网页界面。 如果未连接 Linear MCP 服务,请停止操作,并告知用户将 https://mcp.linear.app/mcp(HTTP 传输)添加到其 Agent。在 Claude Code 中:

    claude mcp add --transport http linear https://mcp.linear.app/mcp
    
  3. 写入前先将名称解析为 ID。 团队、状态、标签和受指派人字段都需要 UUID;显示名称会导致失败或静默无操作。先调用对应的 list_* 工具。

  4. 评论应简短。 1–3 句话。先说结果,用 PR 链接代替粘贴差异内容,不要写开场白、不要重述工单内容、不要写结束语、不要用表情符号。

    Root cause: config loader reads `retry_count` but the YAML key is `retryCount`, so it binds 0. Fixed in #482.
    
  5. 不要手动将已关联 PR 的问题移至 Done。 合并后,已关联的 PR(分支名称,或标题/正文中的 Fixes ENG-482)会将问题移至 Done。仅当没有关联 PR 或用户提出要求时,才手动设置。

  6. 未经用户要求的写入操作,必须先确认。 问题、状态变更和评论对整个团队可见。如果用户要求执行写入操作,则直接执行。

验证

  1. 写入后重新读取对象;报告标识符和 URL(ENG-482 — https://linear.app/…)。
  2. 如果评论超过约 3 句话,请精简。

评论

支持 Markdown