@baoanaz/cviauto 0.6.5 → 0.6.8

package/dist/templates/common/bundled-skills/trellis-channel/references/workers.md

@@ -1,11 +1,8 @@
-# Workers And Agent Cards
+# Workers 与 Agent 卡片（Agent Cards）
 
-Use workers when a peer agent should execute independently and report back
-through the channel event log. A worker is a registered child process (claude
-or codex) attached to a channel; the supervisor forwards inbox messages to it
-and translates its output back into channel events.
+当需要让一个对等 agent 独立执行并通过通道事件日志（channel event log）回传结果时，使用 worker。一个 worker 是注册到通道上的子进程（claude 或 codex）；supervisor 将收件箱消息转发给它，并将它的输出转换回通道事件。
 
-## Spawn
+## Spawn（启动）
 
 ```bash
 cviauto channel create impl-task --by dispatcher --cwd /path/to/repo
@@ -17,38 +14,33 @@ echo "Implement the schema for table X per .cviauto/.../prd.md" \
 cviauto channel wait impl-task --as dispatcher --from codex-impl --kind done --timeout 30m
 ```
 
-`spawn` forks a `channel __supervisor` worker that emits `spawned`, streams
-`progress`, and should end with `done`, `error`, or `killed`. Workers stay
-inbox-idle until a `send --to <worker>` (or a broadcast when
-`--inbox-policy broadcastAndExplicit` is set) wakes them.
+`spawn` 会 fork 一个 `channel __supervisor` worker，它会发出 `spawned` 事件、流式输出 `progress`，并最终以 `done`、`error` 或 `killed` 结束。worker 在收到 `send --to <worker>`（或设置了 `--inbox-policy broadcastAndExplicit` 时的广播）之前会保持收件箱空闲状态。
 
-Key `spawn` flags:
+`spawn` 的关键参数：
 
-- `--agent <name>` — load `.cviauto/agents/<name>.md` (provider/model/as/system prompt defaults).
-- `--provider <claude|codex>` — overrides the agent card; validated against the adapter registry.
-- `--as <name>` — channel worker handle; defaults to the agent name.
-- `--cwd <path>` — worker working directory (also the jail root for `--file`/`--jsonl`).
-- `--model <id>` — model override.
-- `--resume <id>` — resume an existing claude session / codex thread.
-- `--timeout <duration>` — auto-kill after `30s` / `2m` / `1h`.
-- `--warn-before <duration>` — supervisor_warning lead time (default `5m`; `0ms` disables).
-- `--file <path>` (repeatable, glob-supported) — inject file content into the system prompt.
-- `--jsonl <path>` (repeatable) — Cviauto jsonl manifest (`{file, reason}` per line).
-- `--by <agent>` — author of the `spawned` event (defaults to `$TRELLIS_CHANNEL_AS` or `main`).
-- `--inbox-policy <explicitOnly|broadcastAndExplicit>` — default `explicitOnly`.
-- `--idle-timeout <duration>` — OOM guard idle TTL (default `5m`; `0` disables).
-- `--max-live-workers <n>` — spawn-time live-worker budget (default `6`; `0` disables).
+- `--agent <name>` — 加载 `.cviauto/agents/<name>.md`（provider/model/as 等系统提示默认值）。
+- `--provider <claude|codex>` — 覆盖 agent 卡片中的设置；会根据适配器注册表进行校验。
+- `--as <name>` — 通道中 worker 的句柄；默认与 agent 名称相同。
+- `--cwd <path>` — worker 的工作目录（同时也是 `--file`/`--jsonl` 的 jail 根目录）。
+- `--model <id>` — 模型覆盖。
+- `--resume <id>` — 恢复已有的 claude 会话 / codex 线程。
+- `--timeout <duration>` — 超时自动 kill，如 `30s` / `2m` / `1h`。
+- `--warn-before <duration>` — supervisor_warning 提前通知时间（默认 `5m`；`0ms` 禁用）。
+- `--file <path>`（可重复，支持 glob）— 将文件内容注入系统提示。
+- `--jsonl <path>`（可重复）— Cviauto jsonl 清单（每行 `{file, reason}`）。
+- `--by <agent>` — `spawned` 事件的作者（默认 `$TRELLIS_CHANNEL_AS` 或 `main`）。
+- `--inbox-policy <explicitOnly|broadcastAndExplicit>` — 默认 `explicitOnly`。
+- `--idle-timeout <duration>` — OOM guard 空闲 TTL（默认 `5m`；`0` 禁用）。
+- `--max-live-workers <n>` — spawn 时的存活 worker 数量上限（默认 `6`；`0` 禁用）。
 
