SuperAPI AI 工具集

fleet-init

智能体与模型

查看项目

更新于 10-23 23:07

技能介绍

用途

fleet-init 用于初始化 CocoFleet 清单(manifest),以支持多进程编排。它属于 CocoPlus 体系,通过生成一个 JSON 模板来定义一组独立的 Coco 进程实例及其依赖关系。

主要能力

  • 前置校验:确认 .cocoplus/ 目录存在,否则提示先运行 $pod init 并停止。
  • 参数解析:解析 $fleet init [fleet-name];若未提供 fleet-name,则输出用法示例并停止。
  • 环境检查:跨平台确认 coco CLI 是否可用(Windows 用 where coco,Mac/Linux 用 which coco,或运行 coco --version 检查退出码);若未找到则报错并停止。
  • 目录与文件创建:创建 .cocoplus/fleet/ 目录,并写入 .cocoplus/fleet/[fleet-name]-manifest.json。
  • 模板内容:包含 id、name、version、created_at(ISO 8601 时间戳)、defaults(persona、model、coco_flags、timeout_minutes)以及 instances 数组。示例实例包含 id、name、persona、task_file、output_dir、depends_on、checkpoints 字段,并演示了依赖关系(instance-002 依赖 instance-001)。
  • 完成输出:确认清单路径,并说明如何添加实例、每个实例所需字段,以及通过 $fleet run [fleet-name] 执行。

使用方式

  1. 确保当前目录已初始化 CocoPlus(存在 .cocoplus/)。
  2. 运行 $fleet init [fleet-name],例如 $fleet init data-pipeline-fleet。
  3. 技能会检查 coco CLI 是否在 PATH 中,然后生成清单文件。
  4. 编辑生成的 JSON,按需添加或修改实例定义。
  5. 使用 $fleet run [fleet-name] 执行该 fleet。

适用场景

适用于需要将多个独立 Coco 进程按依赖关系编排执行的场景,例如数据处理流水线、分阶段任务等。每个实例在独立进程中运行,不共享上下文,因此 task_file 必须自包含,需在任务文件中记录所有必需的输入、schema 和上下文。

限制

  • 单个 fleet 清单最多 10 个实例。
  • 每个实例的 task_file 必须完全自包含,不能内联任务内容。
  • 执行依赖 coco CLI 在 PATH 中可用。
  • 需要 .cocoplus/fleet/ 目录存在,否则首次运行会失败。
  • 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。