@ranger1/dx 0.1.77 → 0.1.78

package/@opencode/agents/gh_review_harvest.py

@@ -1,292 +0,0 @@
-#!/usr/bin/env python3
-
-# Deterministic GitHub PR review harvester.
-#
-# - Fetches inline review threads via GraphQL (reviewThreads) with pagination.
-# - Fetches PR reviews and PR issue comments via REST (gh api) with pagination.
-# - Writes a raw JSON file into project cache: ./.cache/
-# - Prints exactly one JSON object to stdout: {"rawFile":"./.cache/...json"}
-
-import argparse
-import json
-import os
-import subprocess
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-
-
-MARKER_SUBSTR = "<!-- pr-review-loop-marker"
-
-def _repo_root():
-    try:
-        p = subprocess.run(
-            ["git", "rev-parse", "--show-toplevel"],
-            stdout=subprocess.PIPE,
-            stderr=subprocess.DEVNULL,
-            text=True,
-        )
-        out = (p.stdout or "").strip()
-        if p.returncode == 0 and out:
-            return Path(out)
-    except Exception:
-        pass
-    return Path.cwd()
-
-
-def _cache_dir(repo_root):
-    return (repo_root / ".cache").resolve()
-
-
-def _repo_relpath(repo_root, p):
-    try:
-        rel = p.resolve().relative_to(repo_root.resolve())
-        return "./" + rel.as_posix()
-    except Exception:
-        return os.path.basename(str(p))
-
-
-REPO_ROOT = _repo_root()
-CACHE_DIR = _cache_dir(REPO_ROOT)
-
-
-def _json_out(obj):
-    sys.stdout.write(json.dumps(obj, ensure_ascii=True))
-    sys.stdout.write("\n")
-
-
-def _run_capture(cmd):
-    try:
-        p = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
-        return p.returncode, p.stdout, p.stderr
-    except FileNotFoundError as e:
-        return 127, "", str(e)
-
-
-def _has_loop_marker(text):
-    if not text:
-        return False
-    try:
-        return MARKER_SUBSTR in str(text)
-    except Exception:
-        return False
-
-
-def _require_gh_auth():
-    rc, out, err = _run_capture(["gh", "auth", "status"])
-    if rc == 127:
-        return False, "GH_CLI_NOT_FOUND", "gh not found in PATH"
-    if rc != 0:
-        detail = (err or out or "").strip()
-        if len(detail) > 4000:
-            detail = detail[-4000:]
-        return False, "GH_NOT_AUTHENTICATED", detail
-    return True, None, None
-
-
-def _resolve_owner_repo(explicit_repo):
-    if explicit_repo:
-        s = str(explicit_repo).strip()
-        if s and "/" in s:
-            return s
-    rc, out, _ = _run_capture(["gh", "repo", "view", "--json", "nameWithOwner", "--jq", ".nameWithOwner"])
-    owner_repo = out.strip() if rc == 0 else ""
-    return owner_repo or None
-
-
-def _gh_api_json(args):
-    rc, out, err = _run_capture(["gh", "api"] + args)
-    if rc != 0:
-        raise RuntimeError(f"GH_API_FAILED: {(err or out or '').strip()}")
-    try:
-        return json.loads(out or "null")
-    except Exception:
-        raise RuntimeError("GH_API_JSON_PARSE_FAILED")
-
-
-def _gh_api_graphql(query, variables):
-    cmd = ["gh", "api", "graphql", "-f", f"query={query}"]
-    for k, v in (variables or {}).items():
-        if isinstance(v, int):
-            cmd.extend(["-F", f"{k}={v}"])
-        elif v is None:
-            cmd.extend(["-f", f"{k}="])
-        else:
-            cmd.extend(["-f", f"{k}={v}"])
-
-    rc, out, err = _run_capture(cmd)
-    if rc != 0:
-        raise RuntimeError(f"GH_GRAPHQL_FAILED: {(err or out or '').strip()}")
-    try:
-        return json.loads(out or "null")
-    except Exception:
-        raise RuntimeError("GH_GRAPHQL_JSON_PARSE_FAILED")
-
-
-def _flatten_threads(gql_data):
-    threads = []
-    pr = (((gql_data or {}).get("data") or {}).get("repository") or {}).get("pullRequest") or {}
-    conn = pr.get("reviewThreads") or {}
-    nodes = conn.get("nodes") or []
-    for t in nodes:
-        is_resolved = bool((t or {}).get("isResolved"))
-        is_outdated = bool((t or {}).get("isOutdated"))
-        if is_resolved or is_outdated:
-            continue
-        comments_conn = (t or {}).get("comments") or {}
-        comments_nodes = comments_conn.get("nodes") or []
-        comments = []
-        for c in comments_nodes:
-            body = (c or {}).get("body") or ""
-            body_text = (c or {}).get("bodyText") or ""
-            if _has_loop_marker(body) or _has_loop_marker(body_text):
-                continue
-            author = (c or {}).get("author") or {}
-            comments.append(
-                {
-                    "id": (c or {}).get("id"),
-                    "databaseId": (c or {}).get("databaseId"),
-                    "url": (c or {}).get("url"),
-                    "author": {
-                        "login": author.get("login"),
-                        "type": author.get("__typename"),
-                    },
-                    "body": body,
-                    "bodyText": body_text,
-                    "createdAt": (c or {}).get("createdAt"),
-                    "updatedAt": (c or {}).get("updatedAt"),
-                }
-            )
-
-        if not comments:
-            continue
-        threads.append(
-            {
-                "id": (t or {}).get("id"),
-                "isResolved": False,
-                "isOutdated": False,
-                "path": (t or {}).get("path"),
-                "line": (t or {}).get("line"),
-                "originalLine": (t or {}).get("originalLine"),
-                "startLine": (t or {}).get("startLine"),
-                "originalStartLine": (t or {}).get("originalStartLine"),
-                "comments": comments,
-            }
-        )
-
-    page_info = conn.get("pageInfo") or {}
-    return threads, {
-        "hasNextPage": bool(page_info.get("hasNextPage")),
-        "endCursor": page_info.get("endCursor"),
-    }
-
-
-def _fetch_all_review_threads(owner, repo, pr_number):
-    query = (
-        "query($owner:String!,$repo:String!,$prNumber:Int!,$after:String){"
-        "repository(owner:$owner,name:$repo){"
-        "pullRequest(number:$prNumber){"
-        "reviewThreads(first:100,after:$after){"
-        "pageInfo{hasNextPage endCursor}"
-        "nodes{"
-        "id isResolved isOutdated path line originalLine startLine originalStartLine "
-        "comments(first:100){nodes{"
-        "id databaseId url body bodyText createdAt updatedAt author{login __typename}"
-        "}}"
-        "}"
-        "}"
-        "}"
-        "}"
-        "}"
-    )
-
-    after = None
-    all_threads = []
-    while True:
-        data = _gh_api_graphql(query, {"owner": owner, "repo": repo, "prNumber": pr_number, "after": after})
-        threads, page = _flatten_threads(data)
-        all_threads.extend(threads)
-        if not page.get("hasNextPage"):
-            break
-        after = page.get("endCursor")
-        if not after:
-            break
-    return all_threads
-
-
-def main(argv):
-    class _ArgParser(argparse.ArgumentParser):
-        def error(self, message):
-            raise ValueError(message)
-
-    parser = _ArgParser(add_help=False)
-    parser.add_argument("--pr", type=int, required=True)
-    parser.add_argument("--round", type=int, default=1)
-    parser.add_argument("--run-id", required=True)
-    parser.add_argument("--repo")
-
-    try:
-        args = parser.parse_args(argv)
-    except ValueError:
-        _json_out({"error": "INVALID_ARGS"})
-        return 2
-
-    ok, code, detail = _require_gh_auth()
-    if not ok:
-        _json_out({"error": code, "detail": detail})
-        return 1
-
-    owner_repo = _resolve_owner_repo(args.repo)
-    if not owner_repo:
-        _json_out({"error": "REPO_NOT_FOUND"})
-        return 1
-    if "/" not in owner_repo:
-        _json_out({"error": "INVALID_REPO"})
-        return 1
-
-    owner, repo = owner_repo.split("/", 1)
-    pr_number = int(args.pr)
-    round_num = int(args.round)
-    run_id = str(args.run_id).strip()
-    if not run_id:
-        _json_out({"error": "MISSING_RUN_ID"})
-        return 1
-
-    CACHE_DIR.mkdir(parents=True, exist_ok=True)
-    raw_basename = f"gh-review-raw-pr{pr_number}-r{round_num}-{run_id}.json"
-    raw_path = CACHE_DIR / raw_basename
-
-    try:
-        threads = _fetch_all_review_threads(owner, repo, pr_number)
-
-        reviews = _gh_api_json([f"repos/{owner_repo}/pulls/{pr_number}/reviews", "--paginate"])
-        issue_comments = _gh_api_json([f"repos/{owner_repo}/issues/{pr_number}/comments", "--paginate"])
-
-        if isinstance(reviews, list):
-            reviews = [r for r in reviews if not _has_loop_marker((r or {}).get("body") or "")]
-        if isinstance(issue_comments, list):
-            issue_comments = [c for c in issue_comments if not _has_loop_marker((c or {}).get("body") or "")]
-
-        now = datetime.now(timezone.utc).isoformat()
-        payload = {
-            "repo": owner_repo,
-            "pr": pr_number,
-            "round": round_num,
-            "runId": run_id,
-            "generatedAt": now,
-            "reviewThreads": threads,
-            "reviews": reviews if isinstance(reviews, list) else [],
-            "issueComments": issue_comments if isinstance(issue_comments, list) else [],
-        }
-
-        raw_path.write_text(json.dumps(payload, ensure_ascii=True), encoding="utf-8", newline="\n")
-    except Exception as e:
-        _json_out({"error": "HARVEST_FAILED", "detail": str(e)[:800]})
-        return 1
-
-    _json_out({"rawFile": _repo_relpath(REPO_ROOT, raw_path)})
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main(sys.argv[1:]))

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

