Claude Code Evolution：将 Claude Code 精华迁移到 OpenClaw 的完整指南

system-prompt/
├── core/                    # 核心身份（静态缓存）
│   ├── identity.md         # 人格定义
│   ├── safety.md           # 安全规则
│   └── capabilities.md     # 能力边界
├── tools/                   # 工具指导（静态缓存）
│   ├── file-operations.md  # 文件操作指南
│   └── agent-operations.md # Agent 协作指南
├── dynamic/                 # 动态内容（每会话更新）
│   └── session-context.md  # 会话上下文
└── implementations/         # TypeScript 实现
    ├── section-cache.ts    # Section 缓存
    ├── context-generator.ts # 上下文生成
    ├── agent-coordinator.ts # Agent 协调器
    └── memory-manager.ts   # 记忆管理器

# identity.md - 核心身份
你是 OpenClaw Agent...
# 包含角色定义、核心价值观、能力边界

# safety.md - 安全规则
禁止行为：
- 删除用户数据
- 执行未授权的系统命令
- ...

# capabilities.md - 能力边界
你可以：
- 读写文件
- 执行 shell 命令
- ...

__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__

# 以下内容每会话更新：
- 当前时间
- 用户偏好
- 会话历史摘要
- 最近记忆片段

// implementations/section-cache.ts
export const identitySection = systemPromptSection(
  'identity',
  () => loadFile('system-prompt/core/identity.md')
)

export const dynamicContextSection = DANGEROUS_uncachedSystemPromptSection(
  'dynamic-context',
  (options) => generateSessionContext(options.session),
  '动态上下文必须每轮重算'
)

// 带缓存的 section（默认）
systemPromptSection(name: string, compute: () => string)

// 无缓存的 section（每轮重算）
DANGEROUS_uncachedSystemPromptSection(
  name: string,
  compute: (options: DynamicOptions) => string,
  reason: string  // 为什么需要 uncached
)

// fork 任务：代码审查
const reviewTask = forkAgent('code-review', {
  gitDiff: diff,
  reviewDimensions: ['reuse', 'quality', 'efficiency']
})

// fork 任务特性：
// - 共享父级缓存
// - 独立执行不互相干扰
// - "Don't peek, Don't race"：不窥探彼此状态，不竞争资源

用户: /simplify

Agent: 启动代码审查...
      ├─ Agent 1: 代码复用审查
      │   └─ 发现 2 处可复用代码
      ├─ Agent 2: 代码质量审查
      │   └─ 发现 1 处质量改进点
      └─ Agent 3: 效率审查
          └─ 发现 1 处效率优化机会
      
      聚合结果: 4 条建议
      已应用修复。

// implementations/agent-coordinator.ts
export async function parallelReview(
  diff: string,
  dimensions: string[]
): Promise<ReviewResult[]> {
  const agents = dimensions.map(dim => createReviewAgent(dim))
  const results = await Promise.all(
    agents.map(agent => agent.review(diff))
  )
  return aggregateResults(results)
}

type TaskState =
  | LocalShellTask           // 本地 shell 命令
  | LocalAgentTask          // fork 子 agent（带 ProgressTracker）
  | RemoteAgentTask         // 远程 agent
  | InProcessTeammateTask   // 同进程 teammate
  | DreamTask              // 自动记忆整合（UI 可视化）
  | ...

interface ProgressTracker {
  // API token 累计值
  latestInputTokens: number   // 取最新（非累加）
  cumulativeOutputTokens: number  // 每 turn 求和
  
  // 进度跟踪
  steps: TaskStep[]
  currentStep: number
  
  // 状态
  status: 'pending' | 'running' | 'completed' | 'failed'
}

# 智弈项目约定

## 编码规范
- 使用 TypeScript strict mode
- API 路由使用 kebab-case
- 提交信息遵循 Conventional Commits

## 工作流
- 每天 02:00 自动备份
- 周五 22:00 周报

# 个人偏好（小桔）

## 回复风格
- 简洁直接，避免冗长
- 代码注释用英文
- 默认生成 WebP 封面

## 工作习惯
- 优先处理心跳任务
- 重大修改前先备份

用户: /simplify

Agent: 启动代码审查...
      ├─ Agent 1: 代码复用审查
      │   - 扫描重复逻辑
      │   - 识别可提取的 utility 函数
      │   └─ 发现 2 处可复用代码
      ├─ Agent 2: 代码质量审查
      │   - 检查命名规范
      │   - 验证错误处理
      │   └─ 发现 1 处质量改进点
      └─ Agent 3: 效率审查
          - 分析时间复杂度
          - 检查资源泄漏
          └─ 发现 1 处效率优化机会
      
      聚合结果:
      - 代码复用建议：提取 `formatDate` 函数
      - 质量改进：缺少 null 检查
      - 效率优化：循环内重复计算
      
      已应用修复，详情见 PR #123

用户: /remember

Agent: 开始记忆审查...
      
      Phase 1: 扫描记忆文件
      - CLAUDE.md: 12 条约定
      - CLAUDE.local.md: 5 条偏好
      - auto-extracted.json: 23 条自动记录
      
      Phase 2: 分类整理
      ## Promotions (3)
      1. "使用 bun 而非 npm" → CLAUDE.md (已存在)
      2. "偏好简洁回复" → CLAUDE.local.md (新增)
      3. "API 路由使用 kebab-case" → CLAUDE.md (已存在)
      
      ## Cleanup (2)
      1. 删除重复条目 "Always backup before deploy"
      2. 更新过期约定："Node 版本 18 → 20"
      
      Phase 3: 生成报告
      ✅ 3 条新增
      ✅ 2 条清理
      ⚠️ 5 条冲突（需人工确认）
      
      请审阅并批准每项变更。

