linear-batch-close

Linear 批量关闭

当操作员想要关闭多个已准备好在合并后完成收尾的 Linear AI issue 时，使用此技能。

这是一个编排器。不要重复实现 linear-close 工作流。单个 issue 技能负责持久化的逐 issue Linear 评论、工作流标签、收尾变更、合并证据、CI 证据和 issue 专属解读。

来源约定

阅读并遵循：

• skills/linear-close/SKILL.md
• docs/workflow.md
• docs/agent-required-passes.md
• docs/comment-validation.md
• scripts/validate_marked_comments.ts
• scripts/verify_closeout.ts

队列发现

使用 Linear MCP：

• 使用 list_issues 查找带有 llm-review 的 issue。
• 可选筛选条件：团队、项目、受派人、标签，以及用户提供的明确 issue ID。
• 如果用户没有提供明确的 issue ID，且当前会话中尚不清楚目标团队和项目，则在发现 issue 前询问要处理哪个团队和项目。
• 只有带有 llm-* 工作流标签的 issue 才会进入队列。除非用户明确指定，否则忽略没有 llm-* 标签的 issue。
• 使用 get_issue 和 list_comments，在分派前总结当前评审/PR 证据。

排除已带有 in-use 占用标签的 issue；这表示另一个 Agent 正在处理它们。

支持明确指定的 dry-run 或仅列出模式。在 dry-run/仅列出模式下，展示队列并停止，不要分派子 Agent，也不要修改 Linear。

队列先按 Linear 优先级排序，再按 issue 更新时间从早到晚排序。优先级顺序为 Urgent、High、Medium、Low，然后是 No priority/none；同一优先级内按 updatedAt 升序排序。展示范围限定的队列摘要，包括 issue ID、标题、状态、项目、最新的评审就绪证据、更新时间以及 issue 符合条件的原因。

分派前先征求确认。发现队列后、分派前，询问用户希望采用的并行度上限。并行度最多为 6。

切换到不同 issue 时，先依照 docs/workflow.md 中的 Ticket Reference Rule 提供简短内容摘要：写明 issue ID、准确的 issue 标题，以及一行内容描述。

分派规则

分派每个 issue 前，立即重新使用 get_issue 和 list_comments 读取 issue 状态。如果 issue 已不再带有 llm-review，或现在带有 in-use 占用标签（已被另一个 Agent 占用），则跳过该 issue，并在摘要中记录观察到的 Linear 状态变化。

为每个 issue 分派一个逐 issue 子 Agent，并要求其执行：

$linear-ai:linear-close <ISSUE-ID>

对受影响 issue 的工具/运行时故障重试一次。如果重试仍失败，只在批次摘要中将该 issue 标记为 failed。

处理取消时，停止新的分派，等待已启动的安全任务报告结果，并返回取消摘要，其中列出已完成、受阻、失败、跳过、已取消和未开始的 issue。

结构化子 Agent 结果

要求每个子 Agent 返回结构化子 Agent 结果：

issue: HCL-123
status: completed # completed | blocked | failed | skipped | cancelled
questions:
  - question: Concrete question for the user.
    recommended_answer: Recommended answer with rationale.
    reason: Why this answer is needed.
    blocks:
      - closeout
feedback:
  - summary: Short feedback from the subagent.
    severity: info # info | warning | blocker
    recommendation: Recommended follow-up.
    follow_up: Optional next step.
linear_mutations:
  - REQUIRED_LINEAR_MUTATIONS emitted by the single-issue skill, if any.
evidence:
  - Merge, CI, mainline, dashboard, status, or Linear state evidence.
error: null

违反约定只会导致受影响的 issue 失败。

问题与反馈汇总

问题包含 question、recommended_answer、reason，以及可选的 blocks。

反馈包含 summary、severity、recommendation，以及可选的 follow_up。

每轮处理后，按 issue 对未解决的问题和反馈分组。在继续处理受阻或有歧义的工作前，向用户询问所需信息。将已得到回答的 issue 交给全新的 linear-close 子 Agent 运行；不要恢复过期的子 Agent 状态。

未得到回答的 issue 在下一次摘要中仍标记为受阻或跳过。

摘要格式

返回最终摘要，包含：

• 发现的 issue
• 已分派的 issue
• 已完成的 issue
• 受阻/待答问题
• 失败的 issue
• 跳过的 issue
• 已取消或未开始的 issue
• 已应用的用户回答
• 规范化后的证据
• 观察到的 Linear 状态变化
• 子 Agent 提供的 REQUIRED_LINEAR_MUTATIONS
• 建议的下一步操作

Linear MCP 约定

如果有可用的 Linear MCP 工具，请使用以下工具：

• list_issues
• get_issue
• list_comments

批处理编排器不应执行属于 linear-close 的收尾变更。如果 Linear MCP 写入工具不可用，或子 Agent 发出了写入指令，请在批次摘要中原样呈现 REQUIRED_LINEAR_MUTATIONS。

停止条件

在所有已确认的波次均已完成、需要用户输入、收到取消请求或没有符合条件的问题时停止。