@ranger1/dx 0.1.28 → 0.1.30

package/@opencode/agents/claude-reviewer.md

@@ -14,21 +14,26 @@ tools:
 
 - `PR #<number>`
 - `round: <number>`
-- `contextFile: <path>`
+- `contextFile: <filename>`
 
 ## 输出（强制）
 
 只输出一行：
 
-`reviewFile: <path>`
+`reviewFile: <filename>`
+
 
 ## 规则
 
 - 默认已在 PR head 分支（可直接读工作区代码）
 - 可用 `git`/`gh` 只读命令获取 diff/上下文
-- 写入 reviewFile：`~/.opencode/cache/review-CLD-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
+- 写入 reviewFile：`review-CLD-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
 - findings id 必须以 `CLD-` 开头
 
+## Cache 约定（强制）
+- 本流程所有中间文件都存放在 `~/.opencode/cache/`
+- agent/命令之间仅传递文件名（basename），不传目录
+
 ## reviewFile 格式（强制）
 
 ```md

package/@opencode/agents/codex-reviewer.md

@@ -15,21 +15,27 @@ tools:
 
 - `PR #<number>`
 - `round: <number>`
-- `contextFile: <path>`
+- `contextFile: <filename>`
 
 ## 输出（强制）
 
 只输出一行：
 
-`reviewFile: <path>`
+`reviewFile: <filename>`
+
 
 ## 规则
 
 - 默认已在 PR head 分支（可直接读工作区代码）
 - 可用 `git`/`gh` 只读命令获取 diff/上下文
-- 写入 reviewFile：`~/.opencode/cache/review-CDX-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
+- 写入 reviewFile：`review-CDX-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
 - findings id 必须以 `CDX-` 开头
 
+## Cache 约定（强制）
+- 本流程所有中间文件都存放在 `~/.opencode/cache/`
+- agent/命令之间仅传递文件名（basename），不传目录
+
+
 ## reviewFile 格式（强制）
 
 ```md

package/@opencode/agents/gemini-reviewer.md

@@ -14,21 +14,27 @@ tools:
 
 - `PR #<number>`
 - `round: <number>`
-- `contextFile: <path>`
+- `contextFile: <filename>`
 
 ## 输出（强制）
 
 只输出一行：
 
-`reviewFile: <path>`
+`reviewFile: <filename>`
+
 
 ## 规则
 
 - 默认已在 PR head 分支（可直接读工作区代码）
 - 可用 `git`/`gh` 只读命令获取 diff/上下文
-- 写入 reviewFile：`~/.opencode/cache/review-GMN-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
+- 写入 reviewFile：`review-GMN-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
 - findings id 必须以 `GMN-` 开头
 
+## Cache 约定（强制）
+- 本流程所有中间文件都存放在 `~/.opencode/cache/`
+- agent/命令之间仅传递文件名（basename），不传目录
+
+
 ## reviewFile 格式（强制）
 
 ```md

package/@opencode/agents/pr-context.md

@@ -4,22 +4,12 @@ mode: subagent
 model: openai/gpt-5.1-codex-mini
 temperature: 0.1
 tools:
-  write: false
-  edit: false
   bash: true
 ---
 
 # PR Context Builder
 
-为 PR Review Loop 构建“松散上下文文件”（Markdown），让 reviewer 读取文件而不是在 prompt 里解析大段精确 JSON。
-
-目标：
-
-- 生成 PR context 文件（标题/描述/labels/分支/修改文件清单/评论摘要）
-- 默认假设已通过 pr-precheck：gh 已认证、PR 可访问、当前分支已切到 PR head 分支
-- 把信息拼成适合大模型阅读的 Markdown（不追求严格 schema）
-- 落盘到按 `prNumber + round + runId` 命名的文件
-- 返回“单一 JSON 对象”，只包含文件路径等元信息
+为 PR Review Loop 构建上下文文件（Markdown）。确定性工作由脚本完成。
 
 ## 输入要求（强制）
 
@@ -28,168 +18,18 @@ tools:
 - PR 编号（如：`PR #123` 或 `prNumber: 123`）
 - round（如：`round: 1`；无则默认 1）
 
