rabiroute-message-delivery

Files (1)

• SKILL.md

SKILL.md (first lines)

# Rabi 消息投递与排障

## 先选正式入口

通用接口由 Manager 持有：Agent 会话操作使用 `/api/agent/threads`，消息端发送使用 `/api/agent/send`，健康与业务状态使用当前 Manager  GET。先读取 [接口合同](../../docs/rabi-agent-interfaces.md)。宿主提供正式工具时优先使用，工具名和参数映射由宿主适配技能说明；不要求所有 Agent 都安装 DSH 插件。

普通子 Agent 工具不能代替的跨宿主会话投递。缺少工具时使用该宿主已支持的正式 Manager 传输；没有合法入口则报告具体缺失，不猜测工具名、不绕过权限、不换宿主或另建任务。

## 排障顺序

1. 先区分用户要“检查为什么失败”还是“发送这段消息”。排障授权不等于发送测试消息、修改绑定、创建会话或重启宿主的授权。
2. 通过当前 Host 动态发现 Manager，并使用入口的 `GET /meta` 核对。不得抄用技能、旧对话或日志里的历史端口；不得用近期记忆读取充当健康探针。
3. 先读当前工具说明与 Manager 接口合同；调用 `/api/agent/help` 后检查 `contractLevel` 与 `coverage.missing`，发送还要读取 `/api/agent/send/capabilities`。`baseline` 不是精确 schema，缺失字段必须读取专用 contractResource；再通过 `/api/agent/threads` 的只读操作查询目标宿主、会话、绑定和可投递状态。工具参数以当前合同为准，不编造操作名或 JSON 字段。
4. 使用完整目标会话 ID 定位；标题、工作目录和时间只能辅助核对。明确区分“直接投递给指定 Agent 会话”和“外部消息按 Route 绑定转发”，不能仅凭 Route 未绑定就断定所有投递方式都失败。
5. 根据正式返回区分：Manager 不可达、适配器不支持、目标不存在、绑定缺失、会话不可投递、鉴权失败、投递被拒、结果未知。只读查询成功不能证明消息已经送达。
6. 正式返回仍不能解释问题时，才定位对应实现、配置或日志。先确认实际运行版本和源码位置，只检查与错误相关的路径；本地文件不代替 Manager 权威状态，不直接修改业务 JSON。
7. WorkBuddy 的 Hook 正常不代表消息通道正常；会话存在也不代表可投递。以 Manager 当前返回的存活、心跳、端点与会话类型等状态为证据，不凭旧截图推断。

帮助响应中的 `catalogDigest` 与 `channelsDigest` 只用于比较完整目录或渠道描述是否变化；筛选响应的 `catalogDigest` 仍属于完整目录。摘要相同不代表权限、Agent 启停、对象状态或 Manager 身份不变，也不能把 baseline 升格为 verified。切代或合同错误后仍重新发现并核验 `/meta`，不凭摘要省略回执读回。

## 正式投递与回复

- 发送前确认目标及正文属于用户请求；目标有歧义时等待用户明确，不猜选、不新建替代会话。
- Agent 间投递填写完整来源会话 ID、来源 Agent 类型及 `responsePolicy`；要求回复时填写 `responseInstruction`。来源不能取目标 ID 或由标题猜测。
- 插件向 Manager 只传 `messageSource`，来源会话必须与 `sourceThreadId` 一致；遵守当前接口对来源字段的定义。
- 正式回复填写 `inReplyToRequestId`、`result` 和 `nextAction`，关联原请求；最终聊天文字不算正式回复已投递。
- 存储写入前读取现行接口合同，使用稳定 `Idempotency-Key` 和适用的强 ETag `If-Match`；校验 HTTP 状态、回显键、ETag、资源身份及 `uncertain`。
- 超时、503、写后切代或结果不确定：保留原键和正文，先权威读回，不自动重发。412：重新读取并确认原意，再用新键与新 ETag。
- 分开报告“Manager 已接受”“目标已收到”“目标已完成回复”。消息端发送必须取得 Manager 与渠道回执；没有对应证据不宣称该阶段成功。

## 触发示例与范围

- “就是 rabi 没法投递消息到 workbuddy 的问题” → 本技能；先健康核对与只读会话检查，不先搜源码、不先发测试消息。
- “让 Rabi 把这段话发给 DSH 的指定会话” → 本技能；核对目标和来源后走正式投递工具。
- “向 QQ 群发送这段话” → 本技能选择消息端入口，并按 QQ 专项技能核对收件目标。
- “给 Rabi 新增一种 Agent 宿主” → Agent 适配器接入技能，不把未实现能力当普通绑定问题。
- “当前 Codex 使用某个角色” → `use-rabi-codex-context`，不属于跨会话消息投递。

## 验收边界

技能被发现、可加载、描述覆盖请求，只能证明入口已就位；不能证明模型每次都会命中，也不能证明真实投递已修复。真实投递验收需要明确的目标、获授权的正文及正式回执。技能检查不启动该验收。

## 发送前聊天索引核对

所有聊天类型消息端使用 `/api/agent/send` 的 `conversationContext`。上下文已给出 `lastReadMessageIndex` 时原样传递；缺省时 Manager 只复用同一 `sender.agentType + sender.sessionId + 会话` 的已核对缓存，首次返回最近 50 条并要求再次调用。收到 `conversation_context_confirmation_required` 表示尚未发送：阅读新增消息，重新判断正文是否合适；超过增量上限时按返回的会话、`afterSequence/beforeSequence` 范围和关键词补查省略内容。确认后保留原 deliveryId，提交返回的 `confirmationToken` 与 `latestMessageIndex`（作为 `lastReadMessageIndex`）；正文改变时重新审核，不能自动确认未读内容。再次有新消息时重复核对；不得换 deliveryId 绕过。不同 Agent 的已读位置和凭证互不共享，旧回执按原请求核对，不能重发。

From vb2250158/RabiRoute, MIT.

More from vb2250158/RabiRoute