该技能（Linear）为兼容的智能体环境提供一套在 Linear 中操作的紧凑工作流，用于检查工作、分诊缺陷、创建和更新议题、管理项目与周期、查阅文档，以及留下带有明确后续动作的评论。
用途 用户希望在 Linear 中借助智能体完成操作时使用本技能。
前提条件
- 当前运行时中已有已连接的 Linear 集成。
- 用户可访问相关的 Linear 工作区、团队、项目和议题。
- 如果 Linear 工具尚不可用，请阅读 references/setup.md。该文件包含通用设置指引以及 Codex 专用命令。
必需工作流 请按顺序执行以下步骤：
第 1 步：定义范围 在做出更改之前先明确目标。按需确认团队、项目、议题标识符、标签、周期、负责人、优先级、截止日期或文档区域。
第 2 步：检查可用的 Linear 工具 确认当前环境中暴露了哪些 Linear 能力。优先使用原生已连接工具。如果运行时暴露了由 MCP 支持的 Linear 工具，请直接使用。如果没有任何 Linear 工具可用，请停止操作并改用 references/setup.md 中的设置指引，而不是猜测。
第 3 步：写之前先读 先用读操作建立上下文：
- 在更新议题之前先列出或搜索议题。
- 在创建相关对象之前先检查项目、团队、周期、标签、文档或评论。
- 当请求含义不明确时，应从返回数据中确认目标记录，而不是假设。
第 4 步：按逻辑批次应用更改 仅在确认目标对象后再进行更新：
- 将相关的议题更改归为一组。
- 创建议题、标签、评论或项目时包含所有必需字段。
- 对于批量更改，在应用前说明分组或选择规则。
第 5 步：以具体结果收尾 总结读取或更改了什么，指出阻碍或缺失的访问权限，并在有用时提出后续动作。
可用工具 工具名称因宿主而异。请使用映射到以下能力的已连接 Linear 工具：
- 议题管理：列出、搜索、检查、创建、更新、指派、重新加标签和评论议题
- 项目与规划：列出并检查项目、团队、用户、周期、状态和标签
- 文档与协作：搜索文档、检查文档、列出评论和创建评论
如果宿主暴露了明确的工具名称，常见的 Linear MCP 操作包括： list_issues、get_issue、create_issue、update_issue、list_my_issues、list_issue_statuses、list_issue_labels、create_issue_label、list_projects、get_project、create_project、update_project、list_teams、get_team、list_users、list_documents、get_document、search_documentation、list_comments、create_comment 和 list_cycles。
实用工作流
- 冲刺规划：审查团队的未完成议题，按优先级排序工作，并为当前或下一个周期组织任务分配。
- 缺陷分诊：列出紧急缺陷，按影响排序，并将正确的子集移入活跃状态。
- 文档审计：搜索文档、找出缺口，并针对具体修复创建或更新文档议题。
- 团队工作量审查：按负责人对活跃议题分组，标记不均衡，并提出或应用重新分配。
- 发布规划：创建或完善发布项目、里程碑和支持性议题。
- 依赖清理：找出被阻塞的议题，识别阻塞项，并创建或更新缺失的关联工作。
- 状态维护：找出停滞工作、添加状态评论或请求缺失的更新。
- 标签治理：审查未加标签或标签不一致的议题并加以规范化。
- 回顾：总结已结束的周期，识别完成模式、溢出工作和后续工作。
提升效率的建议
- 批量处理相关更改。
- 工作区较大时，优先使用精确筛选而非宽泛列表。
- 一旦发现已确认的议题 ID、项目 ID 和团队键，就复用它们。
- 当存在速率限制或审查风险时，将大型写操作拆分为更小的批次。
故障排查
- 认证失败：重新运行宿主的 Linear 连接流程，验证工作区访问权限，并确认连接的是正确账号。
- 工具缺失：在继续之前使用 references/setup.md 连接 Linear。
- 数据缺失：确认团队、项目或议题确实属于所连接的工作区且未被归档。
- 工具错误：缩小请求范围，提供明确标识符，并将复杂更新拆分为更小的操作。