linear-review

Linear 审查

将仓库根目录作为工作流来源。阅读并遵循：

• agents/reviewer.md
• docs/reviewer.md
• docs/agent-required-passes.md
• docs/workflow.md
• templates/linear-review-finding-footer.md
• schemas/linear-ai.review-ledger.v1.schema.yaml
• templates/linear-bug-issue.md
• templates/linear-feature-issue.md

范围

不带参数时，审查整个目标仓库。参数指定基准引用、PR 或 HEAD~n 时，仅审查相对于该基准的变更代码。

启动选项

在并行分派前，逐项确认以下选项，并为每项提供建议默认值：严重性阈值（--min，默认无）、分流模式（默认混合模式，也可选批量表格或逐项处理），以及交接模式（默认仅草拟，也可选草拟 + 优化）。

审查并行分派

根据 agents/reviewer.md，将审查任务作为独立的并行子 Agent 分派：五个推理审查方向（正确性、安全性、可维护性、性能、测试）；仅在差异模式且已有就绪计划时启用 Spec 方向；以及两个基于工具的审查方向（冗余代码、依赖健康度）。每位审查者只读、只负责一个审查角度、不共享状态，并按照 agents/reviewer.md 定义的格式返回发现。

去重

根据 docs/reviewer.md 为每项发现生成指纹。若 .linear-ai/review-ledger.yaml 中记录的指纹状态为 ignored 或 ticketed，则丢弃该项发现；若指纹与带有 linear-ai:review-finding 页脚的未关闭 Linear issue 匹配，也予以丢弃。报告去重计数。

分流与工单

按照所选分流模式，依据 docs/reviewer.md 中考虑置信度的默认规则，按严重性分组呈现未被去重的发现。如果当前会话尚未明确新工单的目标团队和项目，则在创建工单前询问要在哪个团队和项目中创建。按照 linear-create-issue 约定，为每项选中的发现创建一个 Linear issue：对错误、安全性和静默失败类发现应用 bug，其他情况使用功能模板；添加 llm-refine；附加 linear-ai:review-finding 页脚；并将指纹以 ticketed 状态及 issue ID 记录到账本中。仅对用户明确忽略的发现写入 ignored 账本条目。延后处理的发现不写入账本。

Claim 锁定

linear-review 是仓库范围的操作，不占用 in-use claim。其创建的工单之后遵循常规 Claim 锁定规则。

Linear MCP 约定

使用 list_issues / search_documentation 查找带有 linear-ai:review-finding 页脚的未关闭 issue，以便去重；使用 save_issue 创建发现 issue 并附加页脚；进入后续优化流程时使用 list_comments。如果 Linear MCP 写入工具不可用，不得声称已创建 issue；应输出 REQUIRED_LINEAR_MUTATIONS，其中包含准确的 issue 正文、标签和页脚，并仍然写入本地账本。

步骤完成后的交接

仅草拟的交接模式下，创建工单后即停止，并建议使用 linear-refine 或 linear-batch-refine。草拟 + 优化模式下，对已创建的工单接续运行 linear-refine（或 linear-batch-refine），并将每项发现的证据和建议修复方案作为优化上下文传递。

审查步骤完成后，报告变更内容、去重计数、创建的工单、账本写入情况、当前 Linear 标签/状态，以及建议的下一步。询问用户对此审查步骤是否还有补充。如果没有，指出建议的下一个技能并等待确认；不要自动运行该技能。