kingxiaozhe/cm-workflow

<p align="center"> <img src="./assets/readme/hero.svg" width="100%" alt="CM means Create More：把需求变成有规格、测试和审查记录的代码交付"> </p>

CM Workflow

安装在 Codex 或 Claude Code 中的规格驱动开发工作流。 从明确需求、人工确认，到实现、独立审查与测试，让每项交付都有可检查的依据。

<p> <a href="https://github.com/kingxiaozhe/cm-workflow/actions/workflows/ci.yml"><img src="https://github.com/kingxiaozhe/cm-workflow/actions/workflows/ci.yml/badge.svg" alt="CI status"></a> <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-151515" alt="MIT License"></a> <img src="https://img.shields.io/badge/Codex-native-2E6655" alt="Codex native"> <img src="https://img.shields.io/badge/Claude%20Code-compatible-C44B32" alt="Claude Code compatible"> </p>

快速开始 · 升级旧版本 · 选择命令 · 支持范围 · 使用手册 · 更新日志

最近更新

0.16.7

• 首次规划按目标组织任务：相关低风险文案、样式和小交互可合并为能独立验证和回滚的任务；保护基线、明确独立边界及真实契约依赖继续保留。
• 既有运行保持兼容：不改角色配置、已有任务列表或每任务 N4 独立审查；在途规划请求继续使用原始指引。
• 收益仍待验证：有限规划对照为 2→2、4→4，未显示任务数下降，也未证明 token 或费用节省；高风险仅验证原设计门禁。

0.16.6

• 运行时配置默认保留：打开 cm-runtime 先看当前配置和来源，主动选择修改才进入预设向导；高级模型入口只提供说明和校验方法。
• 外部模型按 provider 配置：单任务、批次及修复可显式启用 cm-model-setup.mjs 的模型及可选强度；宿主保持当前模型，run 冻结参数，未知调用停止重派。见配置与恢复边界。
• 确认前看清影响：预览目标、字段变化和项目覆盖关系，最终 [y/N] 回车不保存；确认期间配置改变会要求重新预览。安装后的配置可跳过，已有用户默认优先保留。
• 保留模型别名并提示兼容性：切换预设不改已有模型或正在运行的任务；配置校验不代表新适配器一定支持该模型。

0.16.5

这一版修的都是拿 cm-ai 跑真实项目（AI潮）时撞上的阻断：跑到一半卡死、报错看不懂、只能手改文件才能继续的情况，现在大多有了明确的出口。

• 中断和超时不再卡死运行：宿主在审查中途被杀或审查进程出错，可以在原运行上留痕放弃并重派审查；在开发或收尾中途被杀，可以留痕放弃这一步、正式关闭原运行，再新建运行重做；QA 评估超时、检查超时都能重试，环境原因造成的 QA 阻断可以在原代码上重跑。
• 重试是真的重做：审查退回后第二轮用第二轮的答案，清理后重试真正重跑开发，检查没过不送审；重试次数和收尾不会再撞上限把自己锁死。
• 规格中途改了也能接着跑：任务进行中重新批准规格，只要改动只涉及其他任务，就能显式换绑到新规格继续；批次成员会写明能走的出口。
• 报错说人话：启动参数不对会点名是哪个参数、和创建时哪里不同；cm-prd 审查闸门的每种拒绝都带固定错误码和原因，不再只报 unavailable；扫描代码目录时跳过系统和构建杂文件，出错写明路径。
• 规则任务（通常是 T-002）能用单任务驱动跑完：会话核验没通过时停在可重试的状态，改好后在原运行重新生成和核验，不会再落到无法恢复的 unknown。
• 重做任务会带上旧的审查意见：审查轮次用完后新建运行重做，第一轮