SuperAPI AI 工具集

build-hcom-systems

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

用途:当需要在 hcom 之上构建多智能体架构、自定义工作流脚本、CI/CD 集成或自动化系统时,按资料提供的设计流程产出设计文档。

主要能力:给出五种拓扑(Hub-spoke、Pipeline、Ensemble、Peer-to-peer、Reactive)及其适用场景与对应原语;提供通信原语选择表(发送消息、等待信号、读取 transcript、事件订阅、跨设备消息、结构化上下文交接)及延迟参考;给出启动脚本最小骨架与 CI/CD 集成示例;列出常见陷阱与守卫规则。

使用方式:先确定输出路径,默认 ./design.md;若需可执行编排,先用 command -v hcom 确认 hcom 可用,不可用则仅停留在架构/设计层面。设计文档需包含拓扑与职责、通信原语与线程模型、最小脚本骨架或启动计划、外部集成点、验证步骤与清理计划。可执行部分参考 skills/run-hcom-agents 的 SKILL.md 与 cli-reference.md、gotchas.md。关键命令保持原样,例如 hcom send @name --thread T --intent X -- "msg"、hcom events --wait N --sql "..."、hcom transcript @name --full --detailed、hcom events sub --file "*.py"、hcom 2 claude --tag researcher --go --headless --batch-id "$batch_id"。注意 --go、--headless、--batch-id 为路由级启动参数,即使工具帮助未列出也有效;--thread 只用于 send/events,不用于启动。

适用场景:设计新多智能体应用、编写自定义工作流脚本、CI/CD 集成、跨设备消息与事件驱动触发。

限制:不要直接基于 SQLite 数据库构建,应使用 hcom CLI;不要假定智能体名称,须从启动输出捕获;每个工作流需唯一线程 ID;不要用 sleep 轮询,应用 hcom events --wait;发送前等待智能体 idle;须设置清理陷阱(trap cleanup ERR 配合 hcom kill),避免孤儿 headless 智能体持续占用资源。其他收费、平台与效果信息暂未提供。