Agent Skills
返回列表
Synapse Code 开发工作流

Synapse Code 开发工作流

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_05b4120c/synapse-code。

技能介绍

问题:代码写完了,上下文却跟着会话消失

日常开发里,Pipeline 能帮你交付改动,但「为什么这样改」「动到了哪些调用链」「上次踩过的坑」往往只留在聊天记录里。团队接手或隔几周再改同一模块时,只能靠回忆或手动 grep,影响分析也缺少统一入口。

技能如何工作

Synapse Code 把「跑 Pipeline」和「写进项目记忆」绑在同一条链路上,并内建 GitNexus 做代码图谱。

  • 项目初始化:检测 .git/,通过 scaffold.py 创建 .knowledge/、.synapse/,执行 gitnexus analyze --force 建图,并创建 pipeline 项目。
  • Pipeline 封装:run_pipeline.py 提供简洁的 pipeline run 流程;成功后若开启 pipeline.auto_log,会读 /tmp/pipeline_summary.json(或配置的 paths.pipeline_summary),由 auto_log_trigger.py / 内置 auto_log.py 写入 memory。
  • 任务与查询:infer_task_type.py 根据需求描述推断 task_type;check_status.py 看项目状态;query_memory.py 查历史记录。
  • 影响分析:依赖 GitNexus 引擎做影响范围与调用链追踪,改代码前可先查图谱,而不是纯靠人工追引用。

配置在 ~/.claude/skills/synapse-code/config.json:pipeline.workspace(默认 ~/pipeline-workspace)、paths.pipeline_script 等需与实际 Pipeline 引擎(如工作区里的 pipeline.py)对齐。

适用边界

  • 初始化会检测 .knowledge/、.synapse/、.gitnexus/ 等目录是否已存在;Pipeline 与 auto-log 依赖你本机已部署的 Pipeline 工作区与摘要 JSON 路径,不是无头云端服务。
  • 知识沉淀质量取决于 Pipeline 摘要内容与 auto-log 逻辑;图谱能力以 GitNexus 分析结果为准,超大或非常规仓库需自行验证 analyze 耗时与准确度。

使用场景

  • 新建 Git 仓库还没有 `.knowledge/`、`.synapse/` 与 GitNexus 图谱,需要一次性 scaffold 并执行 `gitnexus analyze --force`。
  • 准备修改被多处调用的接口或核心函数前,要先查调用链与可能影响的上游、下游模块。
  • 本地 `pipeline run` 成功后,希望读取 `pipeline_summary.json` 并自动写入 memory,而不是手工整理会话笔记。
  • 间隔一段时间后回到同一需求,需要查历史 memory、task_type 与当前 synapse 项目状态再接着改。

适合人员

  • 在本机维护 `~/pipeline-workspace` 与 `pipeline.py`、希望每次 Pipeline 成功后自动触发 auto-log 的后端工程师。
  • 负责跨模块重构或公共 API 变更、提交前必须用图谱做影响范围核对的技术负责人。
  • 刚接入已有 `.synapse/` 目录的仓库、需要跑 `check_status.py` 与 `query_memory.py` 对齐上下文的协作者。
  • 用自然语言写需求、依赖 `infer_task_type.py` 选对 Pipeline 分支后再交付的功能开发者。