Synapse Code Skill

Synapse Code = 代码交付 + 知识沉淀 一体化工作流

核心理念：开发不仅是写代码，更是知识积累的过程。

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

你的任务是什么？
│
├─ 修复小 bug / 简单改动     → standalone（独立模式）
│   └─ 例："登录按钮点不了"、"改个文案"
│
├─ 日常功能开发             → lite（轻量模式）
│   └─ 例："加个导出功能"、"实现搜索"
│
├─ 大型模块 / 新功能         → full（完整模式）
│   └─ 例："设计整个订单系统"、"从零搭建 API"
│
└─ 复杂任务 / 多模块协作     → full + 并行模式
    └─ 例："同时开发前端和后端"、"拆分 5 个子任务"

不想思考？直接用

auto

📋 命令速查卡片

/synapse-code init

/synapse-code init ~/my-project

/synapse-code run

/synapse-code run my-project "实现登录功能"

/synapse-code status

/synapse-code status ~/my-project

/synapse-code query

/synapse-code query ~/my-project --contains "登录"

/synapse-code log

/synapse-code log ~/my-project

常用组合:

# 新项目开始
/synapse-code init ~/my-project
/synapse-code run my-project "设计用户系统"

# 日常开发
/synapse-code run my-project "修复登录 bug"
/synapse-code status my-project  # 检查进度

# 查询历史
/synapse-code query my-project --task-type bugfix --contains "认证"

六大场景支持

Synapse Code 支持 6 大场景，覆盖从代码开发到内容创作的全方位需求：

场景自动识别

系统会根据你的输入自动识别场景：

你：/synapse-code run my-project "写一篇公众号文章，介绍 AI 编程技巧"
     ↓
📝 检测到【文案写作场景】
     使用轻量模式（4 阶段）
     [1/4] 选题策划：分析受众...
     [2/4] 大纲策划：搭建结构...
     [3/4] 文案写作：撰写初稿...
     [4/4] 编辑润色：优化文案...

手动指定场景

# 文案写作
/synapse-code run my-project "写产品发布新闻稿" --scenario writing

# 设计创作
/synapse-code run my-project "设计一个简约现代的 logo" --scenario design

# 数据分析
/synapse-code run my-project "分析 Q3 销售数据" --scenario analytics

# 翻译本地化
/synapse-code run my-project "翻译技术文档到英文" --scenario translation

# 学习研究
/synapse-code run my-project "调研 RAG 技术的最新进展" --scenario research

# 代码开发（默认）
/synapse-code run my-project "实现登录功能"

三种工作模式

Synapse Code 提供三种工作模式，自动检测你的环境并选择最佳方案：

🚀 独立模式（新手推荐）

无需任何配置，立即可用

适合场景：

• 第一次使用，不想配置复杂环境
• 快速原型开发，简单功能实现
• 个人小项目，无需复杂流程

工作流程：

你：/synapse-code run my-project "实现登录功能"
     ↓
Claude 直接分析需求 → 生成代码 → 完成

⚡ 轻量模式（推荐）

需要基础 Pipeline 配置，3-4 阶段简化流程

适合场景：

• 日常功能开发
• 小团队协作
• 需要一定质量保证

工作流程：

代码开发：REQ（需求分析） → DEV（代码开发） → QA（质量检查）
文案写作：选题策划 → 大纲策划 → 文案写作 → 编辑润色
数据分析：数据收集 → 分析建模 → 可视化 → 报告撰写

🎯 完整模式（企业级）

需要完整 Pipeline，6 阶段 SOP 流程

适合场景：

• 大型项目开发
• 企业级应用
• 需要严格质量把控

工作流程：

代码开发：REQ → ARCH → DEV → INT → QA → DEPLOY
设计创作：需求分析 → 竞品调研 → 设计创作 → 设计审核 → ...

功能范围

1. 项目初始化检测 — 自动检测

   .knowledge/

   .synapse/

   .gitnexus/

   是否存在
2. Pipeline 命令封装 — 提供简洁的

   pipeline run

   命令
3. Auto-Log 触发 — Pipeline 成功后自动调用

   auto_log.py

