Synapse Brain Skill#

Synapse Brain = 持久调度 + 跨会话状态 + 子代理编排

核心理念：AI Agent 应该是持久的"大脑"，而非每次从零开始的无状态会话。

传统 AgentSynapse Brain会话每次从零开始状态持久化，醒来即恢复调度手动调用子代理自动路由、分配、追踪记忆随会话消失state.json 持久化协作独立工作调度 code/wiki 等 Skills

---

🚦 快速决策：我该用什么？#

text

你想做什么？
│
├─ 启动/恢复项目任务     → init（初始化 session）
│   └─ 例："继续做用户系统"、"开始新项目 X"
│
├─ 分配子任务给子代理    → dispatch（调度执行）
│   └─ 例："并行开发登录和注册"、"让 dev 实现导出"
│
├─ 查询任务状态           → status（状态查询）
│   └─ 例："现在进度如何？"、"昨天那个任务完成了没"
│
└─ 保存/恢复会话          → save/restore（状态管理）
    └─ 例："保存当前进度"、"恢复上次会话"

---

📋 命令速查卡片#

命令用途示例/synapse-brain init初始化/恢复项目 session/synapse-brain init my-project "用户系统"``/synapse-brain dispatch分发任务到子代理/synapse-brain dispatch "并行开发 A 和 B"``/synapse-brain status查询任务/子代理状态/synapse-brain status my-project``/synapse-brain save保存当前会话状态/synapse-brain save``/synapse-brain restore恢复上次会话/synapse-brain restore

---

Brain Agent 架构#

text

用户请求
    ↓
┌─────────────────────────────┐
│  Synapse Brain (持久调度)     │
│                             │
│  1. Session Restore          │ ← state.json 恢复上下文
│  2. Intent Classification    │ ← 识别意图类型
│  3. Task Routing             │ ← 路由到合适 Skill/Agent
│  4. Subagent Dispatch        │ ← 调用 OpenClaw 子代理
│  5. Result Aggregation       │ ← 汇总结果
│  6. State Persist            │ ← 保存状态到 state.json
└─────────────┬───────────────┘
              ↓
    ┌─────────┼─────────┐
    ↓         ↓         ↓
synapse-  synapse-  专业子代理
  code      wiki    (dev/qa/arch)

---

Session 持久化#

Brain 通过 state.json 维护跨会话状态：

json

{
  "session_id": "sess_20260410_001",
  "project": "my-project",
  "created_at": "2026-04-10T12:00:00Z",
  "updated_at": "2026-04-10T14:30:00Z",
  "tasks": [
    {
      "id": "task-001",
      "title": "用户登录功能",
      "status": "completed",
      "skill": "synapse-code",
      "mode": "lite",
      "agents_used": ["req-analyst", "developer", "qa-engineer"]
    },
    {
      "id": "task-002",
      "title": "用户注册功能",
      "status": "in_progress",
      "skill": "synapse-code",
      "mode": "lite",
      "stage": "DEV"
    }
  ],
  "subagents": {
    "active": 1,
    "completed": 3,
    "failed": 0
  },
  "knowledge": {
    "wiki_initialized": true,
    "wiki_root": "~/my-project/wiki",
    "last_ingest": "2026-04-10T13:00:00Z"
  }
}

---

子代理调度策略#

Brain 根据任务特征自动选择调度策略：

策略触发条件行为sequential任务有依赖关系依次执行子代理parallel任务独立可并行同时派发最多 8 个子代理pipeline标准开发流程REQ→ARCH→DEV→INT→QA→DEPLOYstandalone简单任务Brain 直接完成，不调子代理

---

与 synapse-code 互操作#

bash

# Brain 调度 code 执行开发任务
/synapse-brain dispatch "实现用户登录" --skill synapse-code --mode lite

# 等价于
/synapse-code run my-project "实现用户登录" --mode lite

Brain 会：

1. 自动记录任务到 session state
2. 调用 synapse-code 执行
3. 接收结果并更新任务状态
4. 触发 wiki 知识沉淀

---

与 synapse-wiki 互操作#

bash

# Brain 查询已有知识
/synapse-brain query "RAG 是什么？" --skill synapse-wiki

# Brain 保存新资料
/synapse-brain ingest ~/raw/article.md --skill synapse-wiki

Brain 会：

1. 检查 wiki 是否初始化
2. 调用 synapse-wiki 对应命令
3. 更新知识索引到 session state

---

Scripts#

脚本用途scripts/state_manager.pySession 状态持久化（CRUD）scripts/task_router.py意图识别 + 任务路由scripts/session_init.py新 session 初始化scripts/subagent_dispatch.py子代理并行调度

---

安装#

bash

# 方式 1: 从源码安装（推荐）
git clone https://github.com/ankechenlab-node/synapse-brain.git
cd synapse-brain
./install.sh

# 方式 2: OpenClaw (从 ClawHub)
npx clawhub install synapse-brain

# 方式 3: 手动复制
cp -r synapse-brain ~/.openclaw/skills/

配置#

Brain 需要与 synapse-code 和 synapse-wiki 配合使用：

json

{
  "brain": {
    "state_dir": "~/.openclaw/brain-state",
    "auto_save": true,
    "auto_save_interval": 300,
    "skills": {
      "code": "synapse-code",
      "wiki": "synapse-wiki"
    }
  }
}

---

使用场景#

• 🧠 长期项目管理 — 跨多个 Session 追踪进度
• 🔄 复杂任务编排 — 自动调度多个子代理协作
• 📊 状态可视化 — 随时查询项目进展
• 🤝 Skill 互操作 — code 和 wiki 的统一入口
• 💾 会话持久化 — 每次醒来即恢复上下文