WorkBuddy 项目续接

它解决什么问题

换电脑时，一个 WorkBuddy 项目往往散落在多个位置：源代码、未提交修改、.git 历史、Agent 配置、项目内 Skill、项目规则，以及 .env 这类本地环境文件。手动拷贝几份文件夹，很容易漏掉其中一项，或者把另一台机器上的旧版本覆盖掉。更麻烦的是，Agent 上下文里的交接信息通常不会跟着文件一起走，到了新机器上还得重新解释一遍之前做到哪了。

WorkBuddy 项目续接 要做的不是云同步，也不是多人协作。它把当前工作区中需要带走的部分封装成一个加密的 .wbpack 工作包，由你自己传输到另一台电脑，再在目标机器上恢复，让项目可以接着做下去。

它如何工作

技能提供双模式入口：一边是打包，一边是恢复。触发后会先读取 references/agent-workflow.md，再按其中描述的交互顺序执行。不要仅凭某个文件是否存在，就猜测用户要打包还是恢复。

打包端会执行 scripts/relay.py，完成确定性打包、age 加密、归档校验和哈希校验，最终产出一个可传输的 .wbpack 文件。

恢复端同样由 scripts/relay.py 负责：解密、校验、安全恢复。恢复出来的项目不会覆盖目标机器上已有的目录，同时生成一份 HANDOFF.md，把当前进度和上下文交给 Agent，让它能继续工作。

如果需要解释 .wbpack 的内部结构，或者确认某个文件是否属于校验范围，可以再读取 references/package-format.md。

默认会保留：源代码、文档、素材、数据库、.git、Agent 配置、项目内 Skill、项目规则、未提交修改、项目内 .env。

默认会排除：可重建依赖、缓存、构建产物、覆盖率、日志、系统临时文件、已有的 .wbpack，以及符号链接。

适用边界

这项技能只处理“换设备后的工作现场转移”。它不迁移模型隐藏状态、原始会话进程、系统钥匙串、浏览器登录态、WorkBuddy 账号凭证，也不覆盖未公开的工作区切换接口。它同样不负责云同步、实时多人协作、普通 Git 同步或部署。

另外，SkillHub 文本分发版不携带 age 二进制文件。使用前需要在目标设备上自行安装 age，并确认它已经位于 PATH 中；技能不会自动下载、安装或替换系统工具。如果目标设备需要随包提供二进制，请改用完整包，而不是这个文本版。