@ranger1/dx 0.1.29 → 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）
 
 ### 失败快速退出
 
@@ -122,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 内容格式（强制）
 
@@ -167,4 +172,4 @@ Rejected: <n>
 ## 输出有效性保证
 
 - fixReportFile 必须成功写入
-- stdout 只能输出一行 `fixReportFile: <path>`
+- stdout 只能输出一行 `fixReportFile: <filename>`