-The success event `spawned` records `pid`, `provider`, `agent`, the injected
-`files`, and the resolved `manifests` so later spectators can audit context.
+成功事件 `spawned` 会记录 `pid`、`provider`、`agent`、注入的 `files` 以及解析后的 `manifests`，以便后续观察者审计上下文。
 
-## Agent Cards
+## Agent 卡片（Agent Cards）
 
-`--agent <name>` resolves to `.cviauto/agents/<name>.md`. The card name must
-match `[A-Za-z0-9._-]+`. The default Cviauto install ships two cards:
+`--agent <name>` 解析到 `.cviauto/agents/<name>.md`。卡片名称必须匹配 `[A-Za-z0-9._-]+`。Cviauto 默认安装附带两张卡片：
 
-- `.cviauto/agents/check.md` — code-quality reviewer.
-- `.cviauto/agents/implement.md` — coding worker for implementation runs.
+- `.cviauto/agents/check.md` — 代码质量审查（code-quality reviewer）。
+- `.cviauto/agents/implement.md` — 用于实现任务的编码 worker。
 
 ```yaml
 ---
@@ -58,37 +50,30 @@ provider: claude
 ---
 ```
 
-Frontmatter fields populate `spawn` defaults (provider, model, `as`); the
-markdown body becomes the worker's system-prompt role. Cards do **not**
-auto-attach task files — context must be injected explicitly per spawn (see
-below).
+frontmatter 中的字段会填充 `spawn` 的默认值（provider、model、`as`）；markdown 正文会成为 worker 的系统提示（system-prompt）角色。卡片**不会**自动附加任务文件——上下文必须在每次 spawn 时显式注入（见下文）。
 
-Always inspect project cards before spawning a named agent:
+在启动命名 agent 之前，始终先检查项目中的卡片：
 
 ```bash
 ls .cviauto/agents
 sed -n '1,100p' .cviauto/agents/check.md
 ```
 
-## Context Injection
+## 上下文注入（Context Injection）
 
-Two flags inject content into the worker's system prompt under a
-`# CONTEXT FILES` block, assembled by `context-loader`:
+两个参数可将内容注入 worker 的系统提示中的 `# CONTEXT FILES` 代码块，由 `context-loader` 负责组装：
 
-- `--file <path>` — repeatable, glob-supported (`*`, `**`). Each match is
-  read and concatenated.
-- `--jsonl <path>` — repeatable Cviauto manifest where every line is
-  `{"file":"<path>","reason":"<why>"}`. The reason is preserved as a header
-  comment above each file's content.
+- `--file <path>` — 可重复，支持 glob（`*`、`**`）。每个匹配到的文件都会被读取并拼接。
+- `--jsonl <path>` — 可重复的 Cviauto 清单，每行为 `{"file":"<path>","reason":"<why>"}`。reason 会作为头部注释保留在每个文件内容之前。
 
-Limits enforced by the loader:
+加载器强制执行的限制：
 
-- 1 MB hard cap per file (oversize → error).
-- 200 KB per-file warning to stderr.
-- 500 KB total assembled-context warning to stderr.
-- Path-traversal jail: all resolved paths must stay under `--cwd`.
+- 单文件 1 MB 硬上限（超出 → 报错）。
+- 单文件 200 KB 时向 stderr 输出警告。
+- 组装上下文总量 500 KB 时向 stderr 输出警告。
+- 路径穿越 jail：所有解析后的路径必须位于 `--cwd` 之下。
 
-Example spawning a check agent against a task directory:
+针对任务目录启动 check agent 的示例：
 
 ```bash
 TASK=.cviauto/tasks/05-13-example
@@ -100,19 +85,16 @@ cviauto channel spawn cr-example --agent check --provider codex --as check-cx \
   --cwd "$PWD" --timeout 30m
 ```
 
