Open Code Review 项目解析知识图谱 / 分组目录 / 集成生态 / Claude Code 插件

Claude Code 插件

集成生态高级工具G-E · 集成生态

What · 是什么

claude-code 插件:/open-code-review:review 与 :delegate-review 斜杠命令,marketplace 安装
Alibaba Open Code Review 为 Claude Code 提供的官方集成插件,仓库路径为 plugins/open-code-review/claude-code/,核心清单文件为 .claude-plugin/plugin.json,其中 commands 字段指向 ./commands 目录,即插件以斜杠命令(slash command)形式暴露能力
插件安装后为 Claude Code 注入两条核心斜杠命令:/open-code-review:review(触发代码审查)与 /open-code-review:delegate-review(触发委托审查),命令定义位于插件 commands 目录下
除插件注册的命令外,仓库根目录还内置 .claude/commands/open-code-review.md 作为开箱即用的斜杠命令,同目录另有 commit.md(提交辅助)与 tag.md(打标签辅助)两条配套命令
该插件本质是把 ocr CLI 的能力以 Claude Code 原生命令的方式暴露,让用户在会话中直接输入斜杠命令即可启动审查流程,无需记忆 CLI 参数
属于仓库多 IDE/多 Agent 生态中的 Claude Code 官方入口,与 Codex、Cursor、OpenCode 等集成并列

Why · 为什么

原理 · Principle

Claude Code 是当前主流 AI 编码 Agent 之一,用户习惯以斜杠命令触发工作流,插件化集成可让审查能力零门槛融入既有会话,无需切换到终端手动执行 CLI

斜杠命令封装了 ocr 的复杂参数与调用链,降低使用门槛,同时通过 /open-code-review:delegate-review 提供委托审查路径,适应「宿主模型把关、OCR 干活」的组织分工场景

内置 .claude/commands/open-code-review.md 与 commit.md/tag.md 命令形成「审查—提交—打标签」的完整闭环,覆盖代码合并前的主要操作环节

How · 怎么做

前置条件:确保已安装 ocr CLI(ocr --version 可验证),并完成 API Key 配置,使 ocr 命令可独立运行
从 Claude Code 的插件市场安装:执行 /plugin marketplace add alibaba/open-code-review 将阿里官方仓库添加为插件市场源
随后执行 /plugin install open-code-review@open-code-review 安装插件本体,安装后插件命令即注册到当前会话
重启或刷新 Claude Code 会话后,输入 /open-code-review:review 并附加目标范围参数(如文件、提交或目录)即可发起审查
需要委托审查时,使用 /open-code-review:delegate-review 命令,按提示指定审查范围与委托配置
若不想走插件市场,也可直接依赖仓库根目录内置命令:将仓库中的 .claude/commands/open-code-review.md(以及 commit.md、tag.md)复制到本地项目的 .claude/commands/ 目录,即可获得同等的斜杠命令体验
执行审查后,Claude Code 会在会话内呈现审查结果,可继续以对话方式追问、过滤或修复发现的问题

案例 · Cases

代表性案例
开发者在 Claude Code 会话中完成一个 feature 分支的编码后,直接输入 /open-code-review:review 审查改动文件,在提交前拦截潜在缺陷
团队采用「AI 审查 + 人工确认」流程:开发者在合并前先跑 /open-code-review:review,再针对高严重度问题与 Claude 讨论修复方案,最后用内置 commit.md 生成规范提交信息
安全敏感仓库中,开发者通过 /open-code-review:delegate-review 将审查委托给 OCR 模型执行,Claude 仅负责汇总与裁决,实现职责分离

反模式 · Anti-patterns

正反实例论证 · Evidence

正例 · Pro
完整走插件市场安装流程,两条斜杠命令就位
/plugin marketplace add alibaba/open-code-review/plugin install open-code-review@open-code-review/open-code-review:review --target=src/
先 add 市场源再 install,插件命令才真正注册到会话;随后直接输入 /open-code-review:review 即可发起审查。正确顺序是「先 add 后 install」,缺一不可。
反例 · Con
只 add marketplace 不 install,命令「不存在」
/plugin marketplace add alibaba/open-code-review/open-code-review:review # 报错:未找到该命令
只添加市场源只是让仓库「可见」,命令本体尚未安装;此时输入斜杠命令会提示命令不存在。常见误解是认为 add 即完成安装,实际必须再执行 install 步骤。
正例 · Pro
轻量场景直接复用仓库内置命令
cp .claude/commands/open-code-review.md .claude/commands/cp .claude/commands/commit.md .claude/commands//open-code-review:review
仓库根目录 .claude/commands/ 已内置 open-code-review.md(另有 commit.md/tag.md),复制到项目即可获得斜杠命令,适合不想走插件市场的简单场景,且审查、提交、打标签闭环齐全。
反例 · Con
插件与内置命令双通道同时安装,命令注册冲突
/plugin marketplace add alibaba/open-code-review/plugin install open-code-review@open-code-reviewcp .claude/commands/open-code-review.md .claude/commands//open-code-review:review # 行为不确定/双重注册
既走插件市场又手动复制内置命令,同一命令可能注册两次导致行为冲突或二选一失效。两条通道任选其一,不要叠加。
正例 · Pro
安全敏感仓库用 delegate-review 做职责分离
/open-code-review:delegate-review# Claude 仅汇总与裁决,OCR 侧执行审查
委托审查路径让 OCR 承担实际审查、宿主模型只负责汇总裁决,适合安全敏感仓库的职责分离诉求。
反例 · Con
普通审查误用 delegate-review,模型配置错位
/open-code-review:delegate-review # 普通场景误用# 走不到预期模型的直接审查配置
review 与 delegate-review 的审查范围与权限模型不同,普通代码审查误用委托命令可能走不到预期的模型配置。先用 /open-code-review:review 覆盖日常场景。

实践资产 · Assets

插件
Claude Code 斜杠命令定义
.claude/commands/open-code-review.md · 1595 B

相关边