@weotro/dx 0.1.9 → 0.1.10

package/README.md

@@ -307,6 +307,10 @@ dx cache clear -Y
 - `~/.codex/skills` 中包内管理的同名非软链接 skill 会被清理；已有软链接不会按旧副本删除。
 - 从包内移除的历史 skill 会在 `~/.agents/skills`、`~/.claude/skills`、`~/.codex/skills` 中一并清理。
 - 不属于包内管理的其他用户自有 skill 目录会保留。
+- 新增的 `ask_cc`（兼容咨询入口）和 `delegate-cc`（Claude Code 咨询与任务委派）会自动一同安装，无需修改初始化名单；保留 `ask_cc` 的旧名称及脚本入口。
+- 这两个 skill 仅在显式调用时启用。运行脚本需要本机的 `python3` 和已认证的 `claude` CLI；`dx initial` 不安装这些依赖或修改认证配置。
+
+安装或升级 dx 后，运行 `dx initial` 即可同步。默认脚本位置为 `~/.agents/skills/delegate-cc/scripts/delegate_cc.py`；旧咨询入口为 `~/.agents/skills/ask_cc/scripts/ask_cc.py`。
 
 关于 `help`：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weotro/dx",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
   "license": "MIT",
   "repository": {

package/skills/ask_cc/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ask_cc
+description: 仅在用户显式调用 $ask_cc 或明确要求使用 ask_cc 技能，或用户已显式调用的 oo-ship-issue-pr 流程要求咨询时使用；不要通过关键词、任务类型或上下文自动触发。
+---
+
+# ask_cc
+
+使用 [delegate-cc](../delegate-cc/SKILL.md) 的咨询流程获取答案或第二意见，默认不授予工具权限。
+
+若用户明确要求修改代码或执行开发任务，转入该技能的 `task` 模式，按任务范围完成实现和验收。
+
+旧命令 `scripts/ask_cc.py --prompt-file /绝对路径/问题.txt` 继续可用，仅运行咨询模式；模型顺序和降级逻辑复用 `delegate-cc`。
+
+`dx initial` 会同时安装这两个技能。使用当前 `SKILL.md` 所在目录下的脚本；默认安装后的调用方式：
+
+```bash
+python3 "$HOME/.agents/skills/ask_cc/scripts/ask_cc.py" --prompt-file /绝对路径/问题.txt
+```

package/skills/ask_cc/agents/openai.yaml

@@ -0,0 +1,2 @@
+policy:
+  allow_implicit_invocation: false

package/skills/ask_cc/scripts/ask_cc.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+"""兼容旧咨询入口；统一实现位于 delegate-cc。"""
+
+from pathlib import Path
+import sys
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[2] / "delegate-cc" / "scripts"))
+from delegate_cc import ask, main
+
+
+if __name__ == "__main__":
+    main([*sys.argv[1:], "--mode", "consult"])

