Pacing And Estimation

pacing-and-estimation — 消费 ccm 只读 advisory 配速 + 估算

> 分发 skill（随插件 ship）。 ccm 的 usage / estimate / baseline 是 cc-master 的只读 advisory——出 verdict / 数据，不替 orchestrator 决策。本 skill 是它们的消费手册：不是「该不该减速/换号/停派」（那是 master-orchestrator-guide 的编排决策），而是「既然要 pace / 要估算，怎么读这些 advisory 的 verdict 与字段、怎么喂回你的判断」。 > > 职责边界：消费机制归本 skill；决策归 master-orchestrator-guide；命令怎么敲 / board 字段怎么填归 using-ccm；走廊数学 / 估算算法的实现 SSOT 在 ccm 引擎。Codex 下当前只消费当前账号 5h/7d 用量与 host-neutral 估算，不消费其他 harness 的账号池切号、statusline sidecar、模型档位表。

---

何时翻开本 skill

你在一场长跑里要消费 ccm 的只读 advisory 做配速或估算判断的输入时——把长跑对照配额窗口 pace、选模型档、估工期/风险、读 ccm usage advise / ccm estimate forecast 的输出——就用本 skill 把 verdict 与字段读对。深度按轴分进 reference：完整 reference 列表 + 何时翻哪份，见文末 [Pointers](#pointers)。

---

心智锚 1：ccm 出 verdict，你（orchestrator）决策

ccm usage / estimate 是只读 advisory——它替你算（走廊数学、MC 工期仿真、EVM、风险指数），吐一个 verdict 或一组带诚实字段的数。它不替你拍「该不该减速 / 该不该 surface 用户 / 该不该换号」。本 skill 教你读 verdict + 解读字段；读完之后的动作永远回到 master-orchestrator-guide（「量力而行」镜头、「该问就问」镜头、决策程序的 7d 总闸）。

• 别自己重算引擎已经算好的东西（DRY）：ccm usage advise 已把账户 used_percentage + resets_at + effective-N 喂进引擎走廊数学，你读它的 verdict 字段即可，不必自己拿百分比重算走廊上下沿。
• 诚实降级是 advisory 的一等公民：账户信号不可得 → available:false（exit 0，不是 exit 1）。这不是错误、是「pacing 此刻不可判」——别据空信号瞎催。

心智锚 2：pacing verdict 是单侧的，直接对应一个 lever 类

ccm usage advise --json 出单侧走廊 verdict（5 值 enum·没有旧模型里的 accelerate 欠用侧加速与 hard_stop）——只在逼近走廊上界时出声（临界减速 / 换号 / 停），走廊内静默：

| verdict | 含义 | 对应 lever 类（怎么做见 pacing-levers.md） | |---|---|---| | hold | 在走廊内，维持 | ——（静默） | | throttle | 5h 临界减速 | 降档模型 / 降 WIP / 推迟 high-float | | switch | 当前 5h 临界但 Codex adapter 不支持账号池切换 | 不切号；当作强节流/停派信号处理，优先降 WIP / 推迟 float / 等 reset 或 surface 用户 | | stop_5h | 5h 本窗口烧穿·无可切备号 / 7d 亦吃紧 | 停派新工作，记录 reset 后的 Codex recon；如果你有已配置的 Codex thread automation 或外部 scheduler，就把它作为 watchdog 句柄写进 board，否则 surface 给用户约定回来检查。 | | stop_7d | 7d≥85% 跨窗口硬总闸 | 停派新节点、surface 用户拍板（动作归 master-orchestrator-guide「量力而行」/「该问就问」镜头 + 决策程序） |

附字段：strength（标签强度 weak\|strong·ccm 出、注入方直接用）、nearest_reset（stop_* 时该窗 reset 时刻·引导 arm wakeup）、switch_candidate（switch verdict 时推荐切入的备号·切不切由编排层 + 用户拍）、pool（号池粗粒度 { backups, switchable }）。stop_7d 是最该认真对待的 verdict——7d 是不可逆的跨窗口消耗边界，读到它就把决策 surface 回编排层，绝不当 FYI 自行越过。stop_5h 则是「本窗口这份配额烧穿了」——不是终点、是 arm 一个自我唤醒守到 reset 回血的信号。

心智锚 3：estimate 整轴别 out-of-mind

模型默认想不到去查估算——能力（ccm estimate 5 verb）就绪，消费层从不被召回。在三个拍子主动 consult estimate（操作化「何时查 → 读哪字段 → 判什么」详见 estimation.md）：

• dispatch / 排期拍：ccm estimate forecast 出目标 ETA（p50/p80/p95 双通道 MC）——读 p80 对照 deadline，超了就是 replan / surface 信号。
• recon / 中途拍：ccm estimate evm 出 CPI/SPI（进度/成本偏差）——SPI --json # 单任务 token 成本

ccm estimate forecast --json # 目标 ETA：p50/p80/p95 双通道 MC ccm estimate evm --json # CPI/SPI 进度成本偏差（需 baseline 作前置） ccm estimate risk --json # 综合风险指数 ccm estimate cost-to-complete --json ccm baseline snapshot # iteration 起点基线（EVM 的 plan SSOT·写 noun）

命令怎么敲、每个 flag、`--json` 形状看 `using-ccm` 的 command catalog。本 skill 只教消费这些输出。

## footgun 速查

| 现象 | 真相 / 怎么做 |
|---|---|
| `ccm usage advise` 出 `available:false` | Codex 当前账号信号不可得；保守派发，不要反推。 |
| 看到 `switch` | Codex adapter 不支持账号池切换；不要执行账号切换命令。 |
| 想精确把 used% 收敛到 100% | 做不到（结构性硬墙：账户口径无绝对 token 分母 + burn 与额度不在同一可信路径）。只做方向性走廊。详见 usage-signals.md 诚实天花板。 |
| `estimate evm` 报没有 baseline | EVM 死依赖 baseline 作 plan 基线——先 `ccm baseline snapshot`（见 estimation.md baseline 生命周期）。 |
| forecast 给了点估就当承诺 | 先读诚实字段（coverage_pct / confidence / conformal 区间）——cold-start / 低覆盖时点估不可信，降低信任权重。 |
| 把 `stop_5h` 当终点 | `stop_5h` 是「本窗口这份 5h 配额烧穿」——不是任务失败，是 arm 一个 watchdog 守到 `nearest_reset` 回血再续派的信号（换号无门时的兜底）。见 pacing-levers.md。 |

---

## Pointers

- **[references/usage-signals.md](references/usage-signals.md)** —— Codex 当前账号 5h / 7d 信号源、`available:false` 降级、诚实边界。
- **[references/pacing-levers.md](references/pacing-levers.md)** —— 单侧 levers（减速 / 停）怎么做；Codex 下 `switch` 不执行账号池切换，降级为 throttle / 等待 / surface 用户。
- **[references/estimation.md](references/estimation.md)** —— estimate verb 的消费决策、baseline 生命周期、诚实字段、usage 与 estimate 的张力。
- **using-ccm** —— ccm 命令怎么敲、board 字段怎么写。
- **master-orchestrator-guide** —— 决策层；Codex adapter 只消费这里的 advisory，不把其他 harness 的 account/statusline/model-tier 机制投影过来。
- 实时真相永远以 `ccm   --help` 为准 + ccm 引擎是走廊数学 / 估算算法的实现 SSOT——本文是消费视图，不复述数学。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nemori-ai](https://github.com/nemori-ai)
- **Source:** [nemori-ai/cc-master](https://github.com/nemori-ai/cc-master)
- **License:** MIT

Install and usage instructions live in the source repository linked above.