用户: /debug 登录按钮点击无响应

Agent: 开始系统化调试...
      
      Phase 1: 信息收集
      - ✅ 理解症状：按钮点击后无视觉反馈
      - ✅ 最近变更：昨日修改了 auth 模块
      - ✅ 复现步骤：任意用户均可复现
      - ✅ 检查日志：无错误输出
      - ✅ 相关文件：src/components/LoginButton.tsx
      
      Phase 2: 根因分析
      假设 1: 事件监听器未绑定
        → 验证：console.log 未触发 ❌
      假设 2: CSS pointer-events: none
        → 检查：按钮样式正常 ❌
      假设 3: 异步操作阻塞 UI
        → 发现：useEffect 中未清理定时器
        → 根因：setInterval 泄漏导致事件循环阻塞 ✅
      
      Phase 3: 修复验证
      - 清理 useEffect 中的定时器
      - 添加 cleanup 函数
      - 手动测试：按钮响应正常 ✅
      - 运行回归测试：全部通过 ✅
      
      ✅ 问题已解决，PR #124 已提交

// 验证任务完成度
const verification = await verifyTask({
  taskDescription: '部署博客到 VPS',
  completionCriteria: [
    '文章已提交到 Git',
    '封面图存在且尺寸正确',
    '通过验证脚本',
    'GitHub Actions 构建成功',
    'VPS 部署完成',
    'CDN 缓存已清除'
  ]
})

// 输出：
// ✅ 文章已提交
// ✅ 封面图存在 (1920x1080, 3.4KB)
// ✅ 验证通过
// 🔄 GitHub Actions 构建中...
// ⏳ VPS 部署等待...
// ⚠️  CDN 缓存未清除（需手动）

git clone https://github.com/ra1nzzz/claude-code-evolution.git
cd claude-code-evolution
.\install.ps1

# 带参数
.\install.ps1 -Backup -Force

git clone https://github.com/ra1nzzz/claude-code-evolution.git
cd claude-code-evolution
chmod +x install.sh
./install.sh

# 带参数
./install.sh --backup --force

# 检查技能目录
ls ~/.stepclaw/skills/claude-code-*

# 检查系统提示词
ls ~/.stepclaw/workspace/system-prompt/

# 测试技能
/simplify
/remember
/debug
/verify

// cached: 首次计算，后续直接返回缓存
const identity = systemPromptSection('identity', () => {
  return loadFile('system-prompt/core/identity.md')
})

// uncached: 每轮重新计算
const dynamicContext = DANGEROUS_uncachedSystemPromptSection(
  'dynamic-context',
  (session) => generateContext(session),
  '需每轮更新以反映最新会话状态'
)

// dynamic/session-context.md 模板
---
当前时间: {{currentTime}}
会话时长: {{sessionDuration}}分钟
已执行命令: {{commandCount}} 个
最近文件访问: {{recentFiles}}
用户偏好: {{userPreferences}}
---

当前背景:
{{backgroundInfo}}

最近记忆:
{{recentMemories}}

export function generateSessionContext(session: Session): string {
  return renderTemplate('dynamic/session-context.md', {
    currentTime: new Date().toISOString(),
    sessionDuration: Date.now() - session.startTime,
    commandCount: session.commands.length,
    recentFiles: session.fileAccess.slice(-5).join('\n'),
    userPreferences: loadUserPreferences(),
    backgroundInfo: session.background || '无',
    recentMemories: getRecentMemories(session.id, 3)
  })
}

export async function coordinateAgents<T>(
  tasks: AgentTask<T>[]
): Promise<AggregatedResult<T>> {
  // 并行启动
  const promises = tasks.map(task => task.exec())
  
  // 等待所有完成（可设置超时）
  const results = await Promise.allSettled(promises)
  
  // 聚合
  return {
    successes: results.filter(r => r.status === 'fulfilled'),
    failures: results.filter(r => r.status === 'rejected'),
    summary: generateSummary(results)
  }
}

const review = await coordinateAgents([
  { name: 'reuse', agent: reuseReviewer, input: diff },
  { name: 'quality', agent: qualityReviewer, input: diff },
  { name: 'efficiency', agent: efficiencyReviewer, input: diff }
])

// 从对话中提取记忆
extractMemory({
  text: sessionHistory,
  types: ['preference', 'constraint', 'fact']
})

// 输出：
// {
//   additions: [
//     { type: 'preference', content: '喜欢简洁回复' },
//     { type: 'constraint', content: '绝不删除用户数据' }
//   ],
//   conflicts: [],  // 冲突检测
//   recommendations: ['建议添加到 CLAUDE.local.md']
// }

~/.stepclaw/
├── skills/
│   ├── claude-code-simplify/
│   ├── claude-code-remember/
│   ├── claude-code-verify/
│   └── claude-code-debug/
└── workspace/
    ├── system-prompt/
    │   ├── core/
    │   ├── tools/
    │   ├── dynamic/
    │   └── implementations/
    └── references/
        ├── task-system.md
        ├── agent-system.md
        ├── permission-system.md
        └── prompt-patterns.md