---
name: cm-runtime
description: 用户要查看或切换 CM 自动派发偏好、单/双 AI 声明、谁写谁审，或修改用户级运行时默认时使用。只管理运行时声明，不安装工具、不测试配额、不接管正在运行的任务。
---

# cm-runtime — 运行时声明

执行前读取 `../../runtime/project-context.md`、`../../runtime/workflow-config.md` 与
`../../runtime/logging.md`。Codex 入口 `$cm-runtime`；Claude Code 入口 `/cm-runtime`，
macOS/Linux 兼容别名 `/cm:runtime`。这是独立配置工具，不进入 N1–N8，不创建业务任务。

从当前 Skill 目录解析 `{CM_WORKFLOW_ROOT}`。无参数调用时，不直接启动依赖 TTY 的脚本；
由当前会话用 AskUserQuestion 或纯文本完成下列流程。使用**用户当前对话语言**，
中文对话用中文、英文对话用英文，编号、含义与终端一致；文案以
`../../scripts/cm-runtime-i18n.mjs` 为准，预设名与机器字段不翻译。

先执行只读 `show --project "{代码项目路径}"`，展示有效配置、来源及模型别名，再给出：
`[1] 保留当前配置（推荐，默认） / Keep current configuration (recommended, default)`、
`[2] 修改运行时预设 / Change runtime preset`、
`[3] 查看高级模型配置说明 / Advanced model configuration`。
选 1 结束，未声明时保留内置默认，不创建文件。选 3 只展示下述高级说明，不接着询问模型或预设。
配置无效时报告原始字段/路径错误、保留文件并结束，不能把无效配置说成默认有效或自动修复。
只有明确选 2 才进入修改：

1. 改哪一层？/ Which scope? `[1] 当前项目 / Current project`（显示检测到的配置路径）
   `[2] 用户级默认 / User default`（`~/.cm-workflow/runtimes.yml`）。有项目配置默认 1，
   无配置默认 2；无配置仍选 1 时，提示将从模板新建 `.cm-workflow.yml`。
2. 你手上有哪个 AI 工具？/ Which AI tools do you have?
   `[1] 只有 Codex / Codex only` `[2] 只有 Claude / Claude only` `[3] 两个都有 / Both`。
   此问无默认，必须选择；选 3 再问：谁写代码？/ Who writes code?
   `[1] Codex（Claude 审，推荐）/ Codex (Claude reviews, recommended)`
   `[2] Claude（Codex 审）/ Claude (Codex reviews)`，默认 1。
3. 执行只读 `preview <preset> --project "{代码项目路径}"`；用户范围用 `preview <preset> --user`，
   工作目录必须是代码项目根，以便核对该项目的覆盖关系。可加 `--json` 读取结构化结果。
   展示目标文件/范围、字段前后值、当前项目保存前后的有效值及模型兼容性提示，保留返回的
   `preview_sha256`，询问确认 / Confirm? `[y/N]`，默认不保存。
4. 只有用户明确同意才调用相同项目、范围、预设、语言和运行时环境的
   `set ... --expect-preview <preview_sha256>`。不得用普通 `set` 绕过摘要校验。
   配置漂移或校验失败时保留文件，重新预览并取得新的确认，不沿用旧批准。
   成功后执行 `show --project "{代码项目路径}"` 并回显。

工具选 1/2 分别映射 `codex-only`/`claude-only`；两个都有、写代码选 1/2 分别映射
`codex-codes`/`claude-codes`。取消、拒绝确认或必选问题连续三次空输入时放弃，不写。
会话没有回复不代表回车或确认，不得因等待超时执行；选择了修改也不等于批准保存。
用户声明被项目覆盖时如实报告当前项目不会切换。摘要仅用于预览一致性，不是用户授权证据。

显式自然语言“看看配置”映射 `show`。带 `show` / `set` / `unset` 参数直接执行，
修改意图缺少预设/范围时只补问缺失项。执行示例：

```bash
node "{CM_WORKFLOW_ROOT}/scripts/cm-runtime.mjs" show --project "{代码项目路径}"
node "{CM_WORKFLOW_ROOT}/scripts/cm-runtime.mjs" preview codex-codes --project "{代码项目路径}"
node "{CM_WORKFLOW_ROOT}/scripts/cm-runtime.mjs" set codex-codes --project "{代码项目路径}" --expect-preview "{preview_sha256}"
node "{CM_WORKFLOW_ROOT}/scripts/cm-runtime.mjs" set codex-codes --project "{代码项目路径}"
node "{CM_WORKFLOW_ROOT}/scripts/cm-runtime.mjs" set --user claude-codes
node "{CM_WORKFLOW_ROOT}/scripts/cm-runtime.mjs" unset --user
```

- 四个预设为 `codex-only`、`claude-only`、`codex-codes`、`claude-codes`；映射以共享配置合同为准。
- `show` 只读，打印有效声明、预设、coder/reviewer adapter、source、model 与 `runtimes_source`、声明路径；CLI 缺失只 WARN，可解析不证明配额可用。
- `preview` 只读、不记日志，复用同一配置校验；摘要绑定项目、范围、预设、候选内容和相关配置快照（含继承来源及新建模板）。终端向导和安装器同样在保存前核对快照。
- `set` 默认项目级；只修改 `runtimes.available` 与 coder/reviewer 的 adapter/source，其他原文保留；新文件从模板生成。校验失败不写。
- `set --user` 写 `~/.cm-workflow/runtimes.yml`（测试可用 `CM_WORKFLOW_HOME` 指定目录）；`unset --user` 删除该文件，不删除项目声明。
- 解析顺序：项目 > 用户级默认 > 未声明；项目显式角色字段保留，冲突阻断。用户默认仅在项目没有 `runtimes.available` 时读取。
- 成功 `set` 复用统一日志 writer 写 `decision/route`；日志使用独立 run id，不绑定 specs、不改已有 run 指针。`show` 不记日志。

高级说明：建议保留当前默认，仅有明确需要时手工编辑项目配置中的模型别名，并执行
`node "{CM_WORKFLOW_ROOT}/scripts/cm-workflow-config.mjs" --project "{代码项目路径}" --print-effective`。
详见 `../../runtime/workflow-config.md`。预设切换保留模型；更换 adapter 后，旧的非默认模型未必兼容。
校验仅证明配置合同有效，不证明 provider 支持、可调用或配额可用。这里不提供任意模型编辑器。
`unset --user` 只删除用户默认，项目声明仍优先；它不是恢复所有配置默认值的命令。

报告命令原始结果、写入路径、预设与来源；失败报告原因。若提示“preference saved, decision log failed”，明确配置已写、日志未成功，不伪称完全成功。

只改变新 run 的自动派发偏好；已创建 run 绑定其原配置，本命令不修改它们。
不执行安装、不改 settings、CLAUDE.md、任务状态或审查证据，不联网、不调用模型、不探测配额。