/cross-channel-messaging

name: cross-channel-messaging
description: 'Use when deciding how to deliver an AI result: reply now, put durable news, reports, recommendations, or articles in the NextClaw inbox, or send to an explicitly requested chat channel without guessing a route.'
description_zh: '当需要决定 AI 结果如何交付时使用：当前会话直接回复、把新闻简报/报告/推荐/文章投递到 NextClaw 收件箱，或发送到用户明确指定的聊天渠道且不猜测路由。'

Result Delivery And Cross-Channel Messaging

This is a NextClaw built-in skill for the AI itself.

It teaches the AI how to choose among NextClaw's existing delivery primitives in a predictable way.

Use this skill when the user wants any of these:

• send a result to another conversation,
• deliver collected news, a briefing, report, recommendation, or article for later reading,
• notify them through Weixin, Lark, Telegram, Signal, or another channel,
• proactively send a message after a task finishes,
• forward or relay content across sessions or channels.

Strong triggers include user wording such as:

• "notify me when done",
• "collect the news and send it to me",
• "put this report somewhere I can read later",
• "send this to my Weixin",
• "message me on Telegram",
• "forward the result to another chat",
• "after you finish, send me a note elsewhere".

Do not wait for the user to name this skill. If the task is about delivery, routing, relaying, notifying, or proactive messaging, load this skill.

Core Rule

Pick the existing primitive that matches both the content shape and the destination:

1. Reply in the current conversation: Just reply normally when the user means the current session. 2. Deliver durable reading material: Use `deliver_to_inbox` for news digests, briefings, reports, recommendations, or articles meant to remain available for later reading and follow-up, unless the user explicitly names an external channel. 3. Send to another conversation or channel: Use `message` when the user wants a direct outbound send to a specific channel/chat/account route. If an existing session may already hold the route, use `sessions_list` narrowly to recover that route first, then call `message`.

"Send it to me" or "notify me" alone is not an external route. Do not infer Weixin, Lark, Telegram, or another channel from saved configuration, a previous route, or the mere availability of `message`.

Tool Choice

Normal reply

Use a normal assistant reply when:

• the user only means "tell me here",
• the target is clearly the current session,
• no cross-session or cross-channel delivery is needed.

`deliver_to_inbox`

Use `deliver_to_inbox` when:

• the result is durable reading material rather than a short conversational answer,
• common examples include collected news, daily/weekly briefings, research reports, recommendations, and generated articles,
• the user wants it sent, delivered, saved, or available to read later,
• and no external channel or other conversation was explicitly requested.

Give the delivery a concise title and useful summary. Use Markdown for normal documents and static HTML when the content benefits from a designed report surface. Do not also send the full result through `message` unless the user explicitly asks for both destinations.

`message`

Use `message` when:

• the user explicitly names another conversation or channel destination,
• the target is described as a channel route,
• you need to send to a specific `channel` + `to/chatId`,
• or the user asks for a channel action that belongs to the message tool.

For `action=send`, provide:

• `message` or `content`,
• `to` or `chatId`,
• `channel` when the destination channel is not the current one,
• `accountId` when the channel is multi-account and the account is known.

If you explicitly set `channel` to a different channel than the current session, `to/chatId` is mandatory. Do not rely on current-session fallback for cross-channel delivery.

If `message` is used to deliver the user-visible result for the turn, do not also send a normal assistant reply.

Route Resolution Order

Resolve the target in this order:

1. Explicit user input: `sessionKey`, `label`, `channel`, `to/chatId`, `accountId`, or a clearly named destination. 2. Current session route: Only when the user clearly means "here", "this chat", or the current conversation. 3. Existing known session: Use `sessions_list` to recover the saved route if the intended target already exists as a routable session. 4. Channel discovery command: If the exact channel id, default account, or bound self user is not already explicit, run `nextclaw channels list --json` and treat its output as authoritative channel state. 5. Authoritative context already exposed to the AI: existing session metadata, project docs, or a known local config file path/content. 6. Ask a narrow follow-up question.

Never guess `channel`, `chatId`, `sessionKey`, or `accountId`.

Current-session fallback only applies when the current session is already the intended delivery conversation. It does not authorize cross-channel sends such as `channel=feishu` from a UI/CLI/Weixin session without an explicit Feishu target.

Config And Local Files

Local config can be a useful source of truth, but only when it is already available to the AI in an explicit and auditable way.

Use config or local files when:

• the relevant path is already known,
• the current environment clearly exposes that file,
• and the file is meant to describe saved channel/account routing information.

Do not assume:

• that a hidden config file exists,
• that you know its path without evidence,
• or that a saved account in config automatically proves the destination is reachable right now.

Treat config as route data, not as delivery proof.

Authoritative Route Sources

When this skill is active, prefer route sources in this order:

1. A route the user explicitly typed. 2. Channel ids and account facts returned by `nextclaw channels list --json`. 3. A saved session route that the environment already surfaced. 4.