package/skills/delegate-cc/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: delegate-cc
+description: 仅在用户显式调用 $delegate-cc 或明确要求使用 delegate-cc 技能，或已获用户调用授权的 ask_cc、oo-ship-issue-pr 流程要求委派时使用；不要通过关键词、任务类型或上下文自动触发。
+---
+
+# delegate-cc
+
+把 Claude Code 当作协作者。模型顺序固定为 Fable 5.1（`claude-fable-5-1`）→ Opus 5（`claude-opus-5`）→ 当前 sub-agent。保留本机现有认证。
+
+## 1. 准备交接
+
+- **咨询 `consult`**：用户需要答案、决策建议或评审意见。提供问题、相关代码或事实、约束；CLI 无工具权限，只返回建议。
+- **执行 `task`**：用户要求实现、修复或把开发任务交给 CC。任务书必须包含工作目录、目标、可修改文件或模块、适用的项目指令、验收标准和仓库实际验证命令。明确告知 CC 还有其他协作者，保留他人的改动，只负责分配范围。
+
+执行前检查 `git status --short` 和已有 diff，记录涉及文件的初始状态及未跟踪文件。分配互不重叠的文件；需要并发改同一文件时，先拆分责任或使用独立 worktree，指定由谁整合。worktree 不会自动携带未提交改动，必须提供任务所需的当前版本。CC 执行期间，主 agent 不同时修改其负责的文件。
+
+将任务书写入临时 UTF-8 文件，只传必要上下文，排除凭据。完成条件：CC 无需当前对话即可理解目标、权限范围与完成标准。
+
+## 2. 调用 CLI
+
+需要本机提供 `python3` 和已完成认证的 `claude` CLI；`dx initial` 只同步技能文件，不安装运行时或配置认证。
+
+运行当前 `SKILL.md` 所在目录下的 `scripts/delegate_cc.py`。以下路径适用于 `dx initial` 的默认安装位置；通过其他方式安装时使用实际技能目录：
+
+```bash
+# 咨询：默认模式，单个模型默认超时 120 秒。
+python3 "$HOME/.agents/skills/delegate-cc/scripts/delegate_cc.py" --prompt-file /绝对路径/问题.txt
+
+# 执行：必须指定工作目录，单次默认超时 900 秒。
+python3 "$HOME/.agents/skills/delegate-cc/scripts/delegate_cc.py" --mode task --cwd /绝对路径/工作区 --prompt-file /绝对路径/任务.txt
+```
+
+需要 CC 自行运行验证命令时，按本次授权追加 `--allow-command '仓库实际验证命令'`，可重复传入。使用具体命令而非开放全部 Bash；检查命令本身及其调用脚本的作用。现有 Claude Code 权限规则仍生效，`--allow-command` 只是增加允许规则，不是独立沙箱。文件责任范围通过任务书和验收控制，需要隔离时使用 worktree 或已有沙箱。
+
+执行模式保留默认编码系统提示，开放 `Read,Glob,Grep,Edit,Write,Bash`，使用 `acceptEdits`，不能获批的工具请求自动拒绝。两种模式都关闭 hooks、MCP 和技能，避免额外任务链；主 agent 应把所需项目规则及技能要求写入任务书。本技能不使用 `bypassPermissions`，也不扩大任务至提交、推送、部署或对外发送消息。
+
+通过工具异步运行，至少每 60 秒向用户汇报进度。`--timeout` 可按任务规模调整；超时会终止执行任务的进程组。完成条件：获得 JSON 结果或明确的执行失败，旧进程已结束。
+
+## 3. 验收或接续
+
+- `ok`：咨询获得答案；检查是否回应原问题，不能把空泛回复当作完成。
+- `review_required`：执行已返回报告，尚待主 agent 验收。对照初始状态检查 diff、新文件及责任范围，运行必要的格式化、检查和测试。发现越界修改时先核对归属，只修正本次 CC 引入的变化。`permission_denials` 非零时核实未执行工作，使用已获授权的宿主工具完成，或准确报告实际权限阻塞。
+- `continuation_required`：任务可能已部分执行。先检查现有 diff、测试状态及外部副作用；更新任务书为“保留已完成部分，仅完成剩余工作”。若 `next_model` 有值，以 `--start-model` 传入该值接续；每个模型最多尝试一次。禁止将同一任务从头盲目重放。
+- `fallback_required`、第二模型也失败或 CLI 无法运行：当前执行者已经是 sub-agent 时直接接手；主 agent 则委派一个继承当前模型的 sub-agent，环境不支持委派时自己接手。提供原任务、已完成改动和剩余工作，明确跳过本技能及 CLI，避免递归。权限拒绝不能靠切换模型绕过。
+
+咨询模式由脚本自动依次尝试两个模型；执行模式每次只运行一个模型，由主 agent 检查现场后接续。认证、额度、模型不可用和超时都不等于任务完成。
+
+完成条件：咨询得到实质答案，或执行任务的代码和验证满足验收标准；仍有缺口时明确列出，而非仅转述 CC 的成功声明。
+
+## 4. 交付
+
+用简体中文说明答案或实际改动、验证结果、未完成项，简短注明使用的模型及降级情况。`requested_model` 是请求 ID，不保证服务端未自动切换模型。清理本次临时任务文件；保留仍有成果待整合的 worktree。
+
+参数或模型出错时核对本机 `claude --help`、[CLI 参考](https://code.claude.com/docs/en/cli-reference)和[模型 ID](https://platform.claude.com/docs/en/models/overview)。用 `claude auth status` 区分认证状态，`unrecognized_model` 不表示未登录。

package/skills/delegate-cc/agents/openai.yaml

@@ -0,0 +1,2 @@
+policy:
+  allow_implicit_invocation: false

package/skills/delegate-cc/scripts/delegate_cc.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""向 Claude Code 委派咨询或代码任务，并报告降级与接续状态。"""
+
+import argparse
+import json
+import math
+import os
+from pathlib import Path
+import shutil
+import signal
+import subprocess
+import sys
+
+
+MODELS = ("claude-fable-5-1", "claude-opus-5")
+
+
+def run_task(command, prompt, timeout, cwd):
+    """超时或中断时终止整个任务进程组，避免后台写入与接续任务竞争。"""
+    with subprocess.Popen(command, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE, text=True, encoding="utf-8",
+                          errors="replace", cwd=cwd, start_new_session=True) as process:
+        try:
+            stdout, stderr = process.communicate(prompt, timeout=timeout)
+        except BaseException:
+            try:
+                os.killpg(process.pid, signal.SIGKILL)
+            except ProcessLookupError:
+                pass
+            process.communicate()
+            raise
+        return subprocess.CompletedProcess(command, process.returncode, stdout, stderr)
+
+
+def ask(prompt, timeout=120, *, mode="consult", cwd=None, start_model=None, allow_commands=()):
+    if mode not in ("consult", "task"):
+        raise ValueError("未知模式")
+    if mode == "task" and (cwd is None or not Path(cwd).is_dir()):
+        raise ValueError("代码任务必须指定存在的工作目录")
+    if mode == "consult" and (start_model is not None or allow_commands):
+        raise ValueError("咨询模式不接受任务专用参数")
+    attempts = []
+    cli = shutil.which("claude")
+    if not cli:
+        return {"status": "fallback_required", "attempts": [], "reason": "未找到 claude 命令"}
+    models = MODELS if mode == "consult" else (start_model or MODELS[0],)
+    for model in models:
+        if model not in MODELS:
+            raise ValueError("模型不在委派链中")
+        print(f"正在调用 {model}（{mode}）…", file=sys.stderr, flush=True)
+        command = [
+            cli, "--print", "--model", model, "--output-format", "json",
+            "--strict-mcp-config", "--mcp-config", '{"mcpServers":{}}',
+            "--disable-slash-commands", "--no-session-persistence",
+            "--settings", '{"disableAllHooks":true}',
+        ]
+        if mode == "consult":
+            command += ["--tools", "", "--system-prompt", "你是决策与问答顾问。根据提供的事实用简体中文回答，说明关键理由和不确定性。仅提供建议。"]
+        else:
+            command += [
+                "--tools", "Read,Glob,Grep,Edit,Write,Bash",
+                "--permission-mode", "acceptEdits", "--permission-prompts", "none",
+                "--append-system-prompt",
+                "你是协作开发者。按任务书实际修改代码并验证。你不是唯一的执行者，保留其他人的改动，遵守分配的文件范围。"
+                "先阅读适用的 AGENTS.md 和 CLAUDE.md；接续任务先检查当前状态，仅完成剩余工作。"
+                "仅执行本地开发和验证，不提交、推送、发布或对外发消息。权限被拒绝时报告具体阻塞，不尝试绕过。"
+                "完成后用简体中文报告变更文件、验证命令及结果、未完成项。",
+            ]
+            if allow_commands:
+                command += ["--allowedTools", *[f"Bash({item})" for item in allow_commands]]
+        try:
+            process = run_task(command, prompt, timeout, cwd) if mode == "task" else subprocess.run(
+                command, input=prompt, text=True, encoding="utf-8",
+                errors="replace", capture_output=True, timeout=timeout, cwd=cwd,
+            )
+        except subprocess.TimeoutExpired:
+            attempts.append({"requested_model": model, "reason": "调用超时"})
+            continue
+        except OSError as error:
+            attempts.append({"requested_model": model, "reason": f"无法运行 CLI：{type(error).__name__}"})
+            break
+        try:
+            payload = json.loads(process.stdout)
+        except (ValueError, TypeError):
+            payload = {}
+        if not isinstance(payload, dict):
+            payload = {}
+        answer = payload.get("result")
+        if (process.returncode == 0 and payload.get("type") == "result"
+                and payload.get("subtype") == "success"
+                and payload.get("is_error") is not True
+                and isinstance(answer, str) and answer.strip()):
+            return {"status": "review_required" if mode == "task" else "ok", "requested_model": model,
+                    "permission_denials": len(payload.get("permission_denials") or []),
+                    "answer": answer.strip(), "attempts": attempts}
+        # 原始错误可能包含账户信息，仅输出有界的分类原因。
+        diagnostic = (process.stderr + process.stdout).lower()
+        if any(word in diagnostic for word in ("quota", "credit", "usage limit", "rate_limit", "rate limit", "429")):
+            reason = "额度不足或限流"
+        elif any(word in diagnostic for word in ("authentication", "unauthorized", "not logged in", "401")):
+            reason = "认证不可用"
+        elif any(word in diagnostic for word in ("unrecognized_model", "issue with the selected model", "model_not_found")):
+            reason = "模型名称无效或当前账户无权访问"
+        else:
+            reason = f"CLI 未返回有效答案（退出码 {process.returncode}）"
+        attempts.append({"requested_model": model, "reason": reason})
+    result = {"status": "fallback_required", "attempts": attempts}
+    if mode == "task":
+        result.update(status="continuation_required", reason="检查现有改动后接续，前次任务可能已经部分执行",
+                      next_model=MODELS[1] if models[0] == MODELS[0] else None)
+    return result
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--prompt-file", required=True, type=Path)
+    parser.add_argument("--mode", choices=("consult", "task"), default="consult")
+    parser.add_argument("--cwd", type=Path)
+    parser.add_argument("--start-model", choices=MODELS)
+    parser.add_argument("--allow-command", action="append", default=[])
+    parser.add_argument("--timeout", type=float)
+    args = parser.parse_args(argv)
+    if args.timeout is None:
+        args.timeout = 900 if args.mode == "task" else 120
+    if not math.isfinite(args.timeout) or args.timeout <= 0:
+        parser.error("--timeout 必须为有限正数")
+    if args.mode == "task" and (args.cwd is None or not args.cwd.is_dir()):
+        parser.error("任务模式必须通过 --cwd 指定存在的工作目录")
+    if args.mode == "consult" and (args.start_model or args.allow_command):
+        parser.error("--start-model 和 --allow-command 仅用于任务模式")
+    try:
+        prompt = args.prompt_file.read_text(encoding="utf-8")
+        if not prompt.strip():
+            raise ValueError("问题为空")
+    except (OSError, UnicodeError, ValueError):
+        result = {"status": "fallback_required", "attempts": [], "reason": "问题文件不可读或为空，请宿主使用原问题兜底"}
+    else:
+        result = ask(prompt, args.timeout, mode=args.mode, cwd=args.cwd,
+                     start_model=args.start_model, allow_commands=args.allow_command)
+    print(json.dumps(result, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

package/skills/delegate-cc/scripts/test_delegate_cc.py

@@ -0,0 +1,90 @@
+"""复现 CLI 模型校验失败，覆盖模型顺序及错误分类。"""
+
+import json
+import subprocess
+import unittest
+import tempfile
+from pathlib import Path
+from unittest.mock import patch
+
+import delegate_cc as ask_cc
+
+
+def result(answer, failed=False):
+    return subprocess.CompletedProcess([], int(failed), json.dumps({
+        "type": "result", "subtype": "success", "is_error": failed,
+        "result": answer,
+    }), "")
+
+
+class AskCCTest(unittest.TestCase):
+    @patch.object(ask_cc.shutil, "which", return_value="/fake/claude")
+    def test_task_permissions_and_review(self, _which):
+        with tempfile.TemporaryDirectory() as cwd, patch.object(ask_cc, "run_task", return_value=result("完成")) as run:
+            response = ask_cc.ask("修改代码", mode="task", cwd=cwd, allow_commands=["python3 -m unittest"])
+        command = run.call_args.args[0]
+        self.assertEqual(response["status"], "review_required")
+        self.assertEqual(command[command.index("--permission-mode") + 1], "acceptEdits")
+        self.assertIn("Bash(python3 -m unittest)", command)
+        self.assertNotIn("bypassPermissions", command)
+
+    @patch.object(ask_cc.shutil, "which", return_value="/fake/claude")
+    def test_partial_task_is_not_blindly_retried(self, _which):
+        with tempfile.TemporaryDirectory() as cwd:
+            def partial(*args):
+                Path(cwd, "partial.txt").write_text("已完成部分")
+                raise subprocess.TimeoutExpired("claude", 1)
+            with patch.object(ask_cc, "run_task", side_effect=partial) as run:
+                response = ask_cc.ask("修改代码", mode="task", cwd=cwd)
+            self.assertEqual(run.call_count, 1)
+            self.assertEqual(Path(cwd, "partial.txt").read_text(), "已完成部分")
+            self.assertEqual(response["status"], "continuation_required")
+            self.assertEqual(response["next_model"], "claude-opus-5")
+
+    @patch.object(ask_cc.shutil, "which", return_value="/fake/claude")
+    def test_second_task_failure_requests_local_fallback(self, _which):
+        with tempfile.TemporaryDirectory() as cwd, patch.object(ask_cc, "run_task", return_value=result("usage limit", True)):
+            response = ask_cc.ask("接续", mode="task", cwd=cwd, start_model="claude-opus-5")
+        self.assertEqual(response["status"], "continuation_required")
+        self.assertIsNone(response["next_model"])
+
+    def test_task_requires_explicit_directory(self):
+        with self.assertRaises(ValueError):
+            ask_cc.ask("修改代码", mode="task")
+
+    @patch.object(ask_cc.shutil, "which", return_value="/fake/claude")
+    def test_supported_model_ids_and_fallback(self, _which):
+        seen = []
+
+        def cli(command, **kwargs):
+            model = command[command.index("--model") + 1]
+            seen.append(model)
+            if model == "claude-fable-5-1":
+                return result("usage limit exceeded", True)
+            if model == "claude-opus-5":
+                return result("OK")
+            return result(f"There's an issue with the selected model ({model}).", True)
+
+        with patch.object(ask_cc.subprocess, "run", side_effect=cli):
+            response = ask_cc.ask("仅回答 OK")
+        self.assertEqual(response["status"], "ok")
+        self.assertEqual(seen, ["claude-fable-5-1", "claude-opus-5"])
+        self.assertEqual(response["answer"], "OK")
+
+    @patch.object(ask_cc.shutil, "which", return_value="/fake/claude")
+    def test_unrecognized_model_is_reported(self, _which):
+        failure = result("There's an issue with the selected model (fable-5.1). It may not exist or you may not have access to it.", True)
+        with patch.object(ask_cc.subprocess, "run", return_value=failure):
+            response = ask_cc.ask("问题")
+        self.assertEqual(response["status"], "fallback_required")
+        self.assertEqual(response["attempts"][0]["reason"], "模型名称无效或当前账户无权访问")
+
+    @patch.object(ask_cc.shutil, "which", return_value="/fake/claude")
+    def test_login_error_is_distinct(self, _which):
+        with patch.object(ask_cc.subprocess, "run", return_value=result("Not logged in · Please run /login", True)):
+            response = ask_cc.ask("问题")
+        self.assertEqual(response["attempts"][0]["reason"], "认证不可用")
+
+
+if __name__ == "__main__":
+    unittest.main()

package/skills/oo-ship-issue-pr/SKILL.md

@@ -5,7 +5,7 @@ description: 仅在用户显式调用 $oo-ship-issue-pr、/oo-ship-issue-pr 或
 
 # OO Ship Issue PR
 
-Codex 入口：主进程执行轻改动，直接派出 fresh Codex subagent 承接重改动的方案讨论、实现与独立审查；subagent 不可用时由主进程降级接管并如实记录。
+Codex 入口：主进程执行轻改动；Claude 咨询与独立审查调用 [ask_cc](../ask_cc/SKILL.md)，重改动实现与修复调用 [delegate-cc](../delegate-cc/SKILL.md) 的 `task` 模式。调用、模型选择和降级均复用这两个技能。
 
 ## 步骤一：加载共享流程
 
@@ -18,7 +18,7 @@ test -f "$SHIP_CORE"
 完整读取 `SHIP_CORE` 后执行全部阶段。运行时映射如下：
 
 - 主进程：当前 Codex。
-- 外部专家：fresh Codex subagent；每个专家阶段新建独立上下文，不复用方案讨论、实现或修复 agent 执行审查。
+- 外部专家：通过 `ask_cc` 或 `delegate-cc` 调用的 Claude Code；审查使用独立上下文，不复用实现或修复会话。
 - 入口显示名：`OO Ship Issue PR`。
 - Follow-up：Codex `spawn_agent` 的 `worker` 角色。
 

package/skills/oo-ship-issue-pr/references/runtime.md

@@ -2,50 +2,47 @@
 
 仅在共享流程进入外部专家或 follow-up 分支时读取。
 
-## Fresh Codex subagent 专家通道
+## Claude 技能路由
 
-共享流程中的“外部专家”在本入口指独立上下文的 Codex subagent，不要求跨模型或第三方 CLI。每个专家阶段直接调用 Codex `spawn_agent` 创建全新的 `worker`，不复用此前 agent，尤其不让实现或修复 agent 审查自己的改动。使用 `fork_turns: "none"`；若当前工具不提供该参数，使用其支持的新会话方式且不传已有会话 ID，在 prompt 中完整提供任务上下文。
+用户显式调用 `oo-ship-issue-pr` 后，按下表调用其依赖技能。先完整读取对应 `SKILL.md`，再执行其中的流程；路径相对于本文件，`dx initial` 会将这些技能安装在同一个 skills 根目录下。
 
-### 派发上下文与权限
+| 共享流程阶段 | 调用技能 | 本阶段目标 |
+|---|---|---|
+| 阶段四方案讨论 | [ask_cc](../../ask_cc/SKILL.md) | 只读咨询，裁决初步方案、备选与取舍 |
+| 阶段 7.3 review | [ask_cc](../../ask_cc/SKILL.md) | 对照 Issue 与当前 diff 返回独立 findings |
+| 阶段 7.3 adversarial review | [ask_cc](../../ask_cc/SKILL.md) | 挑战假设、不变量、反例与失败路径 |
+| 阶段四重改动实现、阶段 7.4 重修复 | [delegate-cc](../../delegate-cc/SKILL.md) 的 `task` 模式 | 按最终方案修改代码并提供验证结果 |
 
-每次 prompt 必须包含：
+本入口只补充交付上下文与验收要求。CLI 参数、模型顺序、权限配置、等待与超时、状态解析、接续及降级统一按依赖技能执行，不在这里另写调用脚本或重试链。依赖文件缺失时先运行 `dx initial` 恢复；仍无法读取时报告缺失路径，不临时仿写该技能。
 
-- 当前 worktree 的绝对路径，以及只在该 worktree 工作。
-- 当前阶段是只读方案讨论、只读 review、adversarial review、实现还是修复；只承接这一阶段，不运行完整 `oo-ship-issue-pr`。
-- Issue 原文、逐条验收标准、base、主进程初步方案或最终方案，以及该阶段所需的 diff、已确认问题和验证上下文。
-- 先读取根与涉及目录的 `AGENTS.md`；它不是代码库中唯一执行者，保护已有未提交改动，不回退其他人的修改。
-- 只读阶段保持工作树不变；实现或修复阶段的所有权限定为 prompt 列出的验收范围和涉及文件，改动留在工作树。
-- 不 commit、不 push、不操作 GitHub、不递归委派；最后返回证据、结论、修改路径和未运行验证。
+## 交接上下文
 
-### 只读讨论、review 与 adversarial review
+每次交接包含当前 worktree 绝对路径、阶段、Issue 原文与逐条验收标准、base，以及该阶段所需的方案、代码和验证证据。任务仅覆盖当前阶段，不运行完整 `oo-ship-issue-pr`；Git 历史、GitHub 操作、权威验证和最终事实核验由 Codex 主进程负责。
 
-prompt 明确要求只读、不执行任何写操作，并直接读取源码和 `git diff <base>...HEAD` 取证。
+### 咨询与独立审查
 
-- 方案讨论：围绕主进程初步方案、备选与取舍、希望裁决的具体问题返回建议；最终方案由主进程拍板。
-- 普通 review：以 findings 为主，按严重级排序；每项包含严重级、`文件:行号`、证据、影响和具体修法。
-- adversarial review：先挑战方案假设、构造反例和失败路径，再输出同样格式的 findings；没有证据的问题不进入报告。
+`ask_cc` 的咨询模式无工具权限。主进程先读取适用的 `AGENTS.md`、相关源码和当前 diff，将必要内容连同文件路径、行号、验证结果写进咨询材料；审查材料覆盖整个 PR diff，另附影响判断所需的上下文。仅提供仓库路径或要求 Claude 自行读文件不构成完整交接。证据不足时由主进程补充材料后继续同一审查阶段。
 
-### 重改动实现与修复
+- 方案讨论：附主进程初步方案、备选与取舍、希望裁决的具体问题；最终方案由主进程拍板。
+- 普通 review：要求按严重级返回 findings，每项包含 `文件:行号`、证据、影响和具体修法。
+- adversarial review：先挑战方案假设、构造反例和失败路径，再按同样格式返回 findings。
 
-prompt 附最终方案原文，要求只改验收范围，最后报告修改路径、已运行验证和未运行验证及原因。Git 历史、GitHub、权威验证和最终事实核验始终由 Codex 主进程负责。
+审查使用全新独立上下文，不复用实现或修复会话。通过依赖技能降级后，只有未参与实现或修复的独立执行者完成的审查才计入外部专家审查；主进程自审不得冒充独立审查。
 
-## 结果、等待与补跑
+### 实现与修复
 
-通过当前运行时提供的等待/结果工具等待本次 agent 完成并读取完整报告；派发成功或拿到 agent ID 不算阶段完成。可写 agent 执行期间主进程不并发修改其所有权范围内的文件，返回且确认不再写入后才接管。
+按 `delegate-cc` 的任务书要求，附最终方案原文、可修改文件或模块、适用项目指令、验收标准及仓库实际验证命令。保护已有改动，只在指定 worktree 和分配范围内工作，改动留在工作树。需要 Claude 运行验证时按该技能声明允许的具体命令。
 
-`spawn_agent` 不可用、派发失败、执行失败或超时时，记录 agent ID（如有）与原因；若已启动，先终止或确认 agent 已停止，检查部分改动后，再由主进程完成同一阶段并记录 `Codex 主进程降级`。无法确认可写 agent 已停止时，报告阻塞，避免并发覆盖。单纯的 subagent 不可用不应中断交付链，但主进程自审不得冒充独立审查。
+## 验收与报告
 
-subagent 执行过的验证只作参考；prompt 必须附本阶段主进程需补跑的验证清单，要求 subagent 列出因沙箱、权限或依赖限制未运行的项目。阶段五及后续轮次要求的全部权威验证由 Codex 主进程重新执行并阅读最新输出。
+取得结果、等待停止、处理部分改动、接续或降级均按依赖技能执行。主进程取得最终结果后直读源码和 diff，核验结论、合并重复项并记录拒绝依据；仅派发成功或返回成功声明不算阶段完成。
 
-fresh subagent 返回后，Codex 主进程逐条直读源码和 diff 复核，合并重复项并记录拒绝依据，再继续共享流程。
+外部执行者的验证仅作参考。交接材料附本阶段需补跑的清单，并要求报告未运行的验证及原因；阶段五及后续轮次的全部权威验证仍由 Codex 主进程重新执行并阅读最新输出。
 
-## 阶段与报告映射
+阶段 7.3 仍服从共享流程的复杂度门禁和每 PR 最多一次外部专家审查约束。此前报告中的外部专家审查继续计数；同一阶段因证据不足补充材料或按依赖技能降级，不能被当作后续轮次重新派发审查的额度。
 
-- 阶段四方案讨论：只读 fresh Codex subagent。
-- 阶段四实现与阶段 7.4 重修复：可写 fresh Codex subagent。
-- 阶段 7.3：复杂度门禁命中且本 PR 尚未用过外部专家审查时执行 review；需要挑战方案时执行 adversarial review。成功返回的 fresh Codex subagent 计入本 PR 唯一一次外部专家审查，Codex 主进程降级不计入；已有报告中的历史外部专家审查仍按共享流程计数。
-- reviewer：`Codex 主进程自审 / fresh Codex subagent review / fresh Codex subagent adversarial review / Codex 主进程降级 review / Codex 主进程降级 adversarial review`，按本轮实际执行者填写；其他专家阶段同样记录实际使用 fresh Codex subagent 或 Codex 主进程降级。
+reviewer 按实际执行者记录为 `Codex 主进程自审`、`Claude Code（ask_cc）review/adversarial review` 或实际降级执行者，并记录依赖技能返回的请求模型及降级情况。实现与修复记录使用 `delegate-cc task` 及实际执行者；自身接管的审查记为自审，不计入外部专家审查。
 
 ## Follow-up
 
-使用 Codex `spawn_agent` 的 `worker` 角色，prompt 指定 worktree 绝对路径并要求调用 `oo-ship-issue-pr`。明确告知 worker 它不是代码库中唯一执行者，不回退其他人的改动，只在指定 worktree 工作。派发深度只允许一层；worker 发现的新 follow-up 只建 Issue。
+完整 follow-up 包含 Git/PR 交付，使用 Codex `spawn_agent` 的 `worker` 角色在后台承接；Claude 技能只负责上表中的专家阶段。prompt 指定 worktree 绝对路径并要求调用 `oo-ship-issue-pr`。明确告知 worker 它不是代码库中唯一执行者，不回退其他人的改动，只在指定 worktree 工作。派发深度只允许一层；worker 发现的新 follow-up 只建 Issue。