-## 允许/禁止
-
-- ✅ 允许使用 `gh` 只读获取 PR 信息与评论
-- ✅ 允许使用 `git` 获取修改文件清单（推荐）
-- ✅ 允许写入缓存文件到 `~/.opencode/cache/`
-- ✅ 允许使用本地脚本（python）拼接/裁剪内容
-- ⛔ 禁止修改业务代码（只允许写入 `~/.opencode/cache/`）
-- ⛔ 禁止发布 GitHub 评论（不调用 `gh pr comment/review`）
-- ⛔ 禁止 push/force push/rebase
-
 ## 输出（强制）
 
-你必须输出“单一 JSON 对象”，且能被 `JSON.parse()` 解析。
+脚本会写入 `~/.opencode/cache/`，stdout 只输出单一 JSON（可 `JSON.parse()`）。
 
-```ts
-type PRContextBuildResult = {
-  agent: 'pr-context'
-  prNumber: number
-  round: number
-  runId: string
-  repo: { nameWithOwner: string }
-  headOid: string
-  existingMarkerCount?: number
-  contextFile: string
-}
-```
-
-## 生成规则（强制）
+## Cache 约定（强制）
 
-1. 假设已完成 pr-precheck（gh 已认证、PR 可访问、当前分支已切到 PR head 分支、工作区可用）
-2. 获取 PR 元信息（title/body/labels/base/head oid/ref/url/isDraft）
-3. 获取修改文件清单（优先用 git diff 与 baseRefName 对比；不包含 patch）
-4. 获取评论：最多最近 10 条，正文截断 300 字符
-5. 生成 runId：必须包含 prNumber 与 round；使用 `sha1(prNumber:round:headOid)` 的前 12 位（不使用时间）
-6. 写入 `~/.opencode/cache/pr-context-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-7. 上下文文件内容必须包含：
 
-- PR 基本信息（repo/pr/url/base/head/headOid/labels）
-- Title / Body 摘要
-- 变更文件清单（每文件 additions/deletions）
-  - 最近评论摘要
-  - 历史 marker 计数（用于提示是否已跑过 loop）
 
-## 实现建议（bash + python）
+## 调用脚本（强制）
 
-你可以按如下思路实现，并确保最终只输出 JSON：
+脚本位置：`~/.opencode/agents/pr_context.py`
 
 ```bash
