SuperAPI AI 工具集

spawn-instance

智能体与模型

查看项目

更新于 10-15 10:08

技能介绍

用途

spawn-instance 用于将一个 Aeon 智能体克隆(fork)到一个新的 GitHub 仓库,并针对特定用途完成配置、验证与登记。它接收一个变量,格式为“名称: 用途”(例如 crypto-tracker: monitor DeFi protocols and token movements)。如果变量为空,则通知所有者并以 SPAWN_INVALID_VAR 退出。

主要能力

  • 解析并校验变量,派生规范化的实例名称与仓库名(aeon-名称)。
  • 执行预检:检查 gh 认证状态、读取所有者、确定父仓库(若当前仓库本身是 fork,则使用上游仓库)、检查 API 速率限制。
  • 读取并维护 fleet 注册表 memory/instances.json,避免重复登记。
  • 从实时技能目录(skills/*/SKILL.md)动态构建技能计划,按用途关键词匹配标签与描述,最多选择 8 个内容技能,并始终包含 heartbeat(若存在)。
  • Fork 父仓库,等待 fork 可用,克隆并配置 fork。
  • 写入定制化的 aeon.yml(仅对选定技能设置 enabled: true,保留完整技能清单)。
  • 动态生成 SETUP.md,列出所需密钥(Claude 认证、通知、以及各启用技能引用的环境变量)。
  • 幂等更新 CLAUDE.md,重置子实例记忆文件(MEMORY.md、日志、主题、问题、cron 状态)。
  • 提交推送后启用 GitHub Actions(fork 默认禁用)。
  • 执行飞行后验证(fork 可达、提交为 HEAD、Actions 已启用)。
  • 在父仓库注册表中登记实例,写入日志并发送通知。

使用方式

该技能通过 gh CLI 运行,认证由 gh 内部处理,因此命令行中不会出现裸密钥。运行前需确保 gh 已安装并完成认证,否则预检会以 SPAWN_API_ERROR 失败。调用时传入“名称: 用途”变量即可。

适用场景

适用于需要从现有 Aeon 智能体快速派生出一个针对特定用途(如加密货币追踪、研究、社交、新闻摘要、开发、安全、预测市场等)的独立实例,并纳入 fleet 统一管理的场景。

限制

  • 不传播任何密钥:绝不将 ANTHROPIC_API_KEY、TELEGRAM_、DISCORD_、SLACK_* 或任何 API 密钥读写到子仓库。
  • 不使用硬编码技能列表,始终在运行时枚举 skills/*/SKILL.md。
  • 幂等:重复运行不会产生重复注册条目、重复 CLAUDE.md 行或第二个 fork。
  • 绝不删除 fork:任何失败都会保留 fork 并输出恢复指引,只有操作者有权删除。
  • 新实例在所有者手动设置密钥前处于惰性状态。
  • 每次运行以明确的退出状态码结束(SPAWN_OK、SPAWN_FORK_EXISTS_RECOVERED、SPAWN_FORK_EXISTS_REGISTERED、SPAWN_INVALID_VAR、SPAWN_NO_SKILLS、SPAWN_FORK_FAILED、SPAWN_PUSH_FAILED、SPAWN_ACTIONS_FAILED、SPAWN_API_ERROR)。

退出状态码

  • SPAWN_OK:fork 已创建、配置、推送、Actions 已启用并登记。
  • SPAWN_FORK_EXISTS_RECOVERED:fork 已存在但未登记,现已配置并登记。
  • SPAWN_FORK_EXISTS_REGISTERED:fork 已存在且已登记且未归档,拒绝执行,不做更改。
  • SPAWN_INVALID_VAR:变量为空或无法解析为“名称: 用途”。
  • SPAWN_NO_SKILLS:验证后技能计划为空,拒绝执行。
  • SPAWN_FORK_FAILED:gh repo fork 与回退 forks API 均失败。
  • SPAWN_PUSH_FAILED:fork 已创建但推送失败,fork 保留并输出恢复指引。
  • SPAWN_ACTIONS_FAILED:配置已推送但启用 Actions 失败,输出恢复指引。
  • SPAWN_API_ERROR:其他未涵盖的 GitHub API 失败。