mcpField
M
multica-autopilots

multica-autopilots

github.com/multica-aiAgent 工作流54.1k39 次安装今天更新
代码仓库

关于 multica-autopilots

用于检查和管理 Multica autopilot 的 Agent 技能。Autopilot 是将任务分派给 Agent 或小队负责人的持久规则，技能涵盖触发类型、执行模式、命令行操作和运行排查。

主要功能

  1. 01查看 autopilot 状态和运行记录
  2. 02配置计划任务与 webhook 触发器
  3. 03创建议题或仅运行任务
  4. 04通过命令行管理 autopilot 状态
  5. 05追踪失败或待处理的分派

适用场景

  1. 01排查 autopilot 未运行的原因
  2. 02检查 webhook 投递状态
  3. 03设置定时 Agent 任务
  4. 04选择创建议题或直接执行任务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/multica-ai/multica --skill multica-autopilots

安装后在 Claude Code 中输入/multica-autopilots确认已加载。

附带文件references/autopilots-source-map.md

详细介绍

Multica Autopilots

快速开始

Autopilot 是持久化的自动化。在修改之前请先阅读：

multica autopilot list --output json
multica autopilot get <autopilot-id> --output json
multica autopilot runs <autopilot-id> --output json

不要为了测试而运行 trigger、delete、trigger-delete 或 trigger-rotate-url。这些都会产生真实的副作用。

核心模型

Autopilot 不是 Agent。它是一条规则，将工作分派给一个 Agent，或一个 squad 的 leader Agent。

链路为：触发器触发（schedule、webhook 或 manual）-> autopilot_run 行 -> execution_mode 决定输出 -> 被分派人就绪检查 -> issue/task 执行 -> run 状态同步。Webhook 前面有一个持久化的准入步骤：HTTP 入口存储一个排队的 webhook_delivery，同步创建或复用它幂等的 run，并返回 200，附带 status=accepted|skipped 以及 run_id；随后一个由数据库租约的 worker 恢复已接受的 run，并负责可恢复的 issue/task 分派。

执行模式：

  • create_issue 创建一个 Multica issue，使该 run 作为 issue 状态可见。
  • run_only 直接创建一个 Agent 任务。不会创建 issue；任何持久化的 报告位置都必须来自其他任务上下文或指令。

issue-title-template 只支持 {{date}}。不要臆造 {{trigger_id}}、{{branch}} 或其他变量。

CLI

multica autopilot list --output json
multica autopilot get <autopilot-id> --output json
multica autopilot create --title "<title>" --description "<task prompt>" --agent <agent-name-or-id> --mode create_issue|run_only --output json
multica autopilot update <autopilot-id> --status active|paused --output json
multica autopilot runs <autopilot-id> --output json
multica autopilot trigger-add <autopilot-id> --kind schedule --cron "0 9 * * *" --timezone Asia/Shanghai --output json
multica autopilot trigger-add <autopilot-id> --kind webhook --label "ci" --output json
multica autopilot trigger <autopilot-id> --output json
multica autopilot trigger-rotate-url <autopilot-id> <trigger-id> --yes --output json

仅当用户明确要求手动运行时才使用 trigger。仅在轮换 webhook URL 时使用 trigger-rotate-url；旧 URL 将不再有效。

autopilot get 默认会隐去 webhook、webhook_path 和 webhook_url，同时报告令牌是否存在及其非敏感提示。仅当用户明确要求获取实时的 webhook 凭据时才添加 --show-secrets；该命令会在 stderr 上发出警告。不要将 webhook 令牌或签名材料粘贴到评论、日志、文档或 PR 中。

调试

对于“为什么没有运行”：

  1. multica autopilot get <id> --output json — 状态、模式、被分派人、触发器。
  2. multica autopilot runs <id> --output json — run 状态和失败原因。
  3. 如果分派给了一个 squad，检查该 squad：multica squad get <squad-id> --output json；执行会交给 leader。
  4. 检查目标 Agent/runtime：multica agent get <agent-id> --output json 和 multica runtime list --output json。
  5. 对于 webhook，检查投递状态：queued 表示 worker 尚未完成分派；failed 携带 worker 错误。提供方使用相同的 X-GitHub-Delivery / Idempotency-Key 重试会复用原始投递。
  6. 对于 create_issue，如果 run 记录了创建的 issue，检查该 issue。

副作用

以下操作会修改持久化状态或启动工作：create、update、delete、触发器 add/update/delete/rotate、trigger，以及对 /api/webhooks/autopilots/{token} 的 webhook 调用。

更多有来源支撑的细节：references/autopilots-source-map.md。

评论

支持 Markdown