-The `spawned` event records both the literal `files` array and any `manifests`
-expanded from `--jsonl`, so the audit trail captures whatever the worker was
-actually shown.
+`spawned` 事件会同时记录字面的 `files` 数组以及从 `--jsonl` 展开的所有 `manifests`，因此审计追踪会完整捕获 worker 实际看到的内容。
 
-## Names And Routing
+## 命名与路由（Names And Routing）
 
-`--as` has two meanings:
+`--as` 有两种含义：
 
-- `send` / `wait` / `interrupt`: speaker identity (author of the resulting event).
-- `spawn`: the worker handle that other agents address with `--to`.
+- `send` / `wait` / `interrupt`：发言人身份（生成事件的作者）。
+- `spawn`：worker 句柄，其他 agent 通过 `--to` 来寻址。
 
-Use explicit names when multiple workers or providers participate in one
-channel:
+当多个 worker 或 provider 在同一个通道中参与时，使用显式命名：
 
 ```bash
 cviauto channel spawn cr-feature --agent check --as check-claude
@@ -122,37 +104,27 @@ cviauto channel wait cr-feature --as main \
   --from check-claude,check-cx --kind done --all --timeout 15m
 ```
 
-`--all` requires `--from` and blocks until every listed worker has produced a
-matching event; timeout exits with code **124** and prints
-`timeout: still waiting on ...` to stderr.
+`--all` 需要 `--from`，会阻塞直到列表中所有 worker 都产生了匹配的事件；超时则退出码为 **124** 并向 stderr 输出 `timeout: still waiting on ...`。
 
-## Soft Interrupt — `interrupt`
+## 软中断 — `interrupt`
 
-`channel interrupt` is the cooperative redirect: it appends an `interrupt`
-event (reason `"user"`) and, where the adapter supports it, issues a
-provider-level turn interrupt with a replacement instruction. Use it when the
-worker should drop its current turn and act on new input immediately, without
-losing its session.
+`channel interrupt` 是协作式重定向：它会追加一个 `interrupt` 事件（reason 为 `"user"`），并在适配器支持的情况下，发出 provider 级别的 turn interrupt，携带替代指令。当需要 worker 丢弃当前 turn 并立即根据新输入采取行动，同时不丢失其会话时，使用此命令。
 
 ```bash
 echo "Stop refactoring the parser — switch to fixing the failing test in src/foo.ts" \
   | cviauto channel interrupt impl-task --as dispatcher --to codex-impl --stdin
 ```
 
-Flags:
+参数：
 
-- `--as <agent>` **(required)** — caller identity.
-- `--to <agent>` **(required)** — target worker.
-- `--scope <project|global>` — channel scope.
-- `--stdin` / `--text-file <path>` / `[text]` — replacement instruction body.
+- `--as <agent>` **（必需）** — 调用者身份。
+- `--to <agent>` **（必需）** — 目标 worker。
+- `--scope <project|global>` — 通道作用域。
+- `--stdin` / `--text-file <path>` / `[text]` — 替代指令正文。
 
-The appended event has `kind: "interrupt"` — downstream `wait` / `messages`
-filters can subscribe with `--kind interrupt` to react to redirections (e.g.
-to log the rerouting, or to gate other workers behind a coordinator's
-correction).
+追加的事件具有 `kind: "interrupt"` — 下游的 `wait` / `messages` 过滤器可以通过 `--kind interrupt` 订阅以响应重定向（例如记录重新路由，或在协调者的纠正之后阻塞其他 worker）。
 
-For low-priority hints that should wait for the worker's next turn, send a
-plain tagged message instead:
+对于应等待 worker 下一个 turn 的低优先级提示，改用带标签的普通消息：
 
 ```bash
 echo "Check this when you reach the next turn." \
@@ -160,13 +132,9 @@ echo "Check this when you reach the next turn." \
       --stdin --tag question
 ```
 
-## Hard Interrupt — `kill` + `--resume`
+## 硬中断 — `kill` + `--resume`
 
