一键迁移备份

要解决什么问题

在 Agent 沙箱里技能往往散落在 /sandbox/workspace/skills/ 各子目录中，换设备、换实例或只迁移其中几项时，手工拷贝容易漏文件、带进 __pycache__ 等垃圾，也不方便按需分享单个技能。本技能把「整库备份」和「按包恢复」做成可路由的三类操作：逐一打包、单 zip 恢复、目录批量恢复。

工作方式

Agent 根据你的意图选择路径：打包/导出/备份 → 逐一打包；恢复单个包 → unpack.py；批量导入 → 扫描目录内所有 zip。若你不确定有哪些技能，会先列出清单再确认是否打包。

逐一打包 通过 python3 scripts/pack.py 扫描含 SKILL.md 的技能目录，结果展示后可按 --exclude skill1,skill2 排除项（默认会排除 skill-pack 自身）。输出落在 /sandbox/workspace/outputs/skill-packs/：每个技能一个 zip（如 darwin-skill.zip），并生成 manifest.json。zip 内结构与技能目录一致，安装侧只需 unzip … -d /sandbox/workspace/skills/<name>/。

恢复 对单包先 python3 scripts/unpack.py --input <path> --dry-run 预览；同名冲突会停下来等你确认，再正式解压。批量模式对目录下每个 zip 重复 unpack。恢复完成后需对目标目录执行 ima_skill_create -d /sandbox/workspace/skills/<name>/，否则平台可能识别不到（或依赖重启 Agent）。

边界与注意点

• 打包会自动跳过 .git、node_modules、.pyc 等运行时产物；额外排除用 --exclude。
• 本技能管的是文件级打包与解压，不替代 SkillHub 上的发布与版本策略。
• 批量恢复时建议留意冲突策略，避免静默覆盖已有技能。