@@ -1,82 +0,0 @@
----
-description: build PR context file
-mode: subagent
-model: openai/gpt-5.3-codex
-temperature: 0.1
-tools:
-  bash: true
----
-
-# PR Context Builder
-
-为 PR Review Loop 构建上下文文件（Markdown）。确定性工作由脚本完成。
-
-## 输入要求（强制）
-
-调用者必须在 prompt 中明确提供：
-
-- PR 编号（如：`PR #123` 或 `prNumber: 123`）
-- round（如：`round: 1`；无则默认 1）
-
-## 唯一标识 runId（强制）
-
-- 脚本必须生成全局唯一标识 `runId`：`<PR>-<ROUND>-<HEAD_SHORT>`
-- 其中：
-  - `<PR>`：PR 编号
-  - `<ROUND>`：当前轮次
-  - `<HEAD_SHORT>`：`headOid` 的前 7 位（git rev-parse --short HEAD）
-- `runId` 必须包含在返回的 JSON 中，供后续步骤使用。
-
-
-## 输出（强制）
-
-脚本会写入项目内 `./.cache/`，stdout 只输出单一 JSON（可 `JSON.parse()`）。
-
-## Cache 约定（强制）
-
-- 缓存目录固定为 `./.cache/`；交接一律传 `./.cache/<file>`（repo 相对路径），禁止 basename-only（如 `foo.md`）。
-- 文件命名：`./.cache/pr-context-pr<PR>-r<ROUND>-<RUN_ID>.md`
-- `RUN_ID` 格式必须为 `<PR>-<ROUND>-<HEAD_SHORT>`
-
-## 调用脚本（强制）
-
-脚本位置：`~/.opencode/agents/pr_context.py`
-
-```bash
-python3 ~/.opencode/agents/pr_context.py --pr <PR_NUMBER> --round <ROUND>
-```
-
-## 脚本输出处理（强制）
-
-- 脚本 stdout 只会输出**单一一行 JSON**（可 `JSON.parse()`）。
-- **成功时**：你的最终输出必须是**脚本 stdout 的那一行 JSON 原样内容**。
-  - 禁止：解释/分析/补充文字
-  - 禁止：代码块（```）
-  - 禁止：前后空行
-- **失败/异常时**：
-  - 若脚本 stdout 已输出合法 JSON（包含 `error` 或其他字段）→ 仍然**原样返回该 JSON**。
-  - 若脚本未输出合法 JSON / 退出异常 → 仅输出一行 JSON：`{"error":"PR_CONTEXT_AGENT_FAILED"}`（必要时可加 `detail` 字段）。
-
-## GitHub 认证校验（重要）
-
-脚本会在调用 `gh repo view/gh pr view` 之前校验 GitHub CLI 已认证。
-
-- 为了避免 `gh auth status` 在“其他 host（例如 enterprise）认证异常”时误判，脚本会优先从 `git remote origin` 推断 host，并使用：
-  - `gh auth status --hostname <host>`
-- 推断失败时默认使用 `github.com`。
-
-可能出现的错误：
-
-- `{"error":"GH_CLI_NOT_FOUND"}`：找不到 `gh` 命令（PATH 内未安装/不可执行）
-  - 处理：安装 GitHub CLI：https://cli.github.com/
-- `{"error":"GH_NOT_AUTHENTICATED"}`：当前 repo 的 host 未认证
-  - 处理：`gh auth login --hostname <host>`
-
-本地排查命令（在同一个 shell 环境运行）：
-
-```bash
-git remote get-url origin
-gh auth status
-gh auth status --hostname github.com
-env | grep '^GH_'
-```

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

@@ -1,243 +0,0 @@
----
-description: PR fix review
-mode: subagent
-model: openai/gpt-5.3-codex
-temperature: 0.1
-tools:
-  write: true
-  edit: true
-  bash: true
----
-
-# Fix Specialist
-
-执行 PR 修复（基于 fixFile），并生成可直接发布到 GitHub 评论的修复报告（Markdown 文件）。
-
-## Agent 角色定义
-
-| 属性           | 描述                                                                     |
-| -------------- | ------------------------------------------------------------------------ |
-| **角色**       | 代码修复 Specialist（执行层）                                            |
-| **上下文隔离** | 仅处理问题列表；不重新获取评审意见（默认不调用 `gh` 拉取 PR 上下文）     |
-| **输入**       | PR 编号 + `fixFile`（Markdown 文件名，Structured Handoff）               |
-| **输出**       | fixReportFile（Markdown 文件名）                                         |
-| **边界**       | ✅ 可修改代码、提交并推送；⛔ 不发布 GitHub 评论（由 Orchestrator 负责） |
-
-## 前置条件
-
-### Cache 约定（强制）
-
-- 缓存目录固定为 `./.cache/`；交接一律传 `./.cache/<file>`（repo 相对路径），禁止 basename-only（如 `foo.md`）。
-
-### 必需输入
-
-- **PR 编号**：调用者必须在 prompt 中明确提供（如：`请修复 PR #123`）
-- **runId**：调用者必须在 prompt 中提供（必须透传，格式 `<PR>-<ROUND>-<HEAD_SHORT>`，禁止自行生成）
-- **fixFile**：调用者必须在 prompt 中提供问题清单文件路径（repo 相对路径，例：`./.cache/fix-...md`）（Structured Handoff）
-
-### 失败快速退出
-
-如未满足以下任一条件，立即返回错误 JSON 并退出：
-
-- ❌ prompt 未包含 PR 编号 → `{"error":"MISSING_PR_NUMBER"}`
-- ❌ prompt 未包含 fixFile → `{"error":"MISSING_FIX_FILE"}`
-- ❌ fixFile 不存在/不可读 → `{"error":"FIX_FILE_NOT_READABLE"}`
-- ❌ fixFile 无法解析出 issuesToFix → `{"error":"INVALID_FIX_FILE"}`
-
-## 输入格式（Structured Handoff：fixFile，Markdown）
-
-说明：fixFile 由编排器根据 reviewer 的 findings 聚合生成；不要求严格 JSON，但必须包含可解析的字段。
-
-推荐最小格式（稳定、易解析）：
-
-```md
-# Fix File
-
-PR: 123
-Round: 2
-
-## IssuesToFix
-
-- id: CDX-001
-  priority: P1
-  category: quality
-  file: apps/backend/src/foo.ts
-  line: 42
-  title: 未处理的异常
-  description: JSON.parse 可能抛出异常但未被捕获
-  suggestion: 添加 try/catch 并返回一致错误码
-
-## OptionalIssues
-
-- id: GMN-004
-  priority: P3
-  category: suggestion
-  file: apps/front/src/bar.tsx
-  line: null
-  title: 可读性优化
-  description: ...
-  suggestion: ...
-```
-
-解析规则（强制）：
-
-- 仅处理 `## IssuesToFix` 段落里的条目；`## OptionalIssues` 可忽略或按需处理（建议：根据 PR 目标/风险/时间预算自行裁决）
-- 每条必须至少包含：`id`、`priority`、`file`、`title`、`suggestion`
-- `line` 允许为 `null`
-
-## 工作流程
-
-### 1. 读取 fixFile 并标准化
-
-要求：只依赖 prompt 中的 `fixFile`；不要重新拉取/生成评审意见。
-
-- 用 bash 读取 `fixFile`（例如 `cat "$fixFile"`）
-- 解析失败则返回 `INVALID_FIX_FILE`
-
-### 2. 逐项修复（No Scope Creep）
-
-- 仅修复 fixFile 中列出的问题：`IssuesToFix`（必要）与 `OptionalIssues`（可选）
-- 每个修复必须能明确对应到原问题的 `id`
-- 无法修复时必须记录原因（例如：缺少上下文、超出本 PR 范围、需要产品决策、需要数据库迁移等）
-
-### 3. 提交策略
-
-- 强制：每个 findingId 单独一个提交（一个 findingId 对应一个 commit）
-- 每个提交后立即推送到远端（禁止 force push）
-- 约定：如无 upstream，首次用 `git push -u origin HEAD`，后续用 `git push`
-- 所有问题处理完毕后，再执行一次 `git push` 作为兜底
-
-提交信息建议（强制包含 findingId）：
-
-- `fix(pr #<PR_NUMBER>): <FINDING_ID> <title>`
-
-## 修复原则（强制）
-
-- 只修复 `issuesToFix`/`optionalIssues`；禁止顺手重构/格式化/改无关代码
-- 不确定的问题降级为拒绝修复，并写清 `reason`（不要“猜”）
-- 修改尽量小：最小 diff、保持既有风格与约定
-- 修改项目里的json/jsonc文件的时候，使用python脚本进行修改，禁止手动拼接字符串,防止格式错误
-- 修复完成之后，调用 dx lint 和 dx build all 确保编译通过
-
-## 重要约束（强制）
-
-- ⛔ 不要发布评论到 GitHub（不调用 `gh pr comment/review`）
-- ✅ 必须 push（禁止 force push；禁止 rebase）
-- ✅ 必须生成 fixReportFile（Markdown），内容可直接发到 GitHub 评论
-
-## 输出（强制）
-
-写入：`./.cache/fix-report-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-
-最终只输出一行：
-
-`fixReportFile: ./.cache/<file>.md`
-
-
-## Decision Log 输出（强制）
-
-修复完成后，必须生成/追加 Decision Log 文件，用于跨轮次的决策持久化存储。
-
-### 文件路径
-
-`./.cache/decision-log-pr<PR_NUMBER>.md`
-
-### 格式规范
-
-```markdown
-# Decision Log
-
-PR: <PR_NUMBER>
-
-## Round <ROUND>
-
-### Fixed
-
-- id: <FINDING_ID>
-  file: <FILE_PATH>
-  commit: <SHA>
-  essence: <问题本质的一句话描述>
-
-### Rejected
-
-- id: <FINDING_ID>
-  file: <FILE_PATH>
-  priority: <P0|P1|P2|P3>
-  reason: <拒绝原因>
-  essence: <问题本质的一句话描述>
-```
-
-### 追加规则（强制）
-
-- 如果文件不存在：创建新文件，包含 `# Decision Log` 头、`PR: <PR_NUMBER>` 字段，以及第一个 `## Round <ROUND>` 段落
-- 如果文件存在：追加新的 `## Round <ROUND>` 段落到文件末尾
-- **禁止删除或覆盖历史轮次的记录**
-- **file 字段**：必须记录问题所在的文件路径（repo 相对路径）。
-  - 对于 `pr-precheck` 产生的修复，`file` 字段可填 `__precheck__`。
-
-### essence 字段要求
-
-essence 是问题本质的一句话描述，用于后续轮次的智能匹配和重复检测。要求：
-
-- 简洁性：≤ 50 字
-- 问题导向：描述问题核心（而非具体代码位置、文件行号）
-- 可匹配性：后续轮次的 reviewer 能通过关键词匹配识别该问题
-- **文件强绑定**：必须假设问题与当前文件强绑定（若文件重命名，视为不同问题）
-
-**示例对比：**
-
-| ✅ 好的 essence | ❌ 不好的 essence |
-|---|---|
-| "JSON.parse 未捕获异常" | "apps/backend/src/foo.ts 第 42 行缺少 try/catch" |
-| "缺少输入验证" | "在 UserController 中没有验证 username 参数" |
-| "密码明文存储" | "第 156 行 password 字段未加密" |
-
-### Decision Log 的用途
-
-Decision Log 供后续工作流参考：
-
-- **pr-review-loop**：检查 decision-log 是否存在，避免重复提出已拒绝的问题
-- **pr-review-aggregate**：使用 LLM 智能匹配 essence 字段，识别本轮与历史轮的重复问题
-- **交接文档**：跨团队成员阅读，理解历史决策
-
-
-## fixReportFile 内容格式（强制）
-
-fixReportFile 内容必须是可直接粘贴到 GitHub 评论的 Markdown，且不得包含本地缓存文件路径。
-
-```md
-# Fix Report
-
-PR: <PR_NUMBER>
-Round: <ROUND>
-
-## Summary
-
-Fixed: <n>
-Rejected: <n>
-
-## Fixed
-
-- id: <FINDING_ID>
-  commit: <SHA>
-  note: <what changed>
-
-## Rejected
-
-- id: <FINDING_ID>
-  reason: <why>
-```
-
-## Multi-Agent 约束（Contract）
-
-| 约束                 | 说明                                                                        |
-| -------------------- | --------------------------------------------------------------------------- |
-| **Structured Input** | 仅处理 `fixFile` 中的问题；不重新获取评审意见（默认不调用 `gh` 拉取上下文） |
-| **Output**           | 必须生成 fixReportFile（Markdown）                                          |
-| **ID Correlation**   | 每条提交必须能关联到某个 findingId                                          |
-| **No Scope Creep**   | ⛔ 不修复 fixFile 之外的问题，不引入无关变更                                |
-
-## 输出有效性保证
-
-- fixReportFile 必须成功写入
-- stdout 只能输出一行 `fixReportFile: ./.cache/<file>.md`

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