-Use `kill` when the worker must stop **now** (e.g. runaway loop, bad
-instructions already in flight, or `interrupt` is not honored by the
-adapter). The supervisor escalates SIGTERM → 8 s grace → SIGKILL; the CLI
-writes a `killed` event when SIGKILL is needed so the event log stays
-truthful.
+当 worker 需要**立即**停止时使用 `kill`（例如失控循环、已发出的错误指令，或适配器不响应 `interrupt`）。supervisor 会按 SIGTERM → 8 秒宽限期 → SIGKILL 逐步升级；CLI 在需要 SIGKILL 时会写入 `killed` 事件，确保事件日志如实记录。
 
 ```bash
 cviauto channel kill impl-task --as codex-impl
@@ -177,100 +145,81 @@ echo "STOP — new instructions: ..." \
   | cviauto channel send impl-task --as dispatcher --to codex-impl --stdin
 ```
 
-`kill` flags:
-
-- `--as <agent>` **(required)** — names the worker (positional `<name>` is the channel).
-- `--scope <project|global>`.
-- `--force` — SIGKILL immediately (also kills the inner worker pid).
-
-Side effects: cleans `pid`, `worker-pid`, `config`, `spawnlock` sidecar
-files; keeps `log`, `session-id`, `thread-id` for forensics and resume.
-
-When `interrupt` will not converge, kill + `--resume` is the guaranteed
-redirection path.
-
-## Worker OOM Guard
-
-The OOM guard prevents orphaned/idle workers from accumulating and exhausting
-host resources. It runs at every `spawn` and enforces two policies per
-project bucket:
-
-- **Idle TTL** — sweep workers whose last activity is older than the
-  configured threshold (default `5m`; `0` disables).
-- **Live-worker budget** — refuse the new spawn if more than N workers are
-  already alive in the same project bucket (default `6`; `0` disables).
-
-Precedence (highest first):
-
-1. CLI flags: `--idle-timeout`, `--max-live-workers` on `spawn`.
-2. Environment variables: `TRELLIS_CHANNEL_WORKER_IDLE_TIMEOUT`,
-   `TRELLIS_CHANNEL_MAX_LIVE_WORKERS`.
-3. `.cviauto/config.yaml` under `channel.worker_guard`.
-4. Built-in defaults (`5m`, `6`).
-
-Cleanup notices are written to stderr at spawn time so operators can see which
-idle workers were swept and why a new spawn was rejected. The guard does not
-touch ephemeral / `channel run` workers any differently — they are subject to
-the same idle TTL and budget.
-
-To audit current state, list workers via `channel list` (the `WORKERS`
-column) and inspect per-channel `pid` / `worker-pid` sidecar files under
-`~/.cviauto/channels/<bucket>/<channel>/`.
-
-## Worker Inbox APIs
-
-The inbox is the channel surface workers wake on. Routing is controlled by
-two knobs:
-
-- **Inbox policy** (`spawn --inbox-policy`):
-  - `explicitOnly` (default) — worker only wakes on `send --to <worker>` or
-    `interrupt --to <worker>`.
-  - `broadcastAndExplicit` — also wakes on broadcasts (`send` with no `--to`).
-- **Delivery mode** (`send --delivery-mode`):
-  - `appendOnly` — append the event regardless of worker state.
-  - `requireKnownWorker` — fail if no worker named in `--to` was ever spawned.
-  - `requireRunningWorker` — fail if the named worker is not currently alive.
-
-Stricter delivery modes prevent silent message loss when callers expect a
-running peer.
-
-Inbox-relevant subcommands:
-
-- `send <channel> [text]` — append a `message` event.
-  - `--as <agent>` **(required)** — author.
-  - `--to <agents>` — CSV; one → string, many → array; broadcast if omitted.
-  - `--stdin` / `--text-file <path>` / `[text]` — body source.
-  - `--delivery-mode <appendOnly|requireKnownWorker|requireRunningWorker>`.
-- `interrupt <channel> [text]` — soft-interrupt redirect (see above).
-- `wait <channel>` — block until matching events arrive.
-  - `--as <agent>` **(required)** — `self` for filter context.
-  - `--from <agents>` — CSV authors.
-  - `--kind <kind[,kind...]>` — CSV (OR semantics); supports `interrupt`,
-    `done`, `progress`, etc.
-  - `--to <target>` — defaults to own agent (broadcast + explicit-to-me).
-  - `--include-progress` — also wake on progress events.
-  - `--all` — require every `--from` agent to match (timeout → exit **124**).
-  - `--timeout <duration>` — `30s` / `2m` / `1h` / `1000ms`.
-- `messages <channel>` — view / filter / follow the event stream.
-  - `--follow` to tail, `--kind` / `--from` / `--to` to filter, `--raw` for
-    JSON-per-line, `--no-progress` to hide progress noise.
-
-A typical dispatcher loop:
+`kill` 参数：
+
+- `--as <agent>` **（必需）** — 指定 worker 名称（位置参数 `<name>` 是通道名）。
+- `--scope <project|global>`。
+- `--force` — 立即 SIGKILL（同时也会 kill 内部 worker 进程）。
+
+副作用：清理 `pid`、`worker-pid`、`config`、`spawnlock` 附属文件；保留 `log`、`session-id`、`thread-id` 用于取证和恢复。
+
+当 `interrupt` 无法收敛时，kill + `--resume` 是保证重定向的路径。
+
+## Worker OOM Guard（内存溢出防护）
+
+OOM guard 防止孤儿/空闲 worker 不断累积并耗尽宿主机资源。它在每次 `spawn` 时运行，对每个项目 bucket 执行两项策略：
+
+- **空闲 TTL（Idle TTL）** — 清理最后活动时间超过配置阈值（默认 `5m`；`0` 禁用）的 worker。
+- **存活 worker 数量上限（Live-worker budget）** — 如果同一项目 bucket 中已有超过 N 个 worker 存活，则拒绝新的 spawn（默认 `6`；`0` 禁用）。
+
+优先级（从高到低）：
+
+1. CLI 参数：`spawn` 上的 `--idle-timeout`、`--max-live-workers`。
+2. 环境变量：`TRELLIS_CHANNEL_WORKER_IDLE_TIMEOUT`、`TRELLIS_CHANNEL_MAX_LIVE_WORKERS`。
+3. `.cviauto/config.yaml` 中的 `channel.worker_guard`。
+4. 内置默认值（`5m`、`6`）。
+
+清理通知会在 spawn 时写入 stderr，以便运维人员查看哪些空闲 worker 被清理，以及新 spawn 被拒绝的原因。guard 对临时 worker / `channel run` worker 没有特殊对待——它们同样受空闲 TTL 和数量上限约束。
+
+要审计当前状态，可通过 `channel list`（`WORKERS` 列）列出 worker，并检查 `~/.cviauto/channels/<bucket>/<channel>/` 下的 `pid` / `worker-pid` 附属文件。
+
+## Worker 收件箱 API（Worker Inbox APIs）
+
+收件箱是 worker 在通道中醒来时面对的界面。路由由两个旋钮控制：
+
+- **收件箱策略（Inbox policy）**（`spawn --inbox-policy`）：
+  - `explicitOnly`（默认）— worker 仅在 `send --to <worker>` 或 `interrupt --to <worker>` 时醒来。
+  - `broadcastAndExplicit` — 同时也会在广播（不带 `--to` 的 `send`）时醒来。
+- **投递模式（Delivery mode）**（`send --delivery-mode`）：
+  - `appendOnly` — 无论 worker 状态如何，始终追加事件。
+  - `requireKnownWorker` — 如果 `--to` 指定的 worker 从未被 spawn 过，则失败。
+  - `requireRunningWorker` — 如果指定 worker 当前不在运行，则失败。
+
+更严格的投递模式可防止调用方期望对等 worker 正在运行但消息被静默丢弃的情况。
+
+收件箱相关子命令：
+
+- `send <channel> [text]` — 追加一条 `message` 事件。
+  - `--as <agent>` **（必需）** — 作者。
+  - `--to <agents>` — CSV 格式；单个 → 字符串，多个 → 数组；省略则广播。
+  - `--stdin` / `--text-file <path>` / `[text]` — 消息正文来源。
+  - `--delivery-mode <appendOnly|requireKnownWorker|requireRunningWorker>`。
+- `interrupt <channel> [text]` — 软中断重定向（见上文）。
+- `wait <channel>` — 阻塞直到匹配的事件到达。
+  - `--as <agent>` **（必需）** — 用于过滤器上下文的 `self`。
+  - `--from <agents>` — CSV 格式的作者列表。
+  - `--kind <kind[,kind...]>` — CSV（OR 语义）；支持 `interrupt`、`done`、`progress` 等。
+  - `--to <target>` — 默认为自己的 agent（广播 + 显式发给自己的）。
+  - `--include-progress` — 同时也在 progress 事件上醒来。
+  - `--all` — 要求 `--from` 中的每个 agent 都匹配（超时 → 退出码 **124**）。
+  - `--timeout <duration>` — `30s` / `2m` / `1h` / `1000ms`。
+- `messages <channel>` — 查看 / 过滤 / 跟踪事件流。
+  - `--follow` 持续跟踪，`--kind` / `--from` / `--to` 过滤，`--raw` 输出每行 JSON，`--no-progress` 隐藏 progress 噪声。
+
+典型的 dispatcher 循环：
 
 ```bash
-# 1. Wake the worker.
+# 1. 唤醒 worker。
 echo "Run the failing test and report." \
   | cviauto channel send impl-task --as dispatcher --to codex-impl --stdin \
       --delivery-mode requireRunningWorker
 
-# 2. Block until it finishes.
+# 2. 阻塞直到它完成。
 cviauto channel wait impl-task --as dispatcher \
   --from codex-impl --kind done,error --timeout 30m
 
-# 3. Read the final answer.
+# 3. 读取最终结果。
 cviauto channel messages impl-task --from codex-impl --last 1 --raw
 ```
 
