SuperAPI AI 工具集

linear

办公与效率

查看项目

更新于 10-21 12:52

技能介绍

Linear Operations 是一个用于 Linear 事项工作流的技能,通过 Linear 托管的 MCP 服务器来管理 Linear 事项。

用途 该技能面向 Linear 事项的日常操作,包括只读检查、创建事项、添加评论、更新字段、指派负责人以及状态流转。当用户要求创建 Linear 工单、更新 Linear 事项、添加 Linear 评论或移动工作时,可使用此技能。

主要能力 技能按需加载参考文档:任何 Linear 操作读取 references/api-surface.md;创建、更新、评论、指派或状态变更读取 references/common-use-cases.md、references/issue-writing.md、references/issue-examples.md;遇到认证问题、歧义或工具失败时读取 references/troubleshooting-workarounds.md。

工作流 首先解析操作与目标:判断请求属于只读检查、事项创建、评论、字段更新、指派还是状态流转;优先使用用户明确给出的事项标识、事项 URL、项目名、团队名或负责人。当用户未指定目标时,可将 linear.team 与 linear.project 会话配置视为可选默认值,显式用户输入始终优先于配置。只有在用户明确要求为当前会话或频道存储默认值时才设置或更改 linear.team 与 linear.project。创建事项前必须先确定目标团队,因为每个 Linear 事项只属于一个团队。若配置了 linear.project,仅当请求未指定其他项目且该项目契合当前任务时,才将其用作默认项目。若请求间接指向已有 Linear 条目,应先检查当前线程上下文中此前提到的事项 key 或 URL,再要求用户重述。仅当写入在综合考虑显式输入与配置默认值后仍被阻塞时(例如存在多个可能团队、没有明确目标事项、新事项没有有效团队),才提出一个简洁的追问。

准备操作时,在需要确认现有事项、团队、项目或工作流状态时,优先先做一次简短的读取/搜索再执行变更。草拟事项内容(创建或大幅重写)时,将工作分类为 bug、feature 或 task,并按 references/issue-writing.md 塑造标题与正文,通过 references/issue-examples.md 校准深度。

硬性约束适用于每个新事项:标题不超过 60 个字符,bug 用描述性标题,任务/功能用祈使式标题;摘要不超过 3 句,不在正文中重复标题;简单事项优先使用扁平列表而非带标题的分节;泛化会话框架,去除频道引用、斜杠命令、Slack 线程 ID、用户 @提及和转录片段,替换为底层工程问题;压缩源材料,调研笔记、假设或转录内容应变成简短摘要加限定范围的列表,绝不把原始调查粘贴进正文;除非用户明确要求保留特定提案,否则不添加期望结果、预期行为、验收标准、修复方案、实现步骤、方法或选项;绝不从调研中推断解决方案,若必须保留用户提供的提案,应将其标注为提案并与已验证的诊断分开。当请求源自 Slack 线程或任何代表他人执行的上下文时,在末尾追加一行 Action taken on behalf of <name>.,使用执行操作者的真实姓名;执行操作者是当前 <actor> 或明确要求你创建/更新事项的人,不一定是原始报告者。当线程中报告者清晰时按姓名标注,例如 "Raised by Alice during incident triage";若报告者与执行操作者不同,用持久正文文本保持区分,例如 Reported by Alice.,不要引用 Slack 频道、线程或会话内部信息。线程中存在的截图应作为图片链接附上。相关 URL(Sentry、GitHub、文档、复现链接)应内联保留,不要堆成链接列表。

设置可选 Linear 字段时按字面处理:使用团队实际的工作流状态,而非 Todo 或 In Progress 这类通用名称;仅使用 Linear 标准优先级 low、medium、high、urgent;仅当用户要求或线程中已明确时才设置 project、labels、cycle、estimate 或 assignee。

变更前校验草稿:标题长度不超过 60 个字符;适用时委托操作脚注为最后一行,使用执行操作者的真实姓名,除非与报告者同一人;不残留会话框架(频道引用、斜杠命令、@提及、Slack 线程 ID);正文结构匹配复杂度,无空分节、不重复标题、无原始调研倾倒;标题或正文中不出现编造或无归属的解决方案、实现步骤、方法或选项。若任一校验未通过,先修订并重新检查,再调用 Linear 创建/更新工具。

执行时使用 Linear 实时托管的 MCP 工具创建或更新事项,发现当前的创建/更新工具,并仅复制其实时 schema 所支持的字段。更新时优先做局部修改而非整体重写;若变更可能覆盖结构化字段或重复已有评论,先获取当前事项状态。当请求看似与现有工作相关时,创建新事项前静默检查重复。

报告结果时返回规范的 Linear 事项 URL 或 key 以及变更内容;创建新事项且事项类型对结果有实质澄清作用时报告事项类型。

适用场景 适用于通过 Linear 管理事项的各类工作流,包括创建工单、更新事项、添加评论、指派负责人、状态流转,以及从 Slack 线程等上下文代表他人创建或更新事项。

限制与护栏 当明显是同一工作时,应复用或更新已有 Linear 事项而非创建重复项。线程未解决的细节应在 Linear 内容中标注为假设。优先使用简洁、持久的工单文本,而非逐字 Slack 引用或长转录倾倒。工单交接以诊断为先,根因证据可确立问题所在,但不构成编造应构建或更改内容的理由。在未先确认存在的情况下,不得编造团队特定的工作流名称、标签或估算值。