主题
09.5 CoWork 与 Claude Code 协同
两个引擎，一个管代码，一个管交付物。合起来是完整的工作流。
读完你能做什么：设计出让 CoWork 和 Claude Code 各展所长的双引擎工作流。
一、为什么要协同
它们的能力互补：
text
Claude Code CoWork
├─ 强：代码、git、测试 ├─ 强：文档、数据、非技术产出
├─ 强：终端、CLI、自动化 ├─ 强：面向非开发者的交互
├─ 弱：生成精美的 PPT/Word ├─ 弱：深度代码工程
└─ 面向：开发者 └─ 面向：知识工作者很多真实工作横跨两者：写完代码要出汇报，处理完数据要进版本库。单用一个都别扭。
二、分工原则
text
涉及代码仓库的一切 → Claude Code
涉及交付物/文档/数据的一切 → CoWork2.1 边界示例
| 任务 | 谁做 |
|---|---|
| 实现功能、修 bug、写测试 | Claude Code |
| 提 PR、代码审查 | Claude Code |
| 把 release 写成对外的 Word 说明 | CoWork |
| 给管理层做项目进展 PPT | CoWork |
| 从数据库导出数据做成 Excel 报表 | CoWork |
| 重构、迁移、CI 集成 | Claude Code |
三、四种协同模式
模式 1：Code 产出 → CoWork 包装
最常见。Claude Code 完成技术工作，CoWork 把结果变成对外交付物。
text
【Claude Code】
> 完成本次 release 的所有功能，整理出 CHANGELOG
【切换到 CoWork】
> 读这份 CHANGELOG，生成一份面向客户的 release note Word 文档，
语气友好，突出用户能感知的改进，隐藏技术细节模式 2：CoWork 分析 → Code 实现
CoWork 处理数据/需求，产出规格，Claude Code 据此编码。
text
【CoWork】
> 分析这份用户反馈 Excel，归纳出 top 10 的功能需求，
按影响面和实现成本排序，输出一份结构化清单
【Claude Code】
> 根据这份需求清单的第 1 项，实现对应功能模式 3：Web 设计 → Code 执行 → CoWork 汇报
三段式，各用最合适的入口。
text
【网页版】讨论架构方案（不消耗代码仓库上下文）
↓ 定稿
【Claude Code】实现方案
↓ 完成
【CoWork】生成给团队的技术方案 PPT 和决策记录文档模式 4：定时协同
CoWork 的定时任务触发对代码库的检查。
text
【CoWork 定时任务】
> 每周一早上，读取项目的 git 统计和 issue 状态，
生成一份项目健康度周报（这类跨代码库的定时检查，也可以直接用 Claude Code 的定时能力做，看你更习惯哪个入口。）
四、数据交接：怎么把结果从一个传到另一个
两个引擎不共享对话上下文，靠文件交接。
4.1 用共享文件夹
text
1. 建一个共享文件夹，两边都能访问
2. Claude Code 把产出（CHANGELOG.md、data.json）写进去
3. CoWork 挂载这个文件夹，读取并加工4.2 用结构化中间产物
交接的文件用结构化格式，便于下游解析：
text
【Claude Code 产出】
release-summary.json:
{
"version": "2.4.0",
"features": [...],
"fixes": [...],
"breaking_changes": [...]
}
【CoWork 消费】
读 release-summary.json，生成 release note结构化交接比"复制粘贴一段文本"可靠得多。
五、一个完整的双引擎工作流
「季度产品发布」全流程：
text
═══ 阶段 1：开发（Claude Code）═══
> 完成本季度规划的三个功能，走 TDD，每个功能一个 PR
> 全部合并后，生成一份 technical CHANGELOG，写到 docs/CHANGELOG-Q2.md
═══ 阶段 2：数据（Claude Code 或 CoWork）═══
> 从数据库导出本季度的使用数据，保存为 usage-Q2.csv
═══ 阶段 3：对外材料（CoWork）═══
挂载 docs 文件夹，然后：
> 基于 CHANGELOG-Q2.md 和 usage-Q2.csv：
1. 生成一份面向客户的 release note（Word，友好语气）
2. 生成一份面向管理层的季度汇报（PPT，含数据图表）
3. 生成一份内部的发布检查清单（Excel）
═══ 阶段 4：自动化（CoWork 定时任务）═══
> 设置每周一自动生成上周的产品使用简报四个阶段，代码工作在 Claude Code，交付物在 CoWork，靠 docs/ 文件夹交接。
六、什么时候不用切换
不要为了"用两个工具"而切换。判断标准：
text
任务的产出主要是代码/git 操作 → 就待在 Claude Code
任务的产出主要是文档/数据/文件 → 就待在 CoWork比如"改个 bug 并写测试"，全程 Claude Code，不需要 CoWork。"整理一堆 PDF"，全程 CoWork，不需要 Claude Code。
只有当一个任务真的横跨"代码"和"交付物"两个领域时，才需要协同。
七、协同的注意事项
| 注意 | 说明 |
|---|---|
| 上下文不互通 | 靠文件交接，不要指望一边知道另一边说了什么 |
| 交接文件放共享文件夹 | 确保两边都能访问 |
| 用结构化格式交接 | JSON/CSV 比自由文本可靠 |
| 各用所长 | 别让 Claude Code 硬做精美 PPT，也别让 CoWork 做深度重构 |
| 核对交接数据 | 跨引擎传递的数据要抽查 |