-All event-emitting subcommands (`send`, `interrupt`, `post`, `context add` /
-`delete`, `title set` / `clear`, `thread rename`) print the appended event as
-a single JSON line on stdout, making the inbox layer easy to script against.
+所有产生事件的子命令（`send`、`interrupt`、`post`、`context add` / `delete`、`title set` / `clear`、`thread rename`）都会将追加的事件以单行 JSON 输出到 stdout，使收件箱层便于脚本化操作。

package/dist/templates/common/bundled-skills/trellis-channel/references/workflows.md

@@ -1,12 +1,11 @@
-# Workflows
+# 工作流（Workflows）
 
-Use these patterns by intent. Prefer durable channels for multi-round work and
-`channel run` for one-shot questions.
+按意图选择使用模式。多轮工作优先使用持久化频道（durable channel），一次性问题使用
+`channel run`。
 
-## Pattern A: Multi-round Brainstorm
+## 模式 A：多轮头脑风暴（Multi-round Brainstorm）
 
-Use when the user says "和 codex/claude 讨论一下", "brainstorm", or "拉一个 agent
-进来一起看".
+当用户说"和 codex/claude 讨论一下"、"brainstorm"或"拉一个 agent 进来一起看"时使用。
 
 ```bash
 cviauto channel create brainstorm-storage-layer --by main \
@@ -25,30 +24,27 @@ cviauto channel wait brainstorm-storage-layer \
   --as main --kind done --from cx-arch --timeout 10m
 ```
 
