Synapse Code 开发工作流
将以下提示词粘贴到你的 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 分支后再交付的功能开发者。