-set -euo pipefail
-
-mkdir -p "$HOME/.opencode/cache"
-
-OWNER_REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)
-
-PR_JSON=$(gh pr view "$PR_NUMBER" --repo "$OWNER_REPO" \
-  --json number,url,title,body,isDraft,labels,baseRefName,headRefName,baseRefOid,headRefOid,comments)
-
-BASE_REF=$(echo "$PR_JSON" | python3 -c 'import json,sys;print(json.load(sys.stdin).get("baseRefName") or "")')
-test -n "$BASE_REF" || BASE_REF="main"
-
-git fetch origin "$BASE_REF" > /dev/null 2>&1 || true
-FILES_TXT=$(git diff --name-status "origin/$BASE_REF...HEAD" 2>/dev/null || git diff --name-status "$BASE_REF...HEAD" 2>/dev/null || true)
-
-OWNER_REPO="$OWNER_REPO" PR_NUMBER="$PR_NUMBER" ROUND="$ROUND" PR_JSON="$PR_JSON" FILES_TXT="$FILES_TXT" \
-python3 - <<'PY'
-import json, os, hashlib
-
-pr_number = int(os.environ['PR_NUMBER'])
-round_num = int(os.environ.get('ROUND') or '1')
-owner_repo = os.environ['OWNER_REPO']
-pr = json.loads(os.environ['PR_JSON'])
-files_txt = os.environ.get('FILES_TXT') or ''
-
-head_oid = pr.get('headRefOid') or ''
-run_seed = f"{pr_number}:{round_num}:{head_oid}".encode('utf-8')
-run_id = hashlib.sha1(run_seed).hexdigest()[:12]
-
-def clip(s, n):
-  if s is None:
-    return ''
-  s = str(s)
-  return s if len(s) <= n else (s[:n] + '...')
-
-labels = [l.get('name') for l in (pr.get('labels') or []) if isinstance(l, dict) and l.get('name')]
-
-dir_path = os.path.join(os.path.expanduser('~'), '.opencode', 'cache')
-os.makedirs(dir_path, exist_ok=True)
-context_file = os.path.join(dir_path, f"pr-context-pr{pr_number}-r{round_num}-{run_id}.md")
-
-base_ref = pr.get('baseRefName') or ''
-head_ref = pr.get('headRefName') or ''
-url = pr.get('url') or ''
-
-file_rows = []
-for line in files_txt.splitlines():
-  parts = line.split('\t')
-  if not parts:
-    continue
-  status = parts[0].strip()
-  path = parts[-1].strip() if len(parts) >= 2 else ''
-  if not path:
-    continue
-  file_rows.append((status, path))
-
-comments = pr.get('comments') or []
-recent = comments[-10:] if isinstance(comments, list) else []
-
-with open(context_file, 'w', encoding='utf-8', newline='\n') as fp:
-  fp.write('# PR Context\n\n')
-  fp.write(f"- Repo: {owner_repo}\n")
-  fp.write(f"- PR: #{pr_number} {url}\n")
-  fp.write(f"- Round: {round_num}\n")
-  fp.write(f"- RunId: {run_id}\n")
-  fp.write(f"- Base: {base_ref}\n")
-  fp.write(f"- Head: {head_ref}\n")
-  fp.write(f"- HeadOid: {head_oid}\n")
-  fp.write(f"- Draft: {pr.get('isDraft')}\n")
-  marker = '<!-- pr-review-loop-marker'
-  marker_count = 0
-  for c in recent:
-    if not isinstance(c, dict):
-      continue
-    body = c.get('body') or ''
-    if isinstance(body, str) and marker in body:
-      marker_count += 1
-
-  fp.write(f"- Labels: {', '.join(labels) if labels else '(none)'}\n")
-  fp.write(f"- ExistingLoopMarkers: {marker_count}\n\n")
-
-  fp.write('## Title\n\n')
-  fp.write(clip(pr.get('title') or '', 200) + '\n\n')
-
-  fp.write('## Body (excerpt)\n\n')
-  fp.write(clip(pr.get('body') or '', 2000) or '(empty)')
-  fp.write('\n\n')
-
-  fp.write(f"## Changed Files ({len(file_rows)})\n\n")
-  for (status, path) in file_rows:
-    fp.write(f"- {status} {path}\n")
-  fp.write('\n')
-
-  fp.write('## Recent Comments (excerpt)\n\n')
-  if recent:
-    for c in recent:
-      if not isinstance(c, dict):
-        continue
-      author = (c.get('author') or {}).get('login') if isinstance(c.get('author'), dict) else None
-      fp.write(f"- {author or 'unknown'}: {clip(c.get('body') or '', 300)}\n")
-  else:
-    fp.write('(none)\n')
-
-result = {
-  'agent': 'pr-context',
-  'prNumber': pr_number,
-  'round': round_num,
-  'runId': run_id,
-  'repo': {'nameWithOwner': owner_repo},
-  'headOid': head_oid,
-  'existingMarkerCount': marker_count,
-  'contextFile': context_file,
-}
-
-print(json.dumps(result, ensure_ascii=True))
-PY
+python3 ~/.opencode/agents/pr_context.py --pr <PR_NUMBER> --round <ROUND>
 ```

package/@opencode/agents/pr-fix.md

@@ -19,16 +19,20 @@ tools:
 | -------------- | ------------------------------------------------------------------------ |
 | **角色**       | 代码修复 Specialist（执行层）                                            |
 | **上下文隔离** | 仅处理问题列表；不重新获取评审意见（默认不调用 `gh` 拉取 PR 上下文）     |
-| **输入**       | PR 编号 + `fixFile`（Markdown 文件路径，Structured Handoff）             |
-| **输出**       | fixReportFile（Markdown 文件路径）                                       |
+| **输入**       | PR 编号 + `fixFile`（Markdown 文件名，Structured Handoff）               |
+| **输出**       | fixReportFile（Markdown 文件名）                                         |
 | **边界**       | ✅ 可修改代码、提交并推送；⛔ 不发布 GitHub 评论（由 Orchestrator 负责） |
 
 ## 前置条件
 
+### Cache 约定（强制）
+- 本流程所有中间文件都存放在 `~/.opencode/cache/`
+- agent/命令之间仅传递文件名（basename），不传目录
+
 ### 必需输入
 
 - **PR 编号**：调用者必须在 prompt 中明确提供（如：`请修复 PR #123`）
