linear-batch-implement

Linear 批量实施

当操作者想要实施多个已准备就绪的 Linear AI 问题时，使用此技能。

这是一个编排器。请勿重复 linear-implement 工作流。单个问题技能负责持久化每个问题的 Linear 评论、工作流标签、仪表板更新、PR 交接以及问题特定的解读。

来源约定

阅读并遵循：

• skills/linear-implement/SKILL.md
• docs/workflow.md
• docs/implementer.md
• docs/agent-required-passes.md
• docs/superpowers-linear-persistence.md
• scripts/validate_marked_comments.ts

队列发现

使用 Linear MCP：

• 使用 list_issues 查找带有 llm-ready 的问题。
• 可选筛选条件：团队、项目、负责人、标签，以及用户提供的明确问题 ID。
• 如果用户未提供明确问题 ID，且当前会话中尚未明确目标团队和项目，则在发现问题前询问要处理哪个团队和项目的问题。
• 只有带有 llm-* 工作流标签的问题才会进入队列。除非用户明确指定，否则忽略不带 llm-* 标签的问题。
• 使用 get_issue 和 list_comments 确认每个候选问题都有最新的有效就绪计划，且其 plan_status: ready。

排除已带有 in-use 认领标签的问题；其他 Agent 正在处理这些问题。

支持明确的试运行或仅列出模式。在试运行／仅列出模式下，显示队列后停止，不得分派子 Agent，也不得修改 Linear。

首先按 Linear 优先级排序，然后按问题更新时间从早到晚排序。优先级顺序为：紧急、高、中、低，然后是无优先级／未设置；相同优先级内按 updatedAt 升序排列。显示范围明确的队列摘要，包含问题 ID、标题、状态、项目、问题工作树或 Git 引用、就绪计划修订版本、更新时间，以及问题符合条件的原因。

分派前先请求确认。队列发现完成后、分派前，询问一个全局最大并行数。并行数最多为 6。不得选择不受限制或默认的实施并行数。

切换到另一个问题时，先根据 docs/workflow.md 中的 Ticket Reference Rule 提供简短的内容摘要：注明问题 ID、准确的问题标题，并用一句话描述问题内容。

分派规则

分派每个问题前，立即使用 get_issue 和 list_comments 重新读取问题状态。如果该问题不再带有 llm-ready、不再有最新的有效就绪计划，或现在带有 in-use 认领标签（已被其他 Agent 认领），则跳过该问题，并在摘要中记录观察到的 Linear 状态变动。

每个问题都必须隔离处理。每个 linear-implement 子 Agent 必须在隔离的问题工作树中工作，并使用问题的 Git 引用或 PR 作为操作依据，不得与其他正在更改代码的问题共用可变工作树。

分派每个 linear-implement 子 Agent 前，传递或确认与直接运行相同的必要实施者权限上下文：对该问题工作树的工作区写入权限、包管理器和验证命令权限、用于仪表板／状态变更的 Linear MCP 读写工具、在涉及分支或 PR 工作时所需的 Git/GitHub 工具，以及所需的项目 MCP 工具。对于常规的安全工作，不要按提示逐条询问实施者；如果无法提供此权限上下文，则跳过或阻止该问题，并注明权限缺失。

此权限上下文不代表一揽子批准。对于破坏性、不可逆、需要凭据、影响外部生产环境、实质性扩大范围或缺少必要权限的操作，子 Agent 仍须先询问或阻止操作。

为每个问题分派一个子 Agent，并提供：

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

对于受影响的问题，工具／运行时故障只重试一次。如果重试失败，则仅在批次摘要中将该问题标记为 failed。

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

结构化子 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:
      - I4
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:
  - PR, commit, dashboard, status comment, or verification evidence.
error: null

契约违规只会导致受影响的问题失败。

问题与反馈汇总

问题包含 question、recommended_answer、reason 和可选的 blocks。

反馈包含 summary、severity、recommendation 和可选的 follow_up。

每轮结束后，按问题归类未解决的问题和反馈。继续处理受阻或有歧义的工作前，先向用户询问所需信息。将已获答复的问题分派到新的 linear-implement 子 Agent 运行中；不要恢复过时的子 Agent 状态。

在下一份摘要中，未获答复的问题仍标记为受阻或跳过。

摘要格式

返回最终摘要，包含：

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

Linear MCP 契约

有以下 Linear MCP 工具可用时，请使用：

• list_issues
• get_issue
• list_comments

批处理协调器不应执行属于 linear-implement 的逐问题生命周期变更。如果 Linear MCP 写入工具不可用，或子 Agent 发出了写入指令，请在批处理摘要中准确列出 REQUIRED_LINEAR_MUTATIONS。

停止条件

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