SuperAPI AI 工具集

run-hcom-agents

智能体与模型

查看项目

更新于 10-16 06:45

技能介绍

用途:帮助编写并运行 hcom 脚本,用于启动、协调和管理多个 AI 编码智能体,覆盖无界面智能体启动、智能体间消息传递与多智能体工作流编排。

主要能力:提供脚本模板与决策树,按需求指向不同参考资料,例如测试过的模式(评审循环、集成、跨工具协作)、高级模式(reflexion、MoA、红蓝队)、故障排查与工作原理说明。启动命令须带 --go(跳过确认,否则脚本挂起)、--headless(后台分离运行)、--tag(分组并支持 @标签路由)、--hcom-prompt(设定初始任务)。消息通过 hcom send 发送,支持 @tag- 或具体名称、--thread 隔离、--intent;等待用 hcom events --wait 或 hcom listen 替代 sleep;读取其他智能体输出用 hcom transcript;清理用 hcom kill,而非 stop。

使用方式:使用前必须执行前置校验:确认 hcom CLI 与目标工具已安装,运行 hcom status 并确认计划使用的各后端(claude、codex、gemini、opencode)均已安装 hooks;若缺失则运行 hcom hooks add <tool>,重启该工具后再运行 hcom status;若仍失败则停止,保留 hcom status 输出,不得继续启动脚本。启动无界面智能体后,需等待就绪信号再发消息;Codex 通常需 hcom events --wait 30 --idle "$codex_name"。若某智能体的启动提示会向另一智能体发消息,须先启动接收方(如先评审者后工作者)。脚本应设置 trap cleanup ERR,从 Names: 行解析智能体名称,避免硬编码。

适用场景:多智能体编码协作流程,如工作者-评审者反馈循环、Claude 架构师与 Codex 工程师配对、多智能体集成加裁判、顺序计划后执行等。

限制:起步延迟、消息投递与往返耗时已在真实测试中测得(Claude 与 Codex 不同),但具体数值以原文为准;hcom events --wait 超时也会返回 0,须检查输出而非退出码;不使用 --thread 会导致消息跨工作流泄漏;不等待就绪即发送、缺少 --go、硬编码名称、跳过 --thread 均属常见错误。原文未提供收费、价格或平台信息。