-- **fixFile**：调用者必须在 prompt 中提供问题清单文件路径（Markdown，Structured Handoff）
+- **fixFile**：调用者必须在 prompt 中提供问题清单文件名（basename）（Structured Handoff）
 
 ### 失败快速退出
 
@@ -87,7 +91,6 @@ Round: 2
 要求：只依赖 prompt 中的 `fixFile`；不要重新拉取/生成评审意见。
 
 - 用 bash 读取 `fixFile`（例如 `cat "$fixFile"`）
-- 从 `## IssuesToFix` 中解析条目，按 `priority` 排序并按 `id` 去重
 - 解析失败则返回 `INVALID_FIX_FILE`
 
 ### 2. 逐项修复（No Scope Creep）
@@ -96,10 +99,6 @@ Round: 2
 - 每个修复必须能明确对应到原问题的 `id`
 - 无法修复时必须记录原因（例如：缺少上下文、超出本 PR 范围、需要产品决策、需要数据库迁移等）
 
-执行前检查（强制）：
-
-- 当前分支禁止是 `main`/`master`（应已由 pr-context 切到 PR 分支）
-
 ### 3. 提交策略
 
 - 强制：每个 findingId 单独一个提交（一个 findingId 对应一个 commit）
@@ -117,6 +116,7 @@ Round: 2
 - 不确定的问题降级为拒绝修复，并写清 `reason`（不要“猜”）
 - 修改尽量小：最小 diff、保持既有风格与约定
 - 修改项目里的json/jsonc文件的时候，使用python脚本进行修改，禁止手动拼接字符串,防止格式错误
+- 修复完成之后，调用 dx lint 和 dx build all 确保编译通过
 
 ## 重要约束（强制）
 
@@ -126,11 +126,12 @@ Round: 2
 
 ## 输出（强制）
 
-写入：`~/.opencode/cache/fix-report-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
+写入：`fix-report-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
 
 最终只输出一行：
 
-`fixReportFile: <path>`
+`fixReportFile: <filename>`
+
 
 ## fixReportFile 内容格式（强制）
 
@@ -171,4 +172,4 @@ Rejected: <n>
 ## 输出有效性保证
 
 - fixReportFile 必须成功写入
-- stdout 只能输出一行 `fixReportFile: <path>`
+- stdout 只能输出一行 `fixReportFile: <filename>`

package/@opencode/agents/pr-precheck.md

@@ -4,106 +4,49 @@ mode: subagent
 model: openai/gpt-5.2-codex
 temperature: 0.1
 tools:
-  write: true
-  edit: true
   bash: true
 ---
 
 # PR Precheck
 
-## 输入（prompt 必须包含）
-
-- `PR #<number>`
+## Cache 约定（强制）
+- 本流程所有中间文件都存放在 `~/.opencode/cache/`
+- agent/命令之间仅传递文件名（basename），不传目录
 
-## 要做的事（按顺序）
 
-1. 校验环境/权限
+## 输入（prompt 必须包含）
 
-- 必须在 git 仓库内，否则输出 `{"error":"NOT_A_GIT_REPO"}`
-- `gh auth status` 必须通过，否则输出 `{"error":"GH_NOT_AUTHENTICATED"}`
-- PR 必须存在且可访问，否则输出 `{"error":"PR_NOT_FOUND_OR_NO_ACCESS"}`
+- `PR #<number>`
 
