SuperAPI AI 工具集

distributed-mesh

智能体与模型

查看项目

更新于 10-15 21:12

技能介绍

用途:当 squad 分布在不同机器、虚拟机、CI 运行器或不同组织时,本地读文件的约定仍可用,但远端文件需先到达本地磁盘。本技能提供分布式 squad 通信模式,核心原则是“文件系统即网格,git 是网格跨越机器边界的方式”,agent 接口不变,始终读取本地文件。

主要能力:按三个通信区域组织。Zone 1 本地:同一文件系统,直接读文件,零传输。Zone 2 远程可信:不同主机、同组织、共享 git 认证,通过 git pull 从共享仓库拉取,使远端文件物化到磁盘。Zone 3 远程不透明:不同组织、无共享认证,通过 curl 获取已发布的契约(SUMMARY.md),仅单向可见。

使用方式:技能会先询问网格拓扑(参与 squad、各自区域、连接信息、共享状态位置),然后生成项目根目录的 mesh.json,从技能目录复制 sync-mesh.sh 与 sync-mesh.ps1 到项目根目录,若配置了 Zone 2 共享状态仓库则运行 bash sync-mesh.sh --init(Windows 为 .\sync-mesh.ps1 -Init),最后在 .squad/decisions/inbox/ 写入决策条目。agent 生命周期为 SYNC、READ、WORK、WRITE、PUBLISH,其中 SYNC 与 PUBLISH 是分布式扩展部分。

限制:本技能不生成应用代码、测试文件、守护进程或服务,也不修改现有 squad 文件(决策条目除外);同步脚本是随技能捆绑的预构建资源,应复制而非生成。写入按 squad 分区,每个 squad 只写自己的目录,避免 git 冲突。信任边界映射到 git 权限。分阶段推进由项目决定,不自动升级。