@@ -1,89 +0,0 @@
----
-description: PR precheck (checkout + lint + build)
-mode: subagent
-model: openai/gpt-5.3-codex
-temperature: 0.1
-tools:
-  bash: true
----
-
-# PR Precheck
-
-## Cache 约定（强制）
-
-- 缓存目录固定为 `./.cache/`；交接一律传 `./.cache/<file>`（repo 相对路径），禁止 basename-only（如 `foo.md`）。
-
-## 输入（prompt 必须包含）
-
-- `PR #<number>`
-- `round: <number>`（默认 1）
-
-## 一键脚本
-
-脚本位置：`~/.opencode/agents/pr_precheck.py`
-
-```bash
-python3 ~/.opencode/agents/pr_precheck.py --pr <PR_NUMBER> --round <ROUND>
-```
-
-## 脚本输出处理（强制）
-
-- 脚本 stdout 只会输出**单一一行 JSON**（可 `JSON.parse()`）。
-- **成功时**：你的最终输出必须是**脚本 stdout 的那一行 JSON 原样内容**。
-  - 典型返回：`{"ok":true}` 或 `{"ok":false,"fixFile":"..."}`
-  - **重要**：如果返回 `fixFile`，请使用基于 `headOid` 的标准 runId（`<PR>-<ROUND>-<HEAD_SHORT>`）来命名文件。
-  - 禁止：解释/分析/补充文字
-  - 禁止：代码块（```）
-  - 禁止：前后空行
-- **失败/异常时**：
-  - 若脚本 stdout 已输出合法 JSON（包含 `error` 或其他字段）→ 仍然**原样返回该 JSON**。
-  - 若脚本未输出合法 JSON / 退出异常 → 仅输出一行 JSON：`{"error":"PR_PRECHECK_AGENT_FAILED"}`（必要时可加 `detail` 字段）。
-
-## GitHub 认证校验（重要）
-
-脚本会在执行 `gh pr view/checkout` 之前校验 GitHub CLI 已认证。
-
-- 为了避免 `gh auth status` 在“其他 host（例如 enterprise）认证异常”时误判，脚本会优先从 `git remote origin` 推断 host，并使用：
-  - `gh auth status --hostname <host>`
-- 推断失败时默认使用 `github.com`。
-
-可能出现的错误：
-
-- `{"error":"GH_CLI_NOT_FOUND"}`：找不到 `gh` 命令（PATH 内未安装/不可执行）
-  - 处理：安装 GitHub CLI：https://cli.github.com/
-- `{"error":"GH_NOT_AUTHENTICATED"}`：当前 repo 的 host 未认证
-  - 处理：`gh auth login --hostname <host>`
-
-本地排查命令（在同一个 shell 环境运行）：
-
-```bash
-git remote get-url origin
-gh auth status
-gh auth status --hostname github.com
-env | grep '^GH_'
-```
-
-## 仅当出现 merge 冲突时怎么处理
-
-当脚本输出 `{"error":"PR_MERGE_CONFLICTS_UNRESOLVED"}` 时：
-
-```bash
-# 1) 获取 base 分支名
-gh pr view <PR_NUMBER> --json baseRefName --jq .baseRefName
-
-# 2) 拉取 base 并合并到当前 PR 分支（不 rebase、不 force push）
-git fetch origin <baseRefName>
-git merge --no-ff --no-commit origin/<baseRefName>
-
-# 3) 解决冲突后确认无未解决文件
-git diff --name-only --diff-filter=U
-git grep -n '<<<<<<< ' -- .
-
-# 4) 提交并推送
-git add -A
-git commit -m "chore(pr #<PR_NUMBER>): resolve merge conflicts"
-git push
-
-# 5) 重新运行预检脚本
-python3 ~/.opencode/agents/pr_precheck.py --pr <PR_NUMBER> --round <ROUND>
-```