Cool Workflow

从 AI Agent 获取已保存的报告，让每条结论都对应到一行代码——而不是一条转眼就会丢失的聊天答案。

这是什么？

Cool Workflow（cw）是一款轻巧的命令行工具，可将 AI 编码 Agent 的聊天答案——容易丢失，也难以核查——转变为已保存的报告。将它指向代码仓库或任意文档文件夹即可：

• 它会规划工作。 将你的问题拆分为一组小任务。
• 由你的 Agent 完成工作。 CW 本身绝不运行模型——由你自己的 Agent 阅读并思考。
• 它会生成经过核查的报告。 每条结论都指向代码中的真实位置，例如 file.ts:42。没有证据的结果会被拦截，而不会直接放行。

模型是燃料。CW 是黑匣子记录仪、仪表盘和变速箱——绝不是引擎。 它绝不会调用模型 API、保存你的密钥，也不会上传你的代码。

安装

npm install -g cool-workflow

brew tap coo1white/cool-workflow https://github.com/coo1white/cool-workflow
brew install coo1white/cool-workflow/cool-workflow
cw version

你需要： Node.js v22.13 或更新版本。还没有 Agent？下面的步骤 1 仍然有效——CW 本身绝不运行模型。

兼容你的 Agent

不确定自己安装了什么？cw doctor 会检查你的设置，cw fix 会打印修复设置所需的命令。

快速开始

1 · 查看运行效果——30 秒，无需 Agent

cw demo tamper
# → builds a real signed ledger, forges it three ways, catches all three offline
# → VERDICT: tamper-evidence holds ✓

2 · 提出一个关于代码的问题——只需一条命令

cw -q "How does auth work end-to-end here?"

CW 会使用当前代码仓库，以及它在你的 PATH 中找到的第一个 Agent。想指定某个 Agent？添加上表中的标志，例如 -claude。

在真实代码仓库上完成一次完整审查大约需要 4 分钟（14 个工作器；Map 和 Assess 阶段会同时运行）。只想问一个聚焦的问题？添加 --fast：使用 6 个工作器而非 14 个，以更少的 Agent 调用获得同样带引用的答案。

3 · 打开报告

运行结束时，报告会自动在浏览器中打开。报告开头是答案，随后是支撑答案的证据。之后可使用以下命令再次打开：

cw report --open

想先看看示例？一个真实运行的 Workbench 和报告会在每次推送时重新构建：coo1white.github.io/cool-workflow（报告位于 /report.html）。

这三个步骤就是核心流程。其余功能只维护现状，不再扩展。

你能信任这份报告吗？

CW 不运行模型——它负责记录。你的 Agent 会为其发现签名（ed25519），而 cw report verify-bundle 会仅使用公钥离线检查，确保报告中的每项已签名发现都未经篡改。CW 不持有私钥：Agent 负责签名，CW 只负责验证。这能证明已签名的发现未经篡改地传达给了你——但不能证明没有添加其他内容，也不能证明没有遗漏任何内容。请参阅 信任模型。

故障排除

了解更多

• 用户指南 — 你的前十分钟
• 为什么选择 Cool Workflow
• 工作原理
• 可以运行什么
• 从编辑器中使用
• 信任与审计
• 仓库地图
• Wiki 首页

CW 以自己的发布流程为实战检验：每次发布都会针对此仓库运行 release-cut。

许可证

BSD-2-Clause。由 COOLWHITE LLC 构建。