-2. 切换到 PR 分支
+## 一键脚本
 
-- 读取 PR 的 `headRefName`
-- 如果当前分支不是 headRefName：执行 `gh pr checkout <PR_NUMBER>`
-- 切换失败输出 `{"error":"PR_CHECKOUT_FAILED"}`
+脚本位置：`~/.opencode/agents/pr_precheck.py`
 
-3. 检查 PR 合并冲突（如有则解决 + 提交 + 推送）
+```bash
+python3 ~/.opencode/agents/pr_precheck.py <PR_NUMBER>
+```
 
-- 读取 PR 的 `baseRefName` 与 `mergeable`
-- base 分支名必须兼容 `main`/`master`：
-  - 优先使用 PR 返回的 `baseRefName`
-  - 若 `baseRefName` 为空：用 `gh repo view --json defaultBranchRef -q .defaultBranchRef.name` 获取仓库默认分支
-  - 若仍取不到：输出 `{"error":"PR_BASE_REF_NOT_FOUND"}`
-- 拉取 base 分支（后续 merge/affected build 都依赖）：
-  - `git fetch origin <baseRefName>`（若失败则按 `main/master` fallback 重试）
-  - 仍失败：输出 `{"error":"PR_BASE_REF_FETCH_FAILED"}`
-- 若 `mergeable=CONFLICTING`（存在合并冲突）：
-  - 尝试把 base 合入当前 PR 分支（不 rebase、不 force push）：
-    - `git merge --no-ff --no-commit origin/<baseRefName>`
-  - 若 merge 产生冲突文件（`git diff --name-only --diff-filter=U` 非空）：
-    - 先按文件类型做“低风险确定性策略”，再对剩余文件做“基于内容的智能合并”
-    - 低风险确定性策略（示例，按仓库实际补充）：
-      - lockfiles（如 `pnpm-lock.yaml`/`package-lock.json`/`yarn.lock`）：优先 `--theirs`（以 base 为准，减少依赖漂移）
-      - 其余生成物/构建产物：能识别则同上（优先 base），识别不了不要瞎选
-    - 对剩余冲突文件：
-      - 读取包含冲突标记（`<<<<<<<`/`=======`/`>>>>>>>`）的文件内容
-      - 基于代码语义进行合并：
-        - 保证语法正确（JS/TS/JSON/YAML 等）
-        - 变更尽量小
-        - 若两边都合理：优先保留 PR 的业务逻辑，同时把 base 的必要改动（接口/字段/类型）合进去
-      - 写回文件，确保冲突标记完全消除
-    - 合并完成后必须验证：
-      - `git diff --name-only --diff-filter=U` 为空
-      - 不再存在冲突标记（允许用 `git grep -n '<<<<<<< ' -- <files>` 复核）
-    - 若仍有未解决冲突：
-      - `git merge --abort`
-      - 输出 `{"error":"PR_MERGE_CONFLICTS_UNRESOLVED"}`
-    - 全部解决后：
-      - `git add -A` 后 `git commit`（建议 message：`chore(pr #<PR_NUMBER>): resolve merge conflicts`）
-      - `git push`（如无 upstream：`git push -u origin HEAD`）
-  - 任一步失败则输出 `{"error":"PR_CONFLICT_AUTO_RESOLVE_FAILED"}`
-  - 推送失败输出 `{"error":"PR_CONFLICT_PUSH_FAILED"}`
+## 仅当出现 merge 冲突时怎么处理
 
-4. 预检：lint + build
+当脚本输出 `{"error":"PR_MERGE_CONFLICTS_UNRESOLVED"}` 时：
 
