comment（linear:评论-添加评论到Linear问题Skill）Skill 是什么？如何下载安装使用？

linear:评论-添加评论到Linear问题Skill：一条 `/comment` 命令，把评论直接写进 Linear 问题

核心能力单一而明确：该技能只做一件事——向指定的 Linear 问题添加评论，命令形式为 /comment ENG-123 [可选: 评论文本]。
交互成本极低：不需要打开浏览器、不需要在 Linear 界面里层层点开问题详情，只要在对话中给出问题标识（如 ENG-123）和评论内容即可。
支持多行与 Markdown：如果不提供评论文本，技能会提示你输入，并支持多行；评论可包含粗体、斜体、行内代码、代码块、列表和链接。
结果可见可回溯：发布成功后按固定格式回显评论内容与问题链接，方便你一键跳转核对。
适合高频协作团队：开发、测试、产品在推进问题时，可以把「写评论」这一步从切换到 Linear 的操作中彻底解放出来。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

技能中文名：linear:评论-添加评论到Linear问题Skill 技能英文名：comment 技能ID：14038

它解决的问题非常具体：在日常研发协作中，Linear 问题的评论区是信息沉淀的主战场，但「打开 Linear → 找到问题 → 滚动到评论区 → 输入 → 提交」这条链路，每次都要打断当前工作流。尤其是你正在写代码、跑测试、看日志的时候，为了留一句「已修复，等待验证」，不得不切换窗口。这个技能把这段操作压缩成一条 /comment 指令，让评论动作发生在你原本就在的地方。

一键安装的思路与步骤

该技能的详情内容给出了命令用法与实现方式，但并未提供具体的下载地址、安装命令或授权配置细节，因此下面按通用流程说明，具体入口、命令与授权方式请以官方说明为准。

确认安装前提
- 你的 AI 技能运行环境支持「技能（Skill）」机制，能够加载并调用外部技能。
- 你的工作区已经完成 Linear 的连接与授权，即环境中存在可用的 linear_add_comment 调用能力。该技能本身正是通过 linear_add_comment 来添加评论的。
- 你拥有目标 Linear 问题的评论权限，并且知道问题的标识符（如 ENG-123）。
获取并启用技能
- 在技能市场、技能库或团队内部技能清单中检索技能 ID 14038 或技能英文名 comment，按官方指引完成添加。
- 若团队采用配置文件方式集成，则按官方说明将技能的 name、description（添加评论到 Linear 问题）等信息登记到技能清单中。
- 具体命令、链接与配置项以官方说明为准，本文不做虚构。
验证是否生效
- 在任意会话中输入 /comment，观察是否返回用法提示；按概要说明，正确调用形式为 /comment ENG-123 [可选: 评论文本]。
- 建议先用一个测试问题（或自己的低风险问题）发一条简单评论，例如 /comment ENG-123 测试评论，请忽略。
- 若返回「💬 添加评论到 ENG-123 / 评论: … / 发布成功！/ 查看问题: {问题URL}」这类回显，说明技能已生效；若提示无权限或找不到问题，应优先检查 Linear 授权与问题标识是否正确。

该技能的主要功能和特点

按问题标识精准定位：以 ENG-123 这类问题编号作为入口参数，直接命中目标问题，无需搜索、无需复制粘贴问题链接。
评论文本可选、支持多行：/comment ENG-123 [可选: 评论文本] 意味着你可以先给编号、后补内容；未提供文本时技能会主动提示输入，长评论可以分多行写完再提交。
原生 Markdown 支持：评论内容可使用粗体 **文本**、斜体 *文本*、行内代码 `代码`、代码块（三反引号加语言标记）、列表与链接，写技术说明时排版不塌。
长评论格式引导：当用户正在撰写较长的评论时，技能会提供格式提示，降低因 Markdown 写法不熟而导致的排版返工。
结果回显标准化：发布后统一展示「评论内容 + 发布成功 + 问题链接」，形成可核对的闭环，而不是「提交完不知道成没成」。
和普通工具比强在哪：与「打开 Linear 客户端手动评论」相比，它省掉了窗口切换与页面导航；与「自己写脚本调 API」相比，它把鉴权、参数组装、结果展示都封装成一句自然语言指令，非工程角色也能用。

如何使用该技能？

以下按典型调用流程说明，所有用法均来自技能详情，未描述的能力不做延伸。

第 1 步：准备好问题标识

在 Linear 问题详情页复制问题编号，例如 ENG-123。注意是「团队前缀 + 编号」的完整标识，只写数字通常无法定位。

第 2 步：选择调用方式

方式一（推荐，内容已知）：/comment ENG-123 已复现该问题，环境为 staging，日志见附件链接
方式二（先定位再补内容）：只输入 /comment ENG-123，技能会提示你输入评论文本，此时可多行撰写。

第 3 步：撰写评论内容（可选 Markdown）

输入示例：

/comment ENG-123 修复已合并到 develop 分支。
**改动点**：`OrderService` 增加了空值判断。
- 已补充单测 3 条
- 待 QA 在预发环境回归
参考文档：https://example.com/doc

第 4 步：读取返回结果

技能会按固定格式回显：

💬 添加评论到 ENG-123

评论:
{评论文本}

发布成功！

查看问题: {问题URL}

第 5 步：核对与跳转

点击回显中的问题 URL，确认评论已出现在 Linear 评论区，内容排版、代码块、列表是否正常渲染。

