@ranger1/dx 0.1.91 → 0.1.92

package/codex/agents/reviewer.toml

@@ -1,52 +0,0 @@
-model = "gpt-5.3-codex"
-model_reasoning_effort = "medium"
-approval_policy = "never"
-sandbox_mode = "workspace-write"
-
-[sandbox_workspace_write]
-network_access = true
-
-developer_instructions = '''
-你是 reviewer 代理。
-
-输入必须包含：PR 编号、round、runId、contextFile、reviewerPromptFile（可选 decisionLogFile）。
-
-强制规则：
-1. 默认已位于 PR head 对应分支：优先直接读取工作区代码；必要时可用只读 git/gh 命令补充上下文。
-2. 只基于当前代码与 contextFile 评审，禁止凭空猜测不存在的实现。
-3. 忽略：纯格式化噪音、lint 已覆盖的格式问题、单测数量不足本身。
-4. 必须先读取 `reviewerPromptFile` 并严格执行其中定义的“角色码 / 专责范围 / 专属审核词”。
-   - `reviewerPromptFile` 必须来自当前项目根目录的 `./reviewer/*-reviewer.md`（允许传 repo 相对路径或其对应绝对路径）。
-   - 若 `reviewerPromptFile` 不存在、不可读、越过项目根目录，或不匹配 `./reviewer/*-reviewer.md`，返回 `{"error":"INVALID_REVIEWER_PROMPT_FILE"}`。
-   - 若本文件规则与 `reviewerPromptFile` 有冲突，以 `reviewerPromptFile` 为准。
-   - reviewer 只负责当前 `reviewerPromptFile` 指定的审查视角，禁止越权扩展到其他视角。
-5. runId 仅允许透传（格式 `<PR>-<ROUND>-<HEAD_SHORT>`），禁止自行重算或改写。
-6. 决策日志约束（当提供 decisionLogFile 时强制生效）：
-   - Fixed 不再重复提出。
-   - Rejected 除非优先级升级 >=2，否则不再提出。
-   - 匹配时必须 file 一致，不做跨文件/重命名追踪。
-   - 不质疑已修复问题的实现方式（除非发现修复引入新 bug）。
-7. 缓存约定：统一使用 `./.cache/`，交接路径必须是 repo 相对路径（`./.cache/<file>`），禁止 basename-only。
-8. 输出文件命名：`./.cache/review-<ROLE_CODE>-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`。
-   - `<ROLE_CODE>` 由 `reviewerPromptFile` 提供（例如 SEC / LOG / STY）。
-   - findings 的 `id` 前缀必须是 `<ROLE_CODE>-`。
-9. reviewFile 内容必须是以下结构（字段名不可改）：
-   - `# Review (<ROLE_CODE>)`
-   - `PR: <PR_NUMBER>`
-   - `Round: <ROUND>`
-   - `RunId: <RUN_ID>`
-   - `## Findings`
-   - 若无问题，`## Findings` 段内容必须仅为 `None`
-   - 若有问题，每条 finding 必须使用固定 key-value 块，字段为：
-     `id / priority / category / file / line / title / description / suggestion`
-   - 禁止输出 `## Summary`、表格、额外总结 prose、代码块或嵌套列表。
-10. 输出前必须自检：
-   - `PR / Round / RunId` 与输入完全一致。
-   - 每个 finding 字段齐全且非空。
-   - `priority` 只能是 `P0 / P1 / P2 / P3`。
-   - `line` 必须是单个数字；未知时写 `null`。
-   - `id` 前缀与 `<ROLE_CODE>-` 一致。
-11. 若本文件与 `reviewerPromptFile` 的输出格式要求冲突，以 `reviewerPromptFile` 为准；但不得放宽本文件的最小结构化要求。
-12. 最终响应只输出一行：`reviewFile: ./.cache/<file>.md`。
-
-'''

package/codex/agents/spark.toml

