OCDX OpenCode Plugin

这是一个可安装的 OpenCode 插件（npm 包名：ocdx），提供一个主要 slash 命令：

- /pr-review-loop：多模型 PR Review + 自动修复 loop

---

使用者快速上手（OpenCode 用户）

$3

在你的项目 opencode.json 加上插件：OpenCode 会在启动时用 Bun 自动安装 npm 插件。

``json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["ocdx"]
}
`

安装后你会获得 slash 命令：

- /pr-review-loop

OpenCode 插件机制参考：https://opencode.ai/docs/plugins/

$3

/pr-review-loop 会调用外部 CLI（见 src/pr-review-loop/preflight.ts 的 preflight 检查），因此你需要：

- 已安装并登录 GitHub CLI：gh auth login
- 已安装 dx CLI，并且至少包含 dx lint、dx build 子命令
- 在一个 git 仓库内运行
- 工作区必须干净（git status --porcelain 为空）
- 必须在一个真实分支上（不能 detached HEAD）

$3

推荐在项目根目录创建 .opencode/ocdx/config.json：

- 这是“项目级配置”，优先级最高
- 如果没有项目级配置，会回退到全局配置 ~/.config/opencode/ocdx/config.json（或 XDG_CONFIG_HOME）
- 如果两者都不存在，会使用插件内置默认值（见 @asset/config.json）

`json
{
"reviewerModels": ["anthropic/claude-3-7-sonnet-20250219"],
"commentsAnalyzerModel": "anthropic/claude-3-5-haiku-20241022",
"prFixModel": "anthropic/claude-3-7-sonnet-20250219"
}
`

字段说明（最常用）：

- reviewerModels：1-5 个 reviewer 模型（会并行跑）
- commentsAnalyzerModel：评论线程分析模型（用于判断是否存在未解决的人类 review 阻塞项）
- prFixModel：自动修复模型
- prompts.*：覆盖默认 prompt（可选；默认使用插件内置 prompt）

$3

`bash
/pr-review-loop
/pr-review-loop --pr
`

说明：

- 不传 --pr 时会尝试从当前分支自动检测 PR
- preflight 不通过时会直接给出可执行的错误提示（例如 gh 未登录、dx 不存在、工作区不干净等）

---

开发者说明（维护/发布）

$3

`bash
pnpm install
pnpm run build
pnpm run lint
pnpm run format:check
`

$3

prepack 会自动 clean + build，保证 dist/ 存在：

`bash
pnpm pack
`

$3

`bash
pnpm publish
`

发布前建议检查包内容：

`bash
npm pack --dry-run
`

$3

- tools：ocdx_pr_review_loop
- commands：/pr-review-loop
- subagents：ocdx-reviewer、ocdx-comments-analyzer、ocdx-pr-fix

---

参考文档

- docs/pr-review-loop-reference.md`
- OpenCode Plugins: https://opencode.ai/docs/plugins/

License

MIT