-- 运行 `dx lint`
-- 运行 `dx build affected --dev -- --base=origin/<baseRefName> --head=HEAD`
+```bash
+# 1) 获取 base 分支名
+gh pr view <PR_NUMBER> --json baseRefName --jq .baseRefName
 
-5. 若 lint/build 失败：生成 fixFile（Markdown）并返回失败
+# 2) 拉取 base 并合并到当前 PR 分支（不 rebase、不 force push）
+git fetch origin <baseRefName>
+git merge --no-ff --no-commit origin/<baseRefName>
 
-- 写入前先 `mkdir -p "$HOME/.opencode/cache"`
-- fixFile 路径：`~/.opencode/cache/precheck-fix-pr<PR_NUMBER>-<RUN_ID>.md`
-- fixFile 只包含 `## IssuesToFix`
-- fixFile 格式（Markdown，最小字段集，供 `pr-fix` 解析）：
+# 3) 解决冲突后确认无未解决文件
+git diff --name-only --diff-filter=U
+git grep -n '<<<<<<< ' -- .
 
-```md
-## IssuesToFix
+# 4) 提交并推送
+git add -A
+git commit -m "chore(pr #<PR_NUMBER>): resolve merge conflicts"
+git push
 
-- id: PRE-001
-  priority: P0|P1|P2|P3
-  category: lint|build|quality
-  file: <path>
-  line: <number|null>
-  title: <short>
-  description: <error message>
-  suggestion: <how to fix>
+# 5) 重新运行预检脚本
+python3 ~/.opencode/agents/pr_precheck.py <PR_NUMBER>
 ```
-- 每条 issue 的 `id` 必须以 `PRE-` 开头（例如 `PRE-001`）
-- 尽量从输出中提取 file/line；取不到则 `line: null`
-
-## 输出（强制）
-
-只输出一个 JSON 对象：
-
-- 通过：`{"ok":true}`
-- 需要修复：`{"ok":false,"fixFile":"~/.opencode/cache/precheck-fix-pr123-<RUN_ID>.md"}`
-- 环境/权限/分支问题：`{"error":"..."}`
-
-## 规则
-
-- 不要输出任何时间字段
-- 不要在 stdout 输出 lint/build 的长日志（写入 fixFile 的 description 即可）
-- stdout 只能输出最终的单一 JSON 对象（其余命令输出请重定向到文件或丢弃）
-- 允许使用 bash 生成 runId（例如 8-12 位随机/sha1 截断均可）

package/@opencode/agents/pr-review-aggregate.md

@@ -4,13 +4,15 @@ mode: subagent
 model: openai/gpt-5.1-codex-mini
 temperature: 0.1
 tools:
-  write: true
-  edit: false
   bash: true
 ---
 
 # PR Review Aggregator
 
+## Cache 约定（强制）
+- 本流程所有中间文件都存放在 `~/.opencode/cache/`
+- agent/命令之间仅传递文件名（basename），不传目录
+
 ## 输入（两种模式）
 
 ### 模式 A：评审聚合 + 生成 fixFile + 发布评审评论
@@ -18,15 +20,15 @@ tools:
 - `PR #<number>`
 - `round: <number>`
 - `runId: <string>`
-- `contextFile: <path>`
-- `reviewFile: <path>`（三行，分别对应 CDX/CLD/GMN）
+- `contextFile: <filename>`
+- `reviewFile: <filename>`（三行，分别对应 CDX/CLD/GMN）
 
 ### 模式 B：发布修复评论（基于 fixReportFile）
 
 - `PR #<number>`
 - `round: <number>`
 - `runId: <string>`
-- `fixReportFile: <path>`
+- `fixReportFile: <filename>`
 
 示例：
 
@@ -34,86 +36,48 @@ tools:
 PR #123
 round: 1
 runId: abcdef123456
