SuperAPI AI 工具集

linear-review

智能体与模型

查看项目

更新于 10-16 00:01

技能介绍

用途:对目标仓库或指定 diff 做多维度代码审查,并衔接 Linear 工单管理。无参数时审查整个仓库;传入 base ref、PR 或 HEAD~n 时只审查相对该基线的改动代码。

主要能力:按 agents/reviewer.md 并行派发审查通道,包括五个推理通道(correctness、security、maintainability、performance、tests),仅在 diff 模式且已有 plan 时启用 Spec 通道,以及两个工具支撑通道(dead-weight、dependency-health)。每个审查者只读、只负责一个视角、互不共享状态,并按约定结构返回发现。

使用方式:以仓库根目录作为工作流来源,读取并遵循 agents/reviewer.md、docs/reviewer.md、docs/agent-required-passes.md、docs/workflow.md 以及 templates、schemas 下的相关文件。展开前需确认三项默认值:严重度阈值(--min,默认无)、分诊模式(默认 Hybrid,另有 Bulk table、One at a time)、交接模式(默认 Draft only,或 Draft + refine)。

去重与工单:按 docs/reviewer.md 对每条发现做指纹,丢弃在 .linear-ai/review-ledger.yaml 中标记为 ignored 或 ticketed 的记录,以及指纹匹配到带 linear-ai:review-finding footer 的开启 Linear 工单的记录,并报告去重计数。按选定模式呈现剩余发现,按严重度分组。创建工单前若团队和项目不明确需先询问;通过 linear-create-issue 约定创建:bug、安全、静默失败类用 bug 模板,其余用 feature 模板,添加 llm-refine 标签,追加 linear-ai:review-finding footer,并把指纹以 ticketed 状态和工单 ID 写入 ledger。只有用户明确忽略才写 ignored 记录,延后的发现不写入。

Linear MCP 契约:用 list_issues / search_documentation 查找带 footer 的开启工单以去重,用 save_issue 创建工单并追加 footer,链入 refinement 时用 list_comments。若 Linear MCP 写工具不可用,不得声称已创建工单,应输出 REQUIRED_LINEAR_MUTATIONS 及确切的工单正文、标签和 footer,同时照常写本地 ledger。

限制:linear-review 是仓库级操作,不占用 in-use claim;它创建的工单之后遵循常规 Claim Lock 规则。Draft only 交接在创建工单后停止并推荐 linear-refine 或 linear-batch-refine;Draft + refine 则链入 refinement,并携带每条发现的证据与建议修复。完成后报告变更、去重计数、创建的工单、ledger 写入、当前 Linear 标签/状态和推荐下一步;询问是否还需补充,若无则给出下一个推荐技能并等待确认,不自动运行。