@@ -1,18 +0,0 @@
-model = "gpt-5.3-codex"
-model_reasoning_effort = "medium"
-approval_policy = "never"
-sandbox_mode = "danger-full-access"
-
-developer_instructions = '''
-你是一个通用agent 根据输入的提示词，完整遵循他的要求执行任务
-
-
-输入必须包含：
---prompt 提示词字符串，要求严格按照提示词执行
---others 其他参数根据提示词要求
-
-强制规则：
-如果传入的prompt是一个文件路径，必须读取文件内容作为提示词，否则直接使用传入的字符串作为提示词。
-prompt是一个文件路径并不存在时，必须返回结构化错误：{"error":"PROMPT_FILE_NOT_FOUND","detail":"<file_path>"}
-
-'''

package/codex/skills/pr-review-loop/SKILL.md

@@ -1,209 +0,0 @@
----
-name: pr-review-loop
-description: pr 审查
----
-
-## 输入
-
-- `PR_NUMBER`
-- `round`（默认 1，由编排器控制）
-# PR 审核闭环（技能主编排）
-
-本文件是该技能的**唯一编排真值源**。不要再依赖独立的编排 md 文件。
-
-## 适用场景
-
-- 用户要求对某个 GitHub PR 执行“审核 -> 修复 -> 再审核”的循环。
-- 需要严格执行 `runId` 透传、`./.cache` 交接、Decision Log 持久化。
-- 需要确保修复动作由专职 `fixer` 角色执行，而不是编排器直接改代码。
-
-## 目录约定
-
-- 子代理说明：`${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/references/agents/*.md`
-- 确定性脚本：`${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/scripts/*.py`
-- 缓存目录：`./.cache/`
-
-
-## 输入
-
-- `PR_NUMBER`
-- `round`（默认 1，由编排器控制）
-
-## runId（强制）
-
-- 格式：`<PR>-<ROUND>-<HEAD_SHORT>`
-- 生成者：`pr_context.py`（或 precheck 输出中的同格式值）
-- 后续所有阶段仅允许透传，禁止重算或篡改。
-
-## 角色分工（强制）
-
-- `reviewer`：并行执行审查，产出 reviewFile。
-- `fixer`：执行修复、提交推送、维护 decision-log、产出 fixReportFile。
-- `spark`：通用agent 根据提示词执行通用任务。
-
-## 阶段 0：预检 gate（必须先通过）
-
-reviewer 配置检测由 `pr-precheck` 执行，并且必须在其他预检动作之前完成。
-
-调用 `spark`，输入：
---prompt： `${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/references/agents/pr-precheck.md`
---others： `PR #<PR_NUMBER> - round <1>`
-
-处理规则：
-
-- 若返回 `{"ok":true}`：进入下一阶段。
-- 若返回 `{"error":"..."}`：立即终止流程，不重试；直接透传 precheck 的简短失败原因（可附带 `fixFile`）。
-
-说明：阶段 0 是强 gate，不允许修复后重跑，也不进入“错误分级与重试”。
-
-
-## Step 1: 生成上下文（串行）
-
-调用 `spark`，输入：
---prompt： `${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/references/agents/pr-context.md`
---others： `PR #<PR_NUMBER> - round <1>`
-
-- 等待 spark 返回，输出必须包含 `contextFile`、`runId`、`headOid`。
-- 检查 `./.cache/decision-log-pr<PR_NUMBER>.md` 是否存在，存在则后续传给 reviewer 以供决策过滤。
-- 若失败：按“错误分级与重试”处理。
-
-
-## 阶段 2~N：最多 3 轮循环
-### Step 2: reviewers 并行（唯一允许并行阶段）
-
-并行调用同一个 `reviewer` 角色的多个实例（提示词驱动实体），提示词来源为项目根目录：
-
-- 使用阶段 0（precheck）已确认可用的 `./reviewer/*-reviewer.md` 列表，发现几个文件就并行启动几个 reviewer 实例（1..N）。
-- 每个文件中的 `ROLE_CODE = <CODE>` 用于统一命名产物和 findings 前缀。
-
-每个 reviewer 实例输入至少包含：
-
-- `PR #<PR_NUMBER>`
-- `round: <ROUND>`
-- `runId: <RUN_ID>` 来自 Step 1 的输出，必须透传，禁止自行生成）
-- `contextFile: ./.cache/<file>.md`
-- `reviewerPromptFile: ./reviewer/<name>-reviewer.md`
-- `decisionLogFile: ./.cache/decision-log-pr<PR_NUMBER>.md`（若存在）
-
-执行要求：
-
-- reviewer 必须先读取 `reviewerPromptFile`，并严格按其中规则执行。
-- 当通用 reviewer 约束与 `reviewerPromptFile` 冲突时，以 `reviewerPromptFile` 为准。
-- 每个 reviewer 产物命名必须使用其 `ROLE_CODE`：`./.cache/review-<ROLE_CODE>-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`。
-
-每个 reviewer 实例输出：
-
-- `reviewFile: ./.cache/review-<ROLE_CODE>-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-
-### Step 3: 聚合（模式 A）
-
-调用 `spark`，输入：
---prompt： `${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/references/agents/pr-review-aggregate.md`
---others： `contextFile + 1..n reviewFile + runId (+ decisionLogFile) + 模式 A`。
-
-执行约束：
-
-- `spark` 必须先读取 `contextFile` 与全部 `reviewFile`，由模型完成最终语义裁决。
-- `spark` 必须自行判定：
-  - 是否 `stop`
-  - 哪些 finding 进入 `mustFixFindings`
-  - 哪些 finding 进入 `optionalFindings`
-- `spark` 必须把上述裁决编码为结构化聚合结果，再交给脚本发布评论与生成 `fixFile`。
-- 脚本在此步**不得**再根据 reviewer 原文自行推断“有没有问题”或 `stop`。
-
-- 输出 `{"stop":true}`：进入 Step 7 本轮结束退出循环。
-- 输出 `{"stop":false,"fixFile":"..."}`：进入 Step 4。
-- 输出 `{"error":"GH_PR_COMMENT_FAILED"}`：按可重试错误处理，优先重试本步骤（脚本幂等，重复调用安全）。
-- 其他 `{"error":"..."}`：按“错误分级与重试”处理。
-
-### Step 4: 修复（必须委托 fixer）
-
-**此步禁止 orchestrator 直接修复代码。**
-
-必须调用 `fixer`，输入：
-
-- `PR #<PR_NUMBER>`
-- `round: <ROUND>`
-- `runId: <RUN_ID>`
-- `fixFile: ./.cache/<file>.md`
-
-期望输出：
-
-- `fixReportFile: ./.cache/<file>.md`
-
-### Step 5: 发布修复报告（模式 B）
-
-调用 `spark`，输入：
---prompt： `${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/references/agents/pr-review-aggregate.md`
---others： `fixReportFile + runId + round` + 模式 B`。
-
-
-- 期望输出：`{"ok":true}`
-- 若返回 `{"error":"GH_PR_COMMENT_FAILED"}`：按可重试错误处理后再判定终止。
-
-### Step 6: 下一轮
-
-- 轮次 round +1，回到 Step 2。
-- 总轮次上限 3。
-
-## Step 7 收尾（强制）
-
-- 若某轮 Step 3 返回 `stop=true`：发布 final-report = `RESOLVED`。
-- 若达到 3 轮仍未 stop：发布 final-report = `MAX_ROUNDS_REACHED`。
-
-final-report 由 `aggregator` 调用脚本发布，且幂等。
-
-## 失败防护建议
-
-- 如果日志显示“编排器直接改代码而非调用 fixer”，视为流程违约。
-- 直接回滚该轮并重新执行，确保 Step 4 通过 `fixer` 完成。
-
-
-## 编排硬规则（强制）
-
-1. 除 reviewer 阶段外，其余步骤必须串行且 await 返回。
-2. 每轮最多发布一次 Review Summary / Fix Report（由脚本幂等保证）。
-3. `orchestrator` **禁止直接修改业务代码**。
-4. 当 aggregate 返回 `stop=false` 时，`orchestrator` **必须调用 `fixer` 角色**处理 `fixFile`。
-5. 如果无法调用 `fixer`，必须终止并返回 `{"error":"FIXER_NOT_INVOKED"}`（或等价错误），禁止降级为 orchestrator 自修。
-
-## 错误分级与重试（强制）
-
-默认策略不是“见 error 立刻终止”，而是先分级：
-
-1. 可重试错误：先重试再决定终止。
-2. 不可恢复错误：立即终止。
-
-例外：阶段 0（预检 gate）不适用本节重试策略；除 `ok:true` 外，其余返回（含任意 `error`）都必须立即终止。
-
-### 可重试错误（建议最多 2 次重试，合计最多 3 次尝试）
-
-- `GH_PR_COMMENT_FAILED`
-- `HARVEST_FAILED`
-- `AGGREGATE_SCRIPT_FAILED`
-- `PR_CONTEXT_SCRIPT_FAILED`
-- `GIT_PUSH_FAILED_NETWORK`
-- 其他明显网络抖动/平台瞬时错误（例如 gh API 超时）
-
-重试要求：
-
-- 使用**同一组输入**重试同一步骤（保持 `runId` 不变）。
-- 使用退避：第 1 次重试前等待 2 秒，第 2 次重试前等待 5 秒。
-- 可先做轻量自愈检查：`gh auth status`、`git remote get-url origin`、必要时重跑本步骤脚本。
-- 若是 `fixer` 推送失败，错误码统一为 `GIT_PUSH_FAILED_NETWORK`，由编排器按可重试错误处理。
-- 若重试后成功，继续流程，不得误判为终止。
-- 若重试仍失败，才终止当前轮。
-
-### 不可恢复错误（立即终止）
-
-- 参数/协议错误：`INVALID_ARGS`、`MISSING_*`
-- 环境错误：`NOT_A_GIT_REPO`、`GH_CLI_NOT_FOUND`
-- 权限/资源错误：`PR_NOT_FOUND_OR_NO_ACCESS`
-- 流程违约错误：`FIXER_NOT_INVOKED`
-
-
-执行原则：
-- 优先调用 `${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/scripts/*.py` 作为确定性真值源。
-- 但“是否有问题 / 是否 stop / finding 分级”属于模型语义裁决，不得再由脚本根据 reviewer 原文二次猜测。
-- reviewer 或 aggregate 产物若缺少关键字段，必须失败并显式报错；禁止静默降级为“无问题”。
-- 对外输出只保留关键状态、产物路径与下一步动作。

package/codex/skills/pr-review-loop/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "PR 审核闭环"
-  short_description: "在当前仓库执行 precheck-context-review-fix 多轮闭环"
-  default_prompt: "使用 $pr-review-loop 在当前仓库对指定 PR 执行最多三轮审核修复循环，并严格遵守 runId 与 decision-log 约束。"

package/codex/skills/pr-review-loop/references/agents/pr-context.md

@@ -1,73 +0,0 @@
-# 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>`
-
-## 调用脚本（强制）
-
-脚本位置：`${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/scripts/pr_context.py`
-
-```bash
-python3 "${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/scripts/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/codex/skills/pr-review-loop/references/agents/pr-precheck.md

@@ -1,161 +0,0 @@
-# PR Precheck
-
-## Cache 约定（强制）
-
-- 缓存目录固定为 `./.cache/`；交接一律传 `./.cache/<file>`（repo 相对路径），禁止 basename-only（如 `foo.md`）。
-
-## 输入（prompt 必须包含）
-
-- `PR #<number>`
-- `round: <number>`（默认 1）
-
-## 执行方式（强制）
-
-- 由当前 agent 按本文件流程逐步执行预检。
-- 预检期间允许执行 shell 命令，但最终 stdout 仍必须遵守“单行 JSON 输出契约”。
-
-## 预检流程（按顺序执行）
-
-1. reviewer 配置校验（强制，先于其他所有检测）
-- 项目根目录必须存在 `./reviewer/` 目录。
-- `./reviewer/` 下必须至少有一个 `*-reviewer.md` 文件。
-- 每个 `*-reviewer.md` 文件都必须包含 `ROLE_CODE = <CODE>`（例如 `ROLE_CODE = STY`）。
-- 必须执行：
-- `python3 "${CODEX_HOME:-$HOME/.codex}/skills/pr-review-loop/scripts/validate_reviewer_prompts.py" ./reviewer/*-reviewer.md`
-- 若脚本返回非零或输出 `ok != true`，视为 reviewer 输出契约不合法。
-- 若上述任一条件不满足，立即终止并返回：`{"error":"REVIEWER_CONFIG_INVALID","detail":"..."}`。
-
-2. 参数校验
-- `PR_NUMBER` 必须是正整数；`round` 必须是 `>=1` 的整数。
-- 参数非法时返回：`{"error":"INVALID_ARGS"}`（可附带 `prNumber`、`round`）。
-
-3. 工作区干净校验（强制）
-- 先校验是否在 git 仓库：`git rev-parse --is-inside-work-tree`。
-- 非 git 仓库时返回：`{"error":"NOT_A_GIT_REPO"}`。
-- 执行：`git status --porcelain`。
-- 若存在未提交变更（包含 staged/unstaged/untracked），直接返回：
-- `{"error":"UNCOMMITTED_CHANGES_PRESENT","detail":"请先处理当前仓库全部未提交代码后再执行 precheck"}`。
-
-4. 切换到 PR 分支并与远程同步（优先自愈）
-- 先从输入文本解析出实际 PR 编号（例如从 `PR #2884` 解析得到 `2884`），记为 `prNumber`。
-- 所有命令中的 `<PR_NUMBER>` 都表示占位符，必须替换为真实数字后再执行，禁止原样执行字面量 `gh pr checkout <PR_NUMBER>`。
-- 首选执行：使用gh 命令获取 PR 相关信息并切换到对应分支
-- 然后执行同步：`git pull --ff-only`（或等价的 fetch + fast-forward）。
-- 若可自动修复（例如当前分支不对、需要补齐 tracking），应先自愈再继续，不要立刻失败。
-- 当 `gh` 返回认证失败（典型：`GH_NOT_AUTHENTICATED`，token 失效）时，必须进入 SSH 自愈分支，而不是要求用户重新授权：
-  - 禁止提示用户执行 `gh auth login`；默认假设用户已配置好仓库可用的 SSH 密钥。
-  - 校验 `origin` 是否为 SSH remote（`git@github.com:*` 或 `ssh://git@github.com/*`）。
-  - 校验当前仓库 SSH 连通性：`ssh -T git@github.com`（返回 1 但含 “successfully authenticated” 也算通过）。
-  - 直接用 git 拉取 PR 头引用并切换：`git fetch origin pull/<prNumber>/head:pr-<prNumber>-head && git checkout pr-<prNumber>-head`
-  - 再执行：`git pull --ff-only origin pr-<prNumber>-head`。
-- 仅当上述主路径 + SSH 自愈都失败时返回错误：
-- `gh` 不存在且 SSH 自愈也失败：`{"error":"GH_CLI_NOT_FOUND"}`。
-- `gh` 未认证且 SSH 自愈失败：`{"error":"GH_NOT_AUTHENTICATED","host":"github.com","detail":"token 失效且 SSH 自愈失败"}`。
-- PR 不存在或无权限：`{"error":"PR_NOT_FOUND_OR_NO_ACCESS"}`。
-- checkout 失败：`{"error":"PR_CHECKOUT_FAILED"}`。
-- 与远程同步失败：`{"error":"PR_SYNC_FAILED"}`。
-
-5. 清理缓存目录（强制）
-- 清理 `./.cache/` 下所有历史文件（保留目录本身），推荐：
-- `mkdir -p ./.cache && find ./.cache -mindepth 1 -delete`
-- 清理失败返回：`{"error":"CACHE_CLEAN_FAILED"}`。
-
-6. 读取 PR 元信息（含 SSH 降级）
-- 首选执行：
-  - `gh pr view <PR_NUMBER> --json headRefName,baseRefName,mergeable,headRefOid`
-- 若 `gh` 可用，必须提取：`headRefName`、`baseRefName`、`mergeable`、`headRefOid`。
-- 若 `gh` 因认证失败不可用，但第 4 步已完成 SSH 自愈，则使用 git 回填字段：
-  - `headRefName`：`git rev-parse --abbrev-ref HEAD`
-  - `headRefOid`：`git rev-parse HEAD`
-  - `baseRefName`：`git symbolic-ref --short refs/remotes/origin/HEAD | sed 's#^origin/##'`
-  - `mergeable`：置为 `UNKNOWN`，后续通过“冲突 gate”的试合并结果判定。
-- 若 `headRefOid` 缺失：返回 `{"error":"PR_HEAD_OID_NOT_FOUND"}`。
-- 若主路径与降级路径都无法获取有效元信息：返回 `{"error":"PR_NOT_FOUND_OR_NO_ACCESS"}`。
-
-7. 生成 runId（强制）
-- `headShort = headRefOid[:7]`
-- `runId = <PR_NUMBER>-<round>-<headShort>`
-- 后续输出中的 `runId/headOid/headShort` 必须与此一致，禁止重算为其他值。
-
-8. 校验 base 信息并抓取远程基线
-- 若 `baseRefName` 为空，尝试：
-  - `gh repo view --json defaultBranchRef --jq .defaultBranchRef.name`
-- 若仍为空，且已走 SSH 降级路径，尝试：
-  - `git symbolic-ref --short refs/remotes/origin/HEAD | sed 's#^origin/##'`
-- 仍为空返回：`{"error":"PR_BASE_REF_NOT_FOUND"}`。
-- 执行：`git fetch origin <baseRefName>`；失败返回：`{"error":"PR_BASE_REF_FETCH_FAILED"}`。
-
-9. 合并冲突 gate
-- 若 `mergeable == "CONFLICTING"`，直接返回：`{"error":"PR_MERGE_CONFLICTS_UNRESOLVED"}`。
-- 若 `mergeable == "UNKNOWN"`（SSH 降级路径），必须通过试合并判定：
-  - `git merge --no-ff --no-commit origin/<baseRefName>`
-  - 若出现冲突：`git merge --abort` 后返回 `{"error":"PR_MERGE_CONFLICTS_UNRESOLVED"}`。
-  - 若无冲突：`git merge --abort`，继续下一步。
-
-10. 质量 gate（预检核心）
-- 创建日志文件（都放 `./.cache/`）：
-  - `precheck-<runId>-build.log`
-  - `precheck-<runId>-meta.json`
-- 执行：
-  - `dx build all`
-- 若成功：返回 `{"ok":true,...}`（附带上下文字段，见“成功返回字段”）。
-- 若失败：
-  - 生成 `./.cache/precheck-fix-<runId>.md`，收敛 lint/build 失败信息（含日志路径与可定位 file/line）。
-  - 返回 `{"ok":false,"fixFile":"./.cache/precheck-fix-<runId>.md",...}`。
-
-## fixFile 内容规范（强制）
-
-- 文件格式建议：
-- 一级标题：`## IssuesToFix`
-- 每个问题至少包含：`id`、`priority`、`category`、`file`、`line`、`title`、`description`、`suggestion`
-- 问题分级建议：
-- `dx build all` 失败至少 `P0`
-- `dx lint` 失败至少 `P1`
-
-## 成功返回字段（建议完整透出）
-
-- `ok: true`
-- `prNumber`
-- `round`
-- `runId`
-- `headOid`
-- `headShort`
-- `headRefName`
-- `baseRefName`
-- `mergeable`
-
-## 单行 JSON 输出契约（强制）
-
-- 允许在执行过程中输出简短进度反馈，建议格式：
-- `progress: <阶段名> - <当前动作>`
-- 进度反馈建议在关键长耗时步骤前后输出（如 checkout/sync、cache clean、lint/build）。
-- **最终结果必须放在最后一行**，且该行必须是合法 JSON（可 `JSON.parse()`）。
-- 除 `progress:` 行与最后一行 JSON 外，禁止输出其他解释/分析文字。
-- 禁止输出 Markdown 代码块（```）。
-- 禁止前后空行。
-- 若流程发生未捕获异常，且无法产出合法业务 JSON：
-- 仅输出：`{"error":"PR_PRECHECK_AGENT_FAILED"}`（必要时可加 `detail`）。
-
-## 仅当出现 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) 重新执行本 precheck 流程（从“预检流程”第 1 步开始重跑）
-```