Skill Pack
将当前 Agent 中的所有技能逐一打包为独立 zip 文件,每个技能一个包,便于按需安装和跨设备迁移。也支持从 zip 包恢复技能。
你的工作方式
根据用户意图路由到对应操作:
| 用户意图 | 执行操作 |
|---|---|
| 打包/导出/备份技能 | → 逐一打包 |
| 恢复/安装/导入单个技能包 | → 从单个 zip 恢复 |
| 批量恢复/导入全部技能 | → 从目录批量恢复 |
| 不确定有哪些技能 | → 先列出技能清单,再问用户是否打包 |
操作 1:逐一打包技能
每个技能单独打成一个 zip,用户可按需挑选安装。
步骤
- 扫描技能目录 — 执行
python3 scripts/pack.py,自动扫描/sandbox/workspace/skills/下所有含 SKILL.md 的目录 - 展示扫描结果 — 将脚本输出的技能列表呈现给用户确认
- 处理排除需求 — 如果用户要求排除某些技能,用
--exclude参数:python3 scripts/pack.py --exclude skill1,skill2 - 执行打包 — 默认输出到
/sandbox/workspace/outputs/skill-packs/,每个技能生成独立 zip(如darwin-skill.zip),同时生成manifest.json清单 - 交付 — 告知用户打包结果,提供下载链接
输出结构
outputs/skill-packs/
├── manifest.json # 总清单:所有技能的名称、描述、文件数、大小
├── darwin-skill.zip # 单个技能包,解压后即为此技能完整目录
├── dating-skill.zip
├── gov-doc-writer.zip
└── ...
单个 zip 内部结构(与技能目录一致):
darwin-skill.zip
├── SKILL.md
├── scripts/
├── references/
└── ...
安装时只需将 zip 解压到技能目录即可:unzip darwin-skill.zip -d /sandbox/workspace/skills/darwin-skill/
操作 2:恢复单个技能
步骤
- 确认来源 — 用户提供单个技能的 zip 文件路径或上传文件
- 预览 — 执行
python3 scripts/unpack.py --input <zip路径> --dry-run - 处理冲突 — 同名技能已存在时告知用户,等待确认
- 执行恢复 —
python3 scripts/unpack.py --input <zip路径> - 注册 — 执行
ima_skill_create -d /sandbox/workspace/skills/<技能名>/让平台识别
操作 3:批量恢复
用户提供了包含多个 zip 的目录(如整个 skill-packs 文件夹)。
步骤
- 扫描目录下所有 zip 文件
- 逐个执行
python3 scripts/unpack.py --input <zip路径> - 全部恢复后,逐个执行
ima_skill_create -d /sandbox/workspace/skills/<技能名>/注册
注意事项
- 打包时默认排除
skill-pack自身,可通过--exclude追加排除 - 打包自动跳过
.git、__pycache__、node_modules、.pyc等运行时产物 - 恢复后需用
ima_skill_create -d注册才能让平台识别,或重启 Agent