-Do not stop after one answer. Read the answer, identify vague areas, send a
-new probe, and repeat until the result is executable.
+不要一轮回答就停止。阅读回答，找出模糊之处，发起新的追问，反复迭代直到结果可执行。
 
-Minimum round structure:
+最低轮次结构：
 
-1. Direction split: should this live in an existing mechanism or a new one?
-2. MVP boundary: v1, v2, and what would force v2 back into v1.
-3. Data contract: events, schema, metadata, state source of truth, compatibility.
-4. CLI / UX contract: command names, flags, errors, defaults, ambiguity.
-5. Cross-layer risk and tests: shared helpers, drift points, release-blocking tests.
+1. 方向拆分（Direction split）：该功能应放在现有机制中还是新建机制？
+2. MVP 边界（MVP boundary）：v1、v2 范围，以及什么情况下需要将 v2 内容提前纳入 v1。
+3. 数据契约（Data contract）：事件（events）、schema、元数据（metadata）、状态真实来源（state source of truth）、兼容性。
+4. CLI / UX 契约（CLI / UX contract）：命令名称、flags、错误、默认值、歧义处理。
+5. 跨层风险与测试（Cross-layer risk and tests）：共享辅助模块、偏移点（drift points）、阻止发版的测试项。
 
-Optional rounds:
+可选轮次：
 
