SuperAPI AI 工具集

peer-sessions

智能体与模型

查看项目

更新于 10-16 02:28

技能介绍

用途:peer-sessions 用于协调一组对等会话(peer fleet),适合需要多会话分工、跨会话交接或可恢复回复的场景。核心思路是把 fleet 当作账本而非对话记录:每个 peer 通过路径接收简报,并通过路径返回一条结构化回复,账本才是交付记录。

主要能力:先用 init_fleet.py 建立 fleet 记录,生成 state.json(身份、目标、截止时间、peer 名单)、briefs/<peer>.md(工作契约)和 replies/<peer>.json(不可变回复位置)。启动 peer 时只传简报路径与允许范围,peer 读取自己的简报,并通过 peer_mailbox.py 写入回复。默认 --delivery-mode mailbox 拥有回复契约;若由其他组合技能拥有结构化响应产物,可用 --delivery-mode coordinator,此时 peer 等待协调者提示且不得写邮箱回复。

使用方式:先选定分支再选模型,用共享参考绑定已批准的路由快照。建立记录示例:SKILL_DIR="<absolute path of this peer-sessions directory>"; python3 "$SKILL_DIR/scripts/init_fleet.py" init --run-dir .ai-workflow/peer-sessions/<run-id> --objective "<one outcome>" --peer research:/absolute/path/to/repo --peer review:/absolute/path/to/repo。收集回复:python3 "$SKILL_DIR/scripts/peer_mailbox.py" status --run-dir .ai-workflow/peer-sessions/<run-id>。默认使用进程内委派;仅在需要可见 peer 或原生委派不可用时探测 cmux ping。可见终端需先读 references/cmux-fleet.md 并试运行清单,约六个 peer 以上用标签页。

限制:peer 不继承其他 peer 的权限,遇到拒绝应上报而非绕过;邮箱默认拒绝冲突的第二条回复,以保留原始证据;不要用终端屏幕文本作为结果通道。fleet 有三种退出:全部预期回复有效、某 peer 返回 blocked 或 failed、或声明的截止时间到达。可见 cmux fleet 在终止退出时必须执行 teardown,仅关闭已记录的 peer 界面或工作区,协调者界面保持打开。验收要求 peer_mailbox.py status 报告所有预期回复有效,或报告明确列出非成功退出及其证据,且 teardown 无剩余 peer 终端。