第 5 章 · 02 Claude Code 插件

第 5 章 · 02 Claude Code 插件

本节摘要:安装打包的命令,使 OCR 在 Claude Code 内端到端运行——评审 diff、分类发现,并自动应用值得采纳的修复。本节讲清三件事:仓库里的 Claude Code plugin 长什么样、三种安装方式(plugin marketplace 推荐 / 直接复制命令文件到 .claude/commands/ 项目级或用户级 / 其他支持命令的 agent)、以及命令 prompt 让 Claude Code 执行的三步工作流(运行评审 → 过滤分级 → 自动修复)。读完你能在 Claude Code 里用一条 /open-code-review:review 命令完成「评审并清理」。

内容来源:原项目中文文档 pages/src/content/docs/zh/integrations/claude-code.md,套用体系化模板改写。

学习目标

阅读完本节,你应当能够:

1. 说明 Claude Code plugin / command 的定位(同一底层 CLI 的 slash-command 版本)。
2. 用 plugin marketplace、直接复制命令文件两种方式安装,并区分项目级与用户级。
3. 描述命令 prompt 触发的三步工作流(运行评审 → 过滤分级 → 自动修复)。
4. 区分它与 Agent Skill 的默认修复行为(本插件默认自动修复)。
5. 说明命令如何从自然语言请求推断 ocr review 参数。

一、仓库里有什么

仓库在 plugins/open-code-review/claude-code/ 下提供 Claude Code plugin。命令 prompt 本体位于 plugins/open-code-review/claude-code/commands/review.md,是下述工作流的权威依据。

二、安装

方式 1:plugin marketplace(推荐)

在 Claude Code 内运行这两条命令:

/plugin marketplace add alibaba/open-code-review
/plugin install open-code-review@open-code-review
​

这会注册 /open-code-review:review slash 命令,并保持可通过 /plugin 更新。

方式 2:直接复制命令文件

若想跳过 plugin marketplace,把命令文件直接放进 .claude/commands/。这会注册为 /open-code-review(无 :review 后缀)。

项目级(随仓库提交,团队共享):

mkdir -p .claude/commands
curl -o .claude/commands/open-code-review.md \
  https://raw.githubusercontent.com/alibaba/open-code-review/main/plugins/open-code-review/claude-code/commands/review.md
​

用户级(机器上每个项目可用):

mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/open-code-review.md \
  https://raw.githubusercontent.com/alibaba/open-code-review/main/plugins/open-code-review/claude-code/commands/review.md
​

其他支持命令的 agent

命令文件是带单个 frontmatter 字段的纯 markdown——没有任何 Claude Code 专有内容。如果你的 agent 支持类似的 command 约定(从目录加载为可调用命令的 markdown prompt),上面的文件复制方法就是安装路径:把 open-code-review.md 放进你的 agent 读取命令的目录,按你的 agent 调用命令的方式调用它。prompt 正文与 agent 无关——它只告诉模型选哪些 ocr 参数以及如何分级输出。

💡 技巧:如果不想自行配置 LLM,可以试试本章委托模式一节——它让宿主 agent(Claude Code)提供模型,无需额外的 LLM 配置。

三、使用

在 Claude Code 中按名调用命令。通过 plugin marketplace 安装的用 /open-code-review:review,直接复制文件的用 /open-code-review:

/open-code-review:review
/open-code-review:review review this PR against main
/open-code-review:review focus on race conditions in commit abc123
​

prompt 解析你的请求并选择正确的 ocr review 参数:

• 无参数 → 工作区模式(staged + unstaged + untracked)
• 提到 commit → --commit
• 提到分支区间 → --from / --to

你也可以直接透传 OCR 参数(如 /open-code-review:review --commit abc123 或 --from main --to feature)。三种模式的语义见第 2 章 CLI 参考。

四、命令做什么:三步工作流

命令 prompt 很短——三步:

1. 运行评审。 用从你请求推断的参数调用 ocr review --audience agent(描述了需求上下文时加可选 --background)。输出在 5 分钟超时内捕获。
2. 过滤与评估。 把每条评论分为 High / Medium / Low。低置信(疑似误报、吹毛求疵、缺上下文)评论被静默丢弃;其余展示。
3. 修复。 对值得采纳的 High/Medium 项自动应用修复。

┌─────────────────────────────────────────────────────────────────┐
│  ① ocr review --audience agent [--commit|--from/--to] [-b ...]   │
│      └─ 5 分钟超时捕获输出                                        │
│  ② 分级 High/Medium/Low                                          │
│      └─ 低置信(疑似误报/吹毛求疵/缺上下文)静默丢弃              │
│  ③ 自动应用 High/Medium 修复                                     │
└─────────────────────────────────────────────────────────────────┘
​

⚠️ 注意:与本章 Agent Skill 一节不同,此命令默认自动修复——它是「评审并清理」工作流的合适选择,而非「给我看 diff」工作流。若你想让命令在修改代码前先询问,或收紧分级标准,编辑你本地的 prompt 副本。Claude Code 每次调用都重新读取命令,因此无需重启。

五、与 Agent Skill 的差异对照

💡 技巧:两者底层调用同一个 ocr CLI;选哪一个取决于你想要的工作流。想接入 CI(无人值守、纯评论)则用下一节的 CI/CD 集成。

本节要点回顾

1. plugin / command:同一底层 CLI 的 slash-command 版本,命令 prompt 在 review.md。
2. 三种安装:plugin marketplace(注册 /open-code-review:review)/ 直接复制到 .claude/commands/(项目级或用户级,注册为 /open-code-review)/ 其他支持命令的 agent。
3. 参数推断:无参→工作区、提 commit→--commit、提分支区间→--from/--to,也支持透传 OCR 参数。
4. 三步工作流:运行评审(5 分钟超时)→ 分级 High/Medium/Low(疑似误报静默丢弃)→ 自动修复 High/Medium。
5. 默认自动修复:与 Agent Skill 的「先询问」相反,适合「评审并清理」。
6. 热改:编辑本地 prompt 副本即生效,Claude Code 每次重新读取命令。
7. 免配 LLM:可用委托模式让宿主 agent 提供模型。

Claude Code 插件讲完了。下一节看 CI/CD 集成——在 GitHub Actions / GitLab CI 上把 OCR 接进每个 PR/MR,自动张贴行级评审评论。