-- Operations: logs, debugging, stuck workers, kill/restart, recovery.
-- Migration/release: breaking status, manifest, changelog, docs-site.
-- Opposition review: ask the peer agent to argue against the current plan.
+- 运维（Operations）：日志、调试、卡住的 worker、kill/restart、恢复。
+- 迁移/发布（Migration/release）：breaking 状态、manifest、changelog、文档站点。
+- 反向审查（Opposition review）：让对端 agent 对当前方案提出反对意见。
 
-Every probe should request concrete file paths, commands, schema, rejected
-alternatives, and release-blocking issues. Reject hedging when a decision is
-needed.
+每次追问应要求给出具体的文件路径、命令、schema、被否决的替代方案以及阻止发版的问题。当需要决策时，拒绝含糊其辞。
 
-## Pattern B: Implement / Check Agent
+## 模式 B：实现 / 审查 Agent（Implement / Check Agent）
 
-Use when the user asks to dispatch implementation or review work.
+当用户要求派发实现或审查工作时使用。
 
 ```bash
 TASK=.cviauto/tasks/05-12-foo
@@ -67,13 +63,11 @@ cviauto channel wait cr-foo --as main --kind done --from check --timeout 15m
 cviauto channel messages cr-foo --kind message --from check --tag final_answer
 ```
 
-For implement work, use `--agent implement` and send an implementation brief.
-For check work, include the exact diff scope, relevant specs, and validation
-already run.
+实现工作使用 `--agent implement` 并发送实现简报（implementation brief）。审查工作需包含确切的 diff 范围、相关规格说明以及已运行的验证。
 
-## Pattern C: Parallel Reviewers
+## 模式 C：并行审查者（Parallel Reviewers）
 
-Use one channel and distinct worker names.
+使用一个频道和不同的 worker 名称。
 
 ```bash
 cviauto channel create cr-feature --by main --ephemeral
@@ -91,26 +85,24 @@ cviauto channel send cr-feature --as main --to check-cx --text-file /tmp/cr-brie
 cviauto channel wait cr-feature --as main --kind done --from check,check-cx --all --timeout 15m
 ```
 
-`--all` means every listed worker must emit a matching event.
+`--all` 表示每个列出的 worker 都必须发出匹配的事件。
 
-## Pattern D: One-shot Worker
+## 模式 D：一次性 Worker（One-shot Worker）
 
 ```bash
 cviauto channel run --provider codex --message "say hi in 3 words" --timeout 1m
 cviauto channel run --agent plan --message-file /tmp/plan-question.md --timeout 10m
 ```
 
-On success, `run` removes the ephemeral channel. On error/timeout/killed, it
-keeps the channel and prints the path for inspection.
+成功时，`run` 会删除临时频道。出错/超时/被 kill 时，会保留频道并打印路径以供检查。
 
-## Pattern E: Forum Channel
+## 模式 E：论坛频道（Forum Channel）
 
-Use for issue forums, topic-style feedback, release todos, agent findings, and
-internal changelogs. Read `forum.md` for the full model.
+用于问题论坛、主题式反馈、发布待办、agent 发现和内部 changelog。完整模型请阅读 `forum.md`。
 
-## Pattern F: Take Over Existing Thread
+## 模式 F：接管已有线程（Take Over Existing Thread）
 
-If the user gives a forum/thread name, restore context yourself:
+如果用户给出了论坛/线程名称，自行恢复上下文：
 
 ```bash
 cviauto channel forum <board> --scope global
@@ -119,10 +111,10 @@ cviauto channel context list <board> --scope global --thread <thread>
 cviauto channel messages <board> --scope global --raw --thread <thread>
 ```
 
-Output a constraint summary, not a transcript dump:
+输出约束摘要，而非原文转储：
 
-- user-level problem
-- context files that affect this repo
-- current-version versus future-version requirements
-- whether current code/design satisfies it
-- next action or comment to append
+- 用户层面的问题
+- 影响此仓库的上下文文件
+- 当前版本 vs 未来版本的需求
+- 当前代码/设计是否满足
+- 下一步操作或待追加的评论