-contextFile: ~/.opencode/cache/pr-context-pr123-r1-abcdef123456.md
-reviewFile: ~/.opencode/cache/review-CDX-pr123-r1-abcdef123456.md
-reviewFile: ~/.opencode/cache/review-CLD-pr123-r1-abcdef123456.md
-reviewFile: ~/.opencode/cache/review-GMN-pr123-r1-abcdef123456.md
+contextFile: pr-context-pr123-r1-abcdef123456.md
+reviewFile: review-CDX-pr123-r1-abcdef123456.md
+reviewFile: review-CLD-pr123-r1-abcdef123456.md
+reviewFile: review-GMN-pr123-r1-abcdef123456.md
 ```
 
-## 你要做的事（按模式执行）
-
-模式 A：
+## 执行方式（强制）
 
-1. Read `contextFile` 与全部 `reviewFile`
-2. 计算 needsFix（P0/P1/P2 任意 > 0）
-3. 合并重复的问题为一个
-4. 发布评审评论到 GitHub（gh pr comment），必须带 marker，评论正文必须内联包含：
-   - Summary（P0/P1/P2/P3 统计）
-   - P0/P1/P2 问题列表（至少 id/title/file:line/suggestion）
-   - 三个 reviewer 的 reviewFile 原文（建议放到 <details>）
-5. 若 needsFix：生成 `fixFile`（Markdown）并返回；否则发布“完成”评论并返回 stop
+所有确定性工作（解析/聚合/发评论/生成 fixFile/输出 JSON）都由 `~/.opencode/agents/pr_review_aggregate.py` 完成。
 
-模式 B：
+你只做一件事：在模式 A 里用大模型判断哪些 finding 是重复的，并把重复分组作为参数传给脚本（不落盘）。
 
-1. Read `fixReportFile`
-2. 发布修复评论到 GitHub（gh pr comment），必须带 marker，评论正文必须内联 fixReportFile 内容
-3. 输出 `{"ok":true}`
+## 重复分组（给大模型输出）
 
-## 输出（强制）
-
-模式 A：只输出一个 JSON 对象（很小）：
+大模型只输出一行 JSON（不要代码块、不要解释文字、不要换行）：
 
 ```json
-{
-  "stop": false,
-  "fixFile": "~/.opencode/cache/fix-pr123-r1-abcdef123456.md"
-}
+{"duplicateGroups":[["CDX-001","CLD-003"],["GMN-002","CLD-005","CDX-004"]]}
 ```
 
-字段：
-
-- `stop`: boolean
-- `fixFile`: string（仅 stop=false 时必须提供）
+## 调用脚本（强制）
 
-模式 B：只输出：
+模式 A（带 reviewFile + 重复分组）：
 
-```json
-{ "ok": true }
+```bash
+python3 ~/.opencode/agents/pr_review_aggregate.py \
+  --pr <PR_NUMBER> \
+  --round <ROUND> \
+  --run-id <RUN_ID> \
+  --context-file <CONTEXT_FILE> \
+  --review-file <REVIEW_FILE_1> \
+  --review-file <REVIEW_FILE_2> \
+  --review-file <REVIEW_FILE_3> \
+  --duplicate-groups-b64 <BASE64_JSON>
 ```
 
-## 规则
-
-- 不要输出 ReviewResult JSON
-- 不要校验/要求 reviewer 的 JSON
-- 不要生成/输出任何时间字段
-- `fixFile` 只包含 P0/P1/P2
-- `id` 必须使用 reviewer 给出的 findingId（例如 `CDX-001`），不要再改前缀
-
-## 评论要求
-
-- 每条评论必须包含：`<!-- pr-review-loop-marker -->`
-- body 必须是最终字符串（用 `--body-file` 读取文件），不要依赖 heredoc 变量展开
-- 禁止在评论里出现本地缓存文件路径（例如 `~/.opencode/cache/...`）
-
-## fixFile 输出路径与格式
-
-- 路径：`~/.opencode/cache/fix-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-- 格式：
-
-```md
-# Fix File
-
-PR: <PR_NUMBER>
-Round: <ROUND>
-
-## IssuesToFix
+模式 B（带 fixReportFile）：
 
-- id: CDX-001
-  priority: P1
-  category: quality
-  file: <path>
-  line: <number|null>
-  title: <short>
-  description: <text>
-  suggestion: <text>
+```bash
+python3 ~/.opencode/agents/pr_review_aggregate.py \
+  --pr <PR_NUMBER> \
+  --round <ROUND> \
+  --run-id <RUN_ID> \
+  --fix-report-file <FIX_REPORT_FILE>
 ```