@ranger1/dx 0.1.17 → 0.1.18

package/@opencode/commands/doctor.md

@@ -48,8 +48,9 @@ echo "opencode-openai-codex-auth:" && (grep -q 'opencode-openai-codex-auth' ~/.c
 # 批次 4: oh-my-opencode.json 配置检测
 echo "=== OMO_CONFIG ===";
 echo "sisyphus_agent:" && (grep -q '"sisyphus_agent"' ~/.config/opencode/oh-my-opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
-echo "categories.quick:" && (grep -q '"quick"' ~/.config/opencode/oh-my-opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
-echo "categories.middle:" && (grep -q '"middle"' ~/.config/opencode/oh-my-opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
+echo "agents.sisyphus.variant:" && (node -e "const fs=require('node:fs');const os=require('node:os');const p=os.homedir()+'/.config/opencode/oh-my-opencode.json';try{const j=JSON.parse(fs.readFileSync(p,'utf8'));process.exit(j?.agents?.sisyphus?.variant==='none'?0:1)}catch(e){process.exit(1)}" 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
+echo "agents.quick:" && (grep -Eq '"agents"[[:space:]]*:' ~/.config/opencode/opencode.json 2>/dev/null && grep -Eq '"quick"[[:space:]]*:' ~/.config/opencode/opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
+echo "agents.middle:" && (grep -Eq '"agents"[[:space:]]*:' ~/.config/opencode/opencode.json 2>/dev/null && grep -Eq '"middle"[[:space:]]*:' ~/.config/opencode/opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
 ```
 
 ---
@@ -69,8 +70,9 @@ oh-my-opencode                 | <状态>   | -
 opencode-openai-codex-auth     | <状态>   | -
 agent-browser                  | <状态>   | <版本>
 sisyphus_agent 配置            | <状态>   | -
-categories.quick 配置          | <状态>   | -
-categories.middle 配置         | <状态>   | -
+agents.sisyphus.variant 配置    | <状态>   | -
+agents.quick 配置              | <状态>   | -
+agents.middle 配置             | <状态>   | -
 ```
 
 ---
@@ -185,13 +187,37 @@ cat ~/.config/opencode/oh-my-opencode.json
 
 注意：这是根节点配置，应添加到 JSON 的第一层级。
 
-#### 3.7.2 categories.quick 或 categories.middle 缺失
+#### 3.7.2 agents.sisyphus.variant 不是 none
 
-如果 `categories` 节点缺少 `quick` 或 `middle`，使用 Edit 工具添加：
+如果 `~/.config/opencode/oh-my-opencode.json` 的 `agents.sisyphus.variant` 缺失或不是 `none`，使用 Edit 工具修复为：
 
 ```json
 {
-  "categories": {
+  "agents": {
+    "sisyphus": {
+      "variant": "none"
+    }
+  }
+}
+```
+
+3. 验证配置：
+
+```bash
+# 检查 sisyphus_agent
+grep -q '"sisyphus_agent"' ~/.config/opencode/oh-my-opencode.json && echo "✅ sisyphus_agent 已配置" || echo "❌ sisyphus_agent 缺失"
+
+# 检查 agents.sisyphus.variant
+node -e "const fs=require('node:fs');const os=require('node:os');const p=os.homedir()+'/.config/opencode/oh-my-opencode.json';const j=JSON.parse(fs.readFileSync(p,'utf8'));console.log(j?.agents?.sisyphus?.variant||'MISSING');process.exit(j?.agents?.sisyphus?.variant==='none'?0:1)" && echo "✅ agents.sisyphus.variant=none" || echo "❌ agents.sisyphus.variant 不是 none"
+```
+
+### 3.8 opencode.json agents 配置缺失
+
+如果 `~/.config/opencode/opencode.json` 缺少 `agents.quick` 或 `agents.middle`，使用 Edit 工具添加：
+
+```json
+{
+  "agents": {
     "quick": {
       "model": "github-copilot/claude-haiku-4.5"
     },
@@ -202,17 +228,14 @@ cat ~/.config/opencode/oh-my-opencode.json
 }
 ```
 
-3. 验证配置：
+验证配置：
 
 ```bash
-# 检查 sisyphus_agent
-grep -q '"sisyphus_agent"' ~/.config/opencode/oh-my-opencode.json && echo "✅ sisyphus_agent 已配置" || echo "❌ sisyphus_agent 缺失"
-
-# 检查 categories.quick
-grep -q '"quick"' ~/.config/opencode/oh-my-opencode.json && echo "✅ quick 已配置" || echo "❌ quick 缺失"
+# 检查 agents.quick
+grep -Eq '"agents"[[:space:]]*:' ~/.config/opencode/opencode.json && grep -Eq '"quick"[[:space:]]*:' ~/.config/opencode/opencode.json && echo "✅ agents.quick 已配置" || echo "❌ agents.quick 缺失"
 
-# 检查 categories.middle
-grep -q '"middle"' ~/.config/opencode/oh-my-opencode.json && echo "✅ middle 已配置" || echo "❌ middle 缺失"
+# 检查 agents.middle
+grep -Eq '"agents"[[:space:]]*:' ~/.config/opencode/opencode.json && grep -Eq '"middle"[[:space:]]*:' ~/.config/opencode/opencode.json && echo "✅ agents.middle 已配置" || echo "❌ agents.middle 缺失"
 ```
 
 ---

package/lib/opencode-initial.js

@@ -59,8 +59,7 @@ async function copyMarkdownTree({ srcDir, dstDir }) {
 }
 
 function resolveTemplateRoot(packageRoot) {
-  const candidates = [join(packageRoot, '@opencode'), join(packageRoot, 'opencode')]
-  return candidates
+  return [join(packageRoot, '@opencode')]
 }
 
 export async function runOpenCodeInitial(options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranger1/dx",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -19,7 +19,6 @@
     "bin/",
     "lib/",
     "@opencode/",
-    "opencode/",
     "LICENSE",
     "README.md",
     "package.json"

package/opencode/agents/claude-reviewer.md

@@ -1,57 +0,0 @@
----
-description: review (Claude)
-mode: subagent
-model: github-copilot/claude-sonnet-4.5
-tools:
-  write: true
-  edit: false
-  bash: true
----
-
-# PR Reviewer (Claude)
-
-## 输入（prompt 必须包含）
-
-- `PR #<number>`
-- `round: <number>`
-- `contextFile: <path>`
-
-## 输出（强制）
-
-只输出一行：
-
-`reviewFile: <path>`
-
-## 规则
-
-- 默认已在 PR head 分支（可直接读工作区代码）
-- 可用 `git`/`gh` 只读命令获取 diff/上下文
-- 写入 reviewFile：`~/.opencode/cache/review-CLD-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-- findings id 必须以 `CLD-` 开头
-
-## reviewFile 格式（强制）
-
-```md
-# Review (CLD)
-
-PR: <PR_NUMBER>
-Round: <ROUND>
-
-## Summary
-
-P0: <n>
-P1: <n>
-P2: <n>
-P3: <n>
-
-## Findings
-
-- id: CLD-001
-  priority: P1
-  category: quality|performance|security|architecture
-  file: <path>
-  line: <number|null>
-  title: <short>
-  description: <text>
-  suggestion: <text>
-```

package/opencode/agents/codex-reviewer.md

@@ -1,58 +0,0 @@
----
-description: review (Codex)
-mode: subagent
-model: openai/gpt-5.2-codex
-temperature: 0.1
-tools:
-  write: true
-  edit: false
-  bash: true
----
-
-# PR Reviewer (Codex)
-
-## 输入（prompt 必须包含）
-
-- `PR #<number>`
-- `round: <number>`
-- `contextFile: <path>`
-
-## 输出（强制）
-
-只输出一行：
-
-`reviewFile: <path>`
-
-## 规则
-
-- 默认已在 PR head 分支（可直接读工作区代码）
-- 可用 `git`/`gh` 只读命令获取 diff/上下文
-- 写入 reviewFile：`~/.opencode/cache/review-CDX-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-- findings id 必须以 `CDX-` 开头
-
-## reviewFile 格式（强制）
-
-```md
-# Review (CDX)
-
-PR: <PR_NUMBER>
-Round: <ROUND>
-
-## Summary
-
-P0: <n>
-P1: <n>
-P2: <n>
-P3: <n>
-
-## Findings
-
-- id: CDX-001
-  priority: P1
-  category: quality|performance|security|architecture
-  file: <path>
-  line: <number|null>
-  title: <short>
-  description: <text>
-  suggestion: <text>
-```

package/opencode/agents/gemini-reviewer.md

@@ -1,57 +0,0 @@
----
-description: review (Gemini)
-mode: subagent
-model: github-copilot/gemini-3-pro-preview
-tools:
-  write: true
-  edit: false
-  bash: true
----
-
-# PR Reviewer (Gemini)
-
-## 输入（prompt 必须包含）
-
-- `PR #<number>`
-- `round: <number>`
-- `contextFile: <path>`
-
-## 输出（强制）
-
-只输出一行：
-
-`reviewFile: <path>`
-
-## 规则
-
-- 默认已在 PR head 分支（可直接读工作区代码）
-- 可用 `git`/`gh` 只读命令获取 diff/上下文
-- 写入 reviewFile：`~/.opencode/cache/review-GMN-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-- findings id 必须以 `GMN-` 开头
-
-## reviewFile 格式（强制）
-
-```md
-# Review (GMN)
-
-PR: <PR_NUMBER>
-Round: <ROUND>
-
-## Summary
-
-P0: <n>
-P1: <n>
-P2: <n>
-P3: <n>
-
-## Findings
-
-- id: GMN-001
-  priority: P1
-  category: quality|performance|security|architecture
-  file: <path>
-  line: <number|null>
-  title: <short>
-  description: <text>
-  suggestion: <text>
-```

package/opencode/agents/pr-context.md

@@ -1,195 +0,0 @@
----
-description: build PR context file
-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 对象”，只包含文件路径等元信息
-
-## 输入要求（强制）
-
-调用者必须在 prompt 中明确提供：
-
-- 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()` 解析。
-
-```ts
-type PRContextBuildResult = {
-  agent: 'pr-context'
-  prNumber: number
-  round: number
-  runId: string
-  repo: { nameWithOwner: string }
-  headOid: string
-  existingMarkerCount?: number
-  contextFile: string
-}
-```
-
-## 生成规则（强制）
-
-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：
-
-```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
-```

package/opencode/agents/pr-fix.md

@@ -1,173 +0,0 @@
----
-description: PR fix review
-mode: subagent
-model: openai/gpt-5.2-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 负责） |
-
-## 前置条件
-
-### 必需输入
-
-- **PR 编号**：调用者必须在 prompt 中明确提供（如：`请修复 PR #123`）
-- **fixFile**：调用者必须在 prompt 中提供问题清单文件路径（Markdown，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` 可忽略或按需处理
-- 每条必须至少包含：`id`、`priority`、`file`、`title`、`suggestion`
-- `line` 允许为 `null`
-
-## 工作流程
-
-### 1. 读取 fixFile 并标准化
-
-要求：只依赖 prompt 中的 `fixFile`；不要重新拉取/生成评审意见。
-
-- 用 bash 读取 `fixFile`（例如 `cat "$fixFile"`）
-- 从 `## IssuesToFix` 中解析条目，按 `priority` 排序并按 `id` 去重
-- 解析失败则返回 `INVALID_FIX_FILE`
-
-### 2. 逐项修复（No Scope Creep）
-
-- 仅修复 fixFile 中列出的问题：`IssuesToFix`（必要）与 `OptionalIssues`（可选）
-- 每个修复必须能明确对应到原问题的 `id`
-- 无法修复时必须记录原因（例如：缺少上下文、超出本 PR 范围、需要产品决策、需要数据库迁移等）
-
-执行前检查（强制）：
-
-- 当前分支禁止是 `main`/`master`（应已由 pr-context 切到 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、保持既有风格与约定
-
-## 重要约束（强制）
-
-- ⛔ 不要发布评论到 GitHub（不调用 `gh pr comment/review`）
-- ✅ 必须 push（禁止 force push；禁止 rebase）
-- ✅ 必须生成 fixReportFile（Markdown），内容可直接发到 GitHub 评论
-
-## 输出（强制）
-
-写入：`~/.opencode/cache/fix-report-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
-
-最终只输出一行：
-
-`fixReportFile: <path>`
-
-## 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: <path>`