4. Task Type 推断 — 根据需求描述自动推断 task_type
5. 代码图谱分析 — 内建 GitNexus 引擎，支持影响分析和调用链追踪

命令

初始化命令

# 初始化项目的 Synapse + Pipeline 环境
/synapse-code init [project_path]

执行内容：

1. 检测

   .git/

   存在
2. 调用

   scaffold.py

   创建

   .knowledge/

   .synapse/

   目录
3. 调用

   gitnexus analyze --force

   建图
4. 创建 pipeline 项目

Pipeline 命令

# 运行完整 Pipeline
/synapse-code run [project_name] "需求描述"

Auto-Log 命令

# 手动触发 auto-log
/synapse-code log [project_path]

状态检查命令

# 检查项目状态
/synapse-code status [project_path]

记忆查询命令

# 查询特定 task_type 的历史记录
/synapse-code query [project_path] --task-type debug --limit 5

# 按关键词搜索记录
/synapse-code query [project_path] --contains "登录 bug"

Scripts

scripts/init_project.py

scripts/run_pipeline.py

scripts/auto_log_trigger.py

scripts/check_status.py

scripts/infer_task_type.py

scripts/query_memory.py

使用场景

代码开发

• 🚀 新功能开发 — "实现用户登录功能"
• 🐛 Bug 修复 — "修复登录页面无法提交的问题"
• 🏗️ 系统设计 — "设计一个完整的电商系统"
• 📝 代码重构 — "优化数据库查询性能"

文案写作

• 📰 公众号文章 — "写一篇 AI 编程技巧入门"
• 📢 产品新闻稿 — "写产品发布新闻稿"
• 📧 商务邮件 — "写一封给投资人的邮件"
• 📖 技术文档 — "写 API 使用文档"

设计创作

• 🎨 Logo 设计 — "设计一个简约现代的 logo"
• 🖥️ UI 设计 — "设计一个 dashboard 界面"
• 📊 海报设计 — "做个产品发布海报"
• 📈 信息图表 — "展示销售数据的信息图"

数据分析

• 📉 销售分析 — "分析 Q3 销售数据"
• 👥 用户分析 — "做用户行为分析报告"
• 📊 竞品对比 — "对比我们和竞品的市场份额"
• 📈 数据可视化 — "做个销售数据 dashboard"

翻译本地化

• 📄 文档翻译 — "翻译技术文档到英文"
• 📚 论文翻译 — "翻译这篇论文到中文"
• 🌐 UI 本地化 — "本地化 App 的 UI 文案"

学习研究

• 🔍 技术调研 — "调研 RAG 技术的最新进展"
• 📊 竞品分析 — "分析 AI 编程助手市场格局"
• 📖 文献综述 — "整理 XX 领域的研究现状"
• 📝 研究报告 — "写一份行业分析报告"

知识管理

• 📝 知识沉淀 — 自动记录开发经验
• 🔍 影响分析 — 改动前查询影响范围
• 📊 状态检查 — 实时查看项目进度

安装

# 方式 1: 使用安装脚本（推荐）
cd ~/.claude/skills/synapse-code
./install.sh

# 方式 2: 手动复制
cp -r synapse-code ~/.claude/skills/

# 方式 3: OpenClaw (如有 .skill 文件)
claude skill install synapse-code.skill

安装后会自动创建

config.json

配置

编辑

~/.claude/skills/synapse-code/config.json

{
  "pipeline": {
    "workspace": "~/pipeline-workspace",
    "enabled": true,
    "auto_log": true
  },
  "paths": {
    "pipeline_script": "~/pipeline-workspace/pipeline.py",
    "pipeline_summary": "/tmp/pipeline_summary.json"
  }
}

pipeline.workspace

~/pipeline-workspace

pipeline.auto_log

true

paths.pipeline_script

~/pipeline-workspace/pipeline.py

paths.pipeline_summary

/tmp/pipeline_summary.json

相关文件

• /Users/leo/pipeline-workspace/pipeline.py

  — Pipeline 引擎

• ~/.claude/skills/synapse-code/scripts/auto_log.py

  — Auto-log 脚本（内置）

• /Users/leo/pipeline-workspace/SYNAPSE_INTEGRATION.md

  — 整合文档