SuperAPI AI 工具集

work-migration

智能体与模型

查看项目

更新于 10-16 10:20

技能介绍

用途

Work Migration 用于把当前工作打包成一个自包含的 .zip 文件,交给另一个智能体或环境冷启动接手。它适用于用户要求迁移、转移、交接或导出工作的场景。其核心原则是:接收方智能体是一张白纸,从未见过你的对话历史、记忆主题、.env、计划任务或正在运行的服务,因此它需要的一切都必须放进压缩包。凡是觉得“这很明显、不用写下来”的内容,都要写下来。

主要能力

该技能按阶段组织迁移流程:

  • 阶段 1:范围界定。先询问用户要迁移什么工作,可能是项目、自定义技能、进行中的任务或整个工作区,在收集文件前先确定边界。
  • 阶段 2:依赖发现。追踪所有类别,包括源代码、环境变量(.env,敏感)、系统依赖(setup.sh、pip/apt/npm 包)、自定义技能(skills/)、计划任务(list_scheduled_tasks,含 Job ID、schedule、description、model、完整命令)、运行中的服务(/data/previews.json,含目录、命令、端口,并注明必须重启)、记忆(memory_topics + memory_get,导出相关主题摘要为 .md 文件)、用户偏好(prompt/SOUL.md、prompt/USER.md 中与本工作行为相关的部分)、决策历史(为什么事情是现在这样)、外部 API(端点、认证方式、速率限制、特殊行为)、区块链/钱包(地址、链、合约,绝不包含私钥)。
  • 阶段 3:编写 work_migration_readme.md。这是包中最重要的文件,遵循 references/readme-template.md 模板,包含 10 个必填部分。关键规则:文件清单列出 zip 中每个文件及其用途,不留孤儿文件;决策日志记录 3-5 个非显而易见的决策,避免重新争论已定事项;如何恢复给出接收方智能体接手工作的精确分步说明;禁止隐式知识,禁用“如前所述”“和之前一样”“照常”等表述。
  • 阶段 3.5:安全检查点。打包前有两个强制提示。一是环境变量:列出相关变量及其使用位置,询问是否包含实际值,选项为 [A] 包含值(方便但敏感)、[B] 脱敏,只包含名称和用途(更安全)、[C] 由用户挑选;默认推荐 B,若选 A 或 C 需警告一次“这些值将以明文形式存在于 zip 中”;若选 B,在 readme 中写清变量名→用途→如何获取的表格;无论用户如何选择,绝不包含私钥、钱包种子或签名密钥。二是 ZIP 密码:询问是否用密码保护 zip,选项为 [A] 是,设置密码(通过互联网传输时推荐)、[B] 否,普通 zip 即可;若选是,要求用户提供密码(不要生成密码),使用 zip -e(标准加密)或 7z a -p(AES-256,更强),提醒用户“通过独立于 zip 文件的渠道发送密码”;若未安装 7z,回退到 zip -e 并注明其使用较弱的 ZipCrypto。
  • 阶段 4:打包。创建临时目录,按结构复制文件,导出记忆主题,复制 readme 到根目录,根据用户选择加密或不加密打包,最后清理临时目录。
  • 阶段 5:质量门。交付前自检:白纸测试(仅凭此 zip 的新智能体能否完全恢复工作)、无悬空引用(readme 中每个文件都在 zip 中,zip 中每个文件都在 readme 中)、环境变量按用户选择处理、若要求则已应用密码、决策日志至少 3-5 条。

使用方式

该技能以技能形式提供,具体安装命令和调用方式暂未提供。使用流程遵循上述阶段:先界定范围,再发现依赖,编写迁移说明文档,进行安全检查,打包,最后通过质量门。打包命令示例包括:

mkdir -p /tmp/work-migration-[name]
cp -r [identified-files] /tmp/work-migration-[name]/
mkdir -p /tmp/work-migration-[name]/memory/
cp work_migration_readme.md /tmp/work-migration-[name]/
cd /tmp
zip -r /data/workspace/output/work-migration-[name].zip work-migration-[name]/
# 带密码:
# zip -e -r /data/workspace/output/work-migration-[name].zip work-migration-[name]/
# 或更强加密:
# 7z a -p"USER_PASSWORD" -mhe=on /data/workspace/output/work-migration-[name].7z work-migration-[name]/
rm -rf /tmp/work-migration-[name]

适用场景

  • 将项目、自定义技能、进行中的任务或整个工作区交接给另一个智能体或环境。
  • 需要冷启动接手、没有聊天历史或隐式知识的迁移。
  • 涉及环境变量、系统依赖、计划任务、运行服务、记忆、用户偏好、决策历史、外部 API 或区块链钱包的工作交接。

限制

  • 运行中的服务只做文档记录并注明必须重启,不迁移运行状态。
  • 钱包工作只包含地址、链、合约,绝不包含私钥,并需记录所需策略。
  • 环境变量默认推荐脱敏;若包含实际值,会以明文存在于 zip 中。
  • 密码需由用户提供,且应通过独立渠道发送。
  • 若未安装 7z,回退到 zip -e,加密强度较弱。
  • 具体安装命令、调用方式、收费或价格信息暂未提供。