Claude Code 与 OpenClaw 深度集成指南：Subagent vs CC 决策树与实战方案

用户：帮我实现用户登录功能

我：该用 OpenClaw 的 subagent 还是 CC？
- 用 subagent？但需要多文件编辑...
- 用 CC？但需求确认流程不够严格...

CC 会话重启后：
- CLAUDE.md 没加载
- 项目规范要重新说
- 之前踩的坑又踩一遍

有时候 CC 写的代码：
- 不符合项目规范
- 测试覆盖率不够
- Git 提交不规范

用户请求
 ↓
┌─────────────────────────────┐
│ 1. 任务类型分析 │
└────────────┬───────────────┘
 ↓
 ┌─────────┴─────────┐
 │ │
┌───┴───┐ ┌───┴───┐
│代码类 │ │非代码类│
└───┬───┘ └───┬───┘
 ↓ ↓
┌─────────────────────────────┐
│ 2. 复杂度评估 │
└────────────┬───────────────┘
 ↓
 ┌─────────┴─────────┐
 │ │
┌───┴───┐ ┌───┴───┐
│简单 │ │复杂 │
└───┬───┘ └───┬───┘
 ↓ ↓
┌─────────────────────────────┐
│ 3. 是否需要 CC 特殊能力 │
│ - 深度项目理解 │
│ - 多文件编辑 │
│ - Git 自动化 │
│ - 测试自动运行 │
└────────────┬───────────────┘
 ↓
 ┌─────────┴─────────┐
 │ │
┌───┴───┐ ┌───┴───┐
│需要 │ │不需要 │
└───┬───┘ └───┬───┘
 ↓ ↓
┌─────────────────────────────┐
│ 4. 决策结果 │
│ - 使用 CC（exec 调用） │
│ - 使用 Subagent │
│ - 混合模式 │
└─────────────────────────────┘