使用小提示：评论内容里如果包含 Markdown 特殊符号（如星号、反引号），记得成对书写；代码片段建议用代码块包裹并标注语言，可读性最好。

同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
linear:评论-添加评论到Linear问题Skill（本技能）	对话内的 Linear 评论快捷入口	通过 `/comment 问题标识 [文本]` 添加评论，支持多行与 Markdown	需已接入 Linear 授权；命令极简，几乎零学习成本	开发、测试、产品在编码或调试过程中随手同步进度	优势：一句话完成评论、不打断工作流、结果带问题链接；不足：能力单一，仅支持「添加评论」，不含改状态、改负责人等操作
Linear 官方客户端 / 网页版	全功能问题管理界面	评论、状态流转、指派、筛选、看板等	需登录账号，界面操作路径较长	需要浏览、批量处理、跨问题检索的场景	优势：功能完整、可视化强；不足：每次评论都要切换窗口与页面导航，高频小操作成本高
自建 Linear API 脚本	面向工程团队的定制自动化	调用 Linear 接口添加评论	需处理令牌、接口参数、错误重试与维护成本	需要批量写入评论或与其他系统深度集成	优势：可批量、可编排；不足：开发与维护成本高，非技术角色无法直接使用
通用对话式助手（无 Linear 集成）	通用问答与文本生成	生成评论文本草稿	无需授权	需要先「想清楚怎么写评论」	优势：擅长起草文案；不足：无法把评论真正写入 Linear，仍需人工复制粘贴

说明：以上对比中，竞品的具体功能与接入方式以其官方说明为准；本技能的能力边界以技能详情为准。

该技能的典型应用场景与实际体验情况

场景一：开发完成修复后同步进度 后端工程师小张刚把 bug 修复推上 develop 分支，原本要切到 Linear 更新评论。现在他在编码会话里直接 /comment ENG-123 修复已合并，等待 QA 回归，评论即刻落到问题上，附带问题链接便于同事查看。

场景二：QA 补充复现步骤 测试同学需要把一段复现步骤贴到问题上，内容包含环境、步骤列表和一段报错日志。她使用 /comment ENG-245 触发提示后分多行输入，并用列表与代码块排版，一次提交完成，避免在网页文本框里反复调整格式。

场景三：产品经理做需求备注 产品经理在评审后需要给需求问题补一条决策记录，包含粗体结论与参考链接。通过该技能直接发布，Markdown 渲染正常，评论区可读性优于纯文本。

实际体验情况：整体上手难度很低，唯一需要记的是「问题标识 + 可选文本」这个参数顺序；不写文本时会进入提示输入模式，适合边想边写。效果上，最大的体验提升是「不离开当前工作上下文」，评论动作从十几秒压缩到几秒。注意事项有三点：一是必须先完成 Linear 授权，否则 linear_add_comment 无法执行；二是问题标识要写全，ENG-123 不能简写成 123；三是提交前尽量自查 Markdown 符号是否成对，避免排版异常。

该技能能为用户带来的价值

效率提升：把「切窗口 → 找问题 → 定位评论区 → 输入 → 提交」的多步操作压缩为一条命令，高频协作场景下每次可节省十几秒到数十秒，一天多次评论累积可观。
降低协作门槛：非工程角色无需了解 Linear API，也能用自然语言式指令完成评论写入，团队内的信息同步不再依赖「谁记得去更新」。
减少信息丢失：进度、结论、复现步骤当场记录到问题上，避免「想到了但懒得切窗口，最后忘了写」造成的上下文断档。
内容质量更高：Markdown 与多行输入让技术评论可以带代码块、列表与链接，长评论还有格式提示，评论区从「一句话留言」升级为可复用的知识记录。
长期价值：问题评论区沉淀得越完整，后续复盘、交接、排查历史决策的成本越低，Linear 作为团队唯一事实来源的价值也越高。

常见问题 FAQ

Q1：这个技能怎么安装？需要额外付费吗？ A：按官方说明在技能库/技能市场中检索技能 ID 14038 或英文名 comment 并添加，同时确保工作区已接入 Linear 授权，随后用 /comment ENG-123 测试 验证。费用与授权方式取决于你所在平台的规则，以官方说明为准。

Q2：调用时提示无法添加评论，常见原因有哪些？ A：优先排查三点——Linear 是否已完成授权、问题标识是否完整（如 ENG-123）、当前账号是否具备该问题的评论权限。若均正常仍失败，请参考官方文档排查调用环境。

Q3：评论内容可以带代码和列表吗？ A：可以。技能明确支持 Markdown：粗体、斜体、行内代码、代码块、列表与链接均可使用；撰写较长评论时，技能还会提供格式提示，帮助你排版。

Q4：它能不能顺便修改问题状态或指派负责人？ A：不能。该技能的定位是「添加评论到 Linear 问题」，实现上通过 linear_add_comment 完成评论写入，不包含状态流转、指派等其他操作。需要这些能力请使用 Linear 客户端或其他对应技能。

Q5：和直接打开 Linear 网页评论相比，怎么选？ A：如果你正在编码、调试、开会记录，追求「原地把话写进去」，用本技能更快；如果你需要浏览多个问题、批量整理、查看附件与状态，则用 Linear 客户端更合适。两者不冲突，建议按场景切换。

linear:评论-添加评论到Linear问题Skill：一条 /comment 命令，把评论直接写进 Linear 问题