peer-message

1# peer-message — 本机协调与通信补缺
2 
3对 Claude Code 与 Codex 使用同一条通信规则：先检查当前宿主实际暴露的通信工具及其目标范围；有工具发现入口时先查询原生工具。原生工具能到达目标，就直接使用其发现、发送、回传和等待机制，不另跑 `send/broadcast/verify/replies`。只有原生工具未覆盖的独立会话、跨产品目标或脚本回帖才使用本 Skill 的 transport。独立会话之间的任务归属、共享资源和请求生命周期由本 Skill 的 `coord` 管理，原生发送仍走原生工具；原生父子任务不增加这层登记。
4 
5不要用产品名、模型名、安装版本或安装包中的工具定义代替当前工具可用性。原生工具覆盖当前任务树，不代表能寻址任意独立 session；目标缺失或地址不明时先消歧。权限拒绝、Held、超时与发送结果不明都不是换通道的依据，也不要为了补缺修改权限或接收策略。
6 
7## 安装后的协调维护
8 
9独立会话开工、遇到归属冲突或申请共享资源窗口时，先读 [本地协调机制](references/local-coordination.md)，执行其中的状态查询、本人登记和请求处理。Agent 自行执行；不让用户另装 Fleet、建台账或逐条维护。`scripts/peer.py coord` 首次调用自动初始化本机共享状态，后续调用维护同一库，不需要常驻进程。任务状态在 Skill 包外，更新 Skill 不覆盖它。
10 
11先从明确任务引用和实际共享资源核对范围；已有负责人时直接定位该负责人，有疑点才定向问一次。空登记只表示尚未接入，陈旧登记只表示需要核验；二者都不授予执行权。开始或改变参与范围时登记，完成或交接时由本人释放，不把消息回执当成业务完成。
12 
13`send/broadcast` 自动经过同一去重记录。短时窗口问题使用稳定 `--topic`、`--kind request` 和实际有效期；同一待答事项即使换措辞也不会重复投递。原生跨会话发送用 `coord prepare` → 原生工具 → `coord commit`，只记录一次，不追加脚本发送。收到 `[peer-coordination: ...]` 时先用 `coord receive` 判断是否仍需处理，关联问题处理完用 `coord finish` 关闭；旧信封没有该字段时沿下面的语义分流，不猜有效期。
14 
15安装、绑定变更或原生发送前，执行 [原生协调与前置检查](references/local-coordination.md#原生跨会话通信)。从本次加载的 Skill 目录运行该 SOP 的绝对路径命令；按其覆盖与验收条款判断实际宿主是否生效。
16 
17可由后续版本整体替代的当前状态用 `--kind state`，带稳定 topic、真实 event 和明确有效期；发送者与接收者均须支持该模式。按本地协调机制的「可被新版本替代的状态」执行：新版本生效后，旧版本不再触发核查或回信。累计通知和真实新阻塞保留 notice/request，不猜正文语义、不给旧信封补有效期。
18 
19## 收到消息先分流
20 
21先判断消息是否改变当前任务，或还有未回答的协作请求，再决定是否核实、回复。仅为完成通知、确认回执，或已由后续证据与既有答复覆盖的旧状态时，静默收下；不回 ACK，不重新检查 Git/网络/送达，不向用户逐条播报“无需操作”。旧信封的分流本身不要求调用工具；带协调字段的新信封先走 receive，过期、已关闭和已处理记录安静收下，不回 ACK。
22…