exec({
    command: """claude '
任务：实现用户登录功能

需求：
1. 支持邮箱/密码登录
2. JWT Token 认证
3. 记住登录状态（7 天）

技术栈：
- Node.js + Express
- PostgreSQL
- jsonwebtoken

约束：
- 使用 TypeScript
- 编写单元测试
- 遵循 ESLint 规范

完成后：
- 运行测试
- Git 提交
- 报告结果
'"'",
    pty: True,
    background: True
})

OpenClaw 准备阶段:
1. 创建/更新 CLAUDE.md（项目级指令）
2. 创建需求文件（详细计划）
3. 创建 Skills（可选，自定义工作流）
 ↓
CC 启动自动加载:
1. 加载 CLAUDE.md（所有层级）
2. 加载 Skills 元数据
3. 加载 Auto Memory
 ↓
CC 执行:
1. 根据需求文件执行
2. 遵循 CLAUDE.md 约束
3. 使用 Skills 增强能力

# Project Instructions

## 项目概述
这是一个用户管理系统，使用 Node.js + TypeScript + PostgreSQL

## 编码规范
- 所有新代码使用 TypeScript
- 遵循 ESLint Airbnb 配置
- 所有函数必须有 JSDoc 注释
- 使用 conventional commits

## 技术栈
- **运行时**: Node.js 20
- **语言**: TypeScript 5
- **框架**: Express 4
- **数据库**: PostgreSQL 15
- **ORM**: Prisma
- **测试**: Jest

## 项目结构
src/
├── controllers/    # 请求处理
├── middleware/     # 中间件
├── routes/         # 路由定义
├── services/       # 业务逻辑
├── models/         # 数据模型
└── utils/          # 工具函数

## 测试要求
- 单元测试覆盖率 > 80%
- 所有 API 必须有集成测试
- 关键业务逻辑有 E2E 测试

## Git 工作流
- 功能分支：`feature/xxx`
- 提交格式：`type(scope): message`
- 必须 PR 审查后才能合并到 main

## 行为约束
- 修改现有代码前必须询问
- 每次变更后运行测试
- 不要直接提交到 main 分支
- 敏感信息不要提交

## 检查点
- 数据库设计后：等待确认
- API 实现后：运行测试并等待确认
- 前端实现后：E2E 测试并等待确认
- 提交前：代码审查

# 任务：实现用户管理系统

## 阶段 0：需求确认
**必须先完成此阶段，等待用户确认**

### 任务理解
请复述以下内容：
1. 核心功能是什么？
2. 用户场景有哪些？
3. 技术约束是什么？

### 实现方案
请提出：
1. 数据库设计（表结构、索引）
2. API 设计（端点、请求/响应）
3. 文件结构（需要创建/修改的文件）

### 验收标准
请列出：
1. 功能验收清单
2. 性能指标
3. 测试覆盖要求

**等待用户回复"确认"后再开始阶段 1**

---

## 阶段 1：数据库设计
**预计时间**: 30 分钟

### 任务列表
- [ ] 设计 users 表结构
- [ ] 创建 Prisma schema
- [ ] 编写迁移脚本
- [ ] 添加索引优化查询

### 输出文件
- `prisma/schema.prisma`
- `prisma/migrations/001_init/`

### 验证
```bash
npx prisma migrate dev
npx prisma studio

npm test
npm run test:integration

npm run test:e2e

---

## 五、完整集成方案

### 5.1 方案对比

| 维度 | 方式 1（命令描述） | 方式 2（文件+CLAUDE.md） |
|------|------------------|------------------------|
| **适用场景** | 简单任务 | 复杂任务 |
| **准备时间** | 5 分钟 | 30 分钟 |
| **执行时间** | 短 | 长（多阶段） |
| **上下文** | 有限 | 完整 |
| **可复用性** | 低 | 高 |
| **团队协作** | 否 | 是 |
| **质量保证** | 基础 | 完整体系 |

### 5.2 推荐工作流

---

## 六、实战示例

### 6.1 示例 1：简单任务（方式 1）

```python
# 快速修复 Bug
exec({
    command: """claude '
任务：修复登录失败问题

问题描述:
- 用户使用正确密码但登录失败
- 错误信息："Invalid token"
- 发生在 auth.controller.ts 的 login 函数

要求:
1. 定位问题根源
2. 修复代码
3. 运行测试验证
4. Git 提交

完成后报告修复内容。
'"'",
    pty: True,
    workdir: "~/project",
    background: True,
    timeout: 1800  # 30 分钟
})

# 创建项目级 CLAUDE.md
claudemd_content = """
# Project Instructions

## 技术栈
- Node.js 20 + TypeScript
- Express + Prisma + PostgreSQL

## 编码规范
- TypeScript 严格模式
- ESLint Airbnb
- 测试覆盖率 > 80%

## 行为约束
- 修改前询问
- 变更后测试
- 不直接提交 main

## 检查点
- 每阶段完成后等待确认
"""

write({
    path: "~/project/CLAUDE.md",
    content: claudemd_content
})

# 创建详细任务文件
task_content = """
# 任务：实现用户管理系统

## 阶段 0：需求确认
（等待用户确认）

## 阶段 1：数据库设计
（输出 schema.prisma, migrations）

## 阶段 2：API 实现
（输出 controllers, routes, services）

## 阶段 3：测试
（单元测试 + 集成测试）

## 阶段 4：验收
（全量测试 + 代码审查）
"""

write({
    path: "~/project/.claude/tasks/user-management.md",
    content: task_content
})

# 启动 CC（自动加载 CLAUDE.md 和任务文件）
exec({
    command: "claude '执行任务：.claude/tasks/user-management.md'",
    pty: True,
    workdir: "~/project",
    background: True,
    timeout: 7200  # 2 小时
})

# 定期监控进度
def check_progress():
    result = process({
        action: "poll",
        sessionId: session.sessionId,
        timeout: 60000
    })
    if result.output:
        print("进度:", result.output)