홈 항목 library logo 글 코드베이스 상점
자세히
Agent Skills › Lifecycle-Innovations-Limited/claude-ops › ops-comms

ops-comms

GitHub

跨渠道消息收发与读取技能，支持WhatsApp、邮件、Slack等。集成上下文加载、偏好匹配及桥接健康检查，实现统一通信路由。

claude-ops/skills/ops-comms/SKILL.md Lifecycle-Innovations-Limited/claude-ops

Trigger Scenarios

通过自然语言指令发送消息 查询特定联系人或渠道的历史消息 检查并维护WhatsApp桥接服务状态

Install

npx skills add Lifecycle-Innovations-Limited/claude-ops --skill ops-comms -g -y
More Options

Non-standard path

npx skills add https://github.com/Lifecycle-Innovations-Limited/claude-ops/tree/main/claude-ops/skills/ops-comms -g -y

Use without installing

npx skills use Lifecycle-Innovations-Limited/claude-ops@ops-comms

指定 Agent (Claude Code)

npx skills add Lifecycle-Innovations-Limited/claude-ops --skill ops-comms -a claude-code -g -y

安装 repo 全部 skill

npx skills add Lifecycle-Innovations-Limited/claude-ops --all -g -y

预览 repo 内 skill

npx skills add Lifecycle-Innovations-Limited/claude-ops --list

SKILL.md

Frontmatter 
{
    "name": "ops-comms",
    "effort": "medium",
    "maxTurns": 40,
    "description": "Send and read messages across all channels. Routes based on arguments — whatsapp, email, slack, telegram, discord, notion, or natural language like \"send [msg] to [contact]\". WhatsApp via mcp__whatsapp__* (Baileys bridge).",
    "allowed-tools": [
        "Bash",
        "Read",
        "Grep",
        "Glob",
        "Skill",
        "AskUserQuestion",
        "mcp__claude_ai_Gmail__search_threads",
        "mcp__claude_ai_Gmail__get_thread",
        "mcp__claude_ai_Gmail__create_draft",
        "mcp__claude_ai_Slack__slack_send_message",
        "mcp__claude_ai_Slack__slack_read_channel",
        "mcp__claude_ai_Slack__slack_search_users",
        "mcp__claude_ai_Slack__slack_search_public_and_private",
        "mcp__claude_ops_telegram__send_message",
        "mcp__claude_ops_telegram__get_updates",
        "mcp__claude_ops_telegram__list_chats",
        "mcp__claude_ai_Notion__notion-search",
        "mcp__claude_ai_Notion__notion-fetch",
        "mcp__claude_ai_Notion__notion-get-comments",
        "mcp__claude_ai_Notion__notion-create-comment",
        "mcp__claude_ai_Notion__notion-update-page",
        "mcp__claude_ai_Notion__notion-create-pages"
    ],
    "argument-hint": "[channel] | send [message] to [contact] | read [channel] | notion [search query]"
}

OPS ► COMMS

Runtime Context

Before executing, load available context:

  1. Daemon health: Read ${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/daemon-health.json

    • Check bridge liveness before any WhatsApp operation: lsof -i :8080 | grep LISTEN
    • If bridge not running, prompt user to restart: launchctl kickstart -k gui/$UID/com.${USER}.whatsapp-bridge

  2. Ops memories: Before drafting any message, check ${CLAUDE_PLUGIN_DATA_DIR}/memories/:

    • contact_*.md — load profile for the recipient
    • preferences.md — match user's communication style, language, and tone
    • donts.md — restrictions that must not appear in any draft

  3. Preferences: Read ${CLAUDE_PLUGIN_DATA_DIR}/preferences.json for default_channels to determine which channel to prefer when multiple are available for a contact.

CLI/API Reference

whatsapp-bridge (WhatsApp — mcpwhatsapp*)

Bridge health — check bridge is running before any WhatsApp operation:

lsof -i :8080 | grep LISTEN
launchctl list com.${USER}.whatsapp-bridge

If not running: launchctl kickstart -k gui/$(id -u)/com.${USER}.whatsapp-bridge

Tool Params Output
mcp__whatsapp__list_chats {sort_by: "last_active"} Array of chats with jid, name, last_message_time
mcp__whatsapp__list_messages {chat_jid, limit, query} Array of messages with is_from_me, content, timestamp, sender
mcp__whatsapp__search_contacts {query} Contacts matching name or phone
mcp__whatsapp__send_message {recipient, message} Send result
mcp__whatsapp__get_chat {chat_jid} Chat metadata
mcp__whatsapp__get_message_context {chat_jid, message_id} Message context window

gog CLI (Gmail/Calendar)

Command Usage Output
gog gmail search "in:inbox" --max 50 -j --results-only --no-input Search inbox JSON array of threads
gog gmail thread get <threadId> -j Get full thread with all messages Full message JSON
gog gmail send --to "user@example.com" --subject "subj" --body "text" Send new email Send result
gog gmail send --reply-to-message-id <msgId> --reply-all --body "text" Reply all Send result
gog gmail send --to "a@b.com" --subject "subj" --body "text" --attach /path/file With attachment Send result
gog gmail archive <messageId> ... --no-input --force Archive messages Archive result

Parse $ARGUMENTS and route immediately:

Routing table

Pattern Action
whatsapp Show WhatsApp recent chats — offer to read or send
email Show recent email threads via Gmail MCP
slack Show recent Slack activity
telegram Show Telegram recent chats
discord Show recent Discord channel activity (via bin/ops-discord)
notion Search Notion workspace — pages, comments, tasks
voice Voice / phone / video — routes to /ops:ops-voice (bin/ops-voice)
call * Native Phone.app call via bin/ops-voice phone
facetime * FaceTime audio/video via bin/ops-voice facetime
zoom Start an instant Zoom meeting via bin/ops-voice zoom start
send * to * Parse message and contact, determine best channel, send
read * Read the specified channel or contact's messages
home alarm Pipe a Homey alarm event as a WhatsApp/Telegram alert — delegates to /ops:ops-home alarm --notify (only if home_automation is configured in $PREFS_PATH)
(empty) Show channel picker menu

Natural-language parsing:

  • send "deploy done" to #general on discord → bin/ops-discord send general "deploy done".
  • call <contact> / dial <contact> / phone <contact> → resolve number, then bin/ops-voice phone <E.164>.
  • facetime <contact> (with optional audio) → bin/ops-voice facetime <handle> [--audio].
  • start a zoom / new zoom meeting → bin/ops-voice zoom start.
  • join zoom <ID> → bin/ops-voice zoom join <ID>.
  • text <contact> "<body>" / sms <contact> "<body>" → bin/ops-voice twilio-sms <to> $TWILIO_FROM_NUMBER "<body>" (guarded by per-message approval).

Send flow: send [message] to [contact]

  1. Parse contact name and message from $ARGUMENTS.
  2. Determine channel by contact lookup:
    • Check WhatsApp: mcp__whatsapp__search_contacts {query: "[contact]"} 2>/dev/null
    • Check Slack: mcp__claude_ai_Slack__slack_search_users with query: "[contact]"
    • Check email: known from context or ask
  3. If multiple channels found, use AskUserQuestion: [WhatsApp] / [Slack] / [Email]
  4. Always preview before sending. Use AskUserQuestion to confirm:
Ready to send via [channel]:
  To: [contact name] ([identifier])
  Message: "[full message text]"

  [Send now]  [Edit message]  [Cancel]

If user picks "Edit message", use AskUserQuestion with free-text to get the revised message, then re-preview.

  1. Send via the chosen channel. Confirm with: Sent to [contact] via [channel] ✓

WhatsApp send

CRITICAL — READ BEFORE SENDING: Before drafting ANY WhatsApp reply, you MUST:

  1. Read the full conversation: mcp__whatsapp__list_messages {chat_jid: "<JID>", limit: 20}
  2. Understand which messages have is_from_me: true (user sent) vs is_from_me: false (contact sent)
  3. Summarize what the conversation is about and what the contact is asking
  4. Only THEN draft a reply that addresses what the contact actually said

Never send a reply based on a single message. A message like "can you pull it from Klaviyo?" means nothing without knowing what "it" refers to from prior messages.

Pre-flight: Check bridge is running: lsof -i :8080 | grep LISTEN. If not running, restart: launchctl kickstart -k gui/$(id -u)/com.${USER}.whatsapp-bridge and wait 5s.

mcp__whatsapp__send_message {recipient: "[contact_jid]", message: "[message]"}

Slack send

Use mcp__claude_ai_Slack__slack_send_message with resolved channel/user ID.

Email send (draft)

Use mcp__claude_ai_Gmail__create_draft — always create draft first. Then use AskUserQuestion:

Draft created for [recipient]:
  Subject: [subject]
  Body: [preview]

  [Send now]  [Keep as draft]  [Edit]

Read flow: read [channel]

WhatsApp:

mcp__whatsapp__list_chats {sort_by: "last_active"}

Show last 10 chats with sender, preview, timestamp. Use mcp__whatsapp__list_messages {chat_jid, limit: 5} to preview each chat.

Email: Use mcp__claude_ai_Gmail__search_threads with query: "in:inbox" (NOT is:unread — scan full inbox including read messages), show thread list.

Slack (multi-workspace):

Read the derived channels.slack.workspaces[] object from the pre-gathered bin/ops-unread output (NOT the raw preferences.json → slack_workspaces[], which has no available field — it only persists workspace metadata). The bin/ops-unread step resolves each workspace's token_env and emits available: true|false per entry. Iterate that array:

  • For each available: true entry, use mcp__claude_ai_Slack__slack_search_public_and_private with query: "in:channel" (NOT is:unread) if the MCP token matches, or direct curl for non-bound workspaces. To resolve the token for direct curl, the entry's token_env field is the name of the env var; validate it matches ^[A-Za-z_][A-Za-z0-9_]*$ before indirect expansion (${!token_env}) to avoid bash aborting on invalid identifiers.
  • Label results with the workspace name: Slack/<workspace_a>, Slack/<workspace_b>, etc.
  • channels.slack.multi_workspace == false / legacy mode: fall back to mcp__claude_ai_Slack__slack_search_public_and_private if channels.slack.available == true, otherwise report "Slack not configured".

Telegram: Use mcp__claude_ops_telegram__get_updates (limit: 20) and mcp__claude_ops_telegram__list_chats. Fall back to: telegram-cli --exec "dialog_list" 2>/dev/null || echo "Telegram MCP not configured"

Discord: ${CLAUDE_PLUGIN_ROOT}/bin/ops-discord read "<CHANNEL_ID>" --limit 20 --json — requires DISCORD_BOT_TOKEN (or credential-store discord/bot-token). Fall back to bin/ops-discord channels --json if the user doesn't know the channel ID and DISCORD_GUILD_ID is set.

Notion: Use mcp__claude_ai_Notion__notion-search with the user's query (or query: "" sorted by last_edited_time for general browsing). For each result:

  • Fetch full page content with mcp__claude_ai_Notion__notion-fetch using the page URL/ID from search results
  • Get comments with mcp__claude_ai_Notion__notion-get-comments
  • Show page title, database name, last editor, and recent comments

Notion API fallback: If MCP tools fail and NOTION_API_KEY is set, use curl -s -H "Authorization: Bearer $NOTION_API_KEY" -H "Notion-Version: 2022-06-28" -X POST https://api.notion.com/v1/search -d '{"query":"<QUERY>","page_size":10}'

Notion comment/reply

Use mcp__claude_ai_Notion__notion-create-comment with the page ID to reply to a comment thread. For creating new pages in a database, use mcp__claude_ai_Notion__notion-create-pages.

Always preview before commenting:

Ready to comment on Notion page:
  Page: [page title]
  Comment: "[comment text]"

  [Post comment]  [Edit]  [Cancel]

Telegram send

Use mcp__claude_ops_telegram__send_message with chat_id (from list_chats) and text.

Discord send

Shell out to bin/ops-discord send. Three invocation shapes:

# By channel alias (resolves DISCORD_WEBHOOK_<UPPER> or DISCORD_WEBHOOK_URL)
${CLAUDE_PLUGIN_ROOT}/bin/ops-discord send "<channel-alias>" "<message>" --json

# By channel snowflake (17-20 digit ID, routed through bot token)
${CLAUDE_PLUGIN_ROOT}/bin/ops-discord send "<CHANNEL_ID>" "<message>" --json

# By full webhook URL (useful when the URL is stored per-project)
${CLAUDE_PLUGIN_ROOT}/bin/ops-discord send "https://discord.com/api/webhooks/<ID>/<TOKEN>" "<message>" --json

If the script exits 1 with {"error":"no discord credential configured — run /ops:setup discord"}, prompt the user via AskUserQuestion (≤4 options per Rule 1): [Run /ops:setup discord] / [Paste webhook URL now] / [Skip]. Do NOT silently skip — that violates Rule 3.

Note: DISCORD_WEBHOOK_URL is shared with the ops-fires notification sink (scripts/ops-notify.sh). When pre-existing, prefer it as the default for /ops:comms discord send rather than asking the user to set a separate value.

Voice / phone / video

All voice traffic flows through bin/ops-voice (full surface documented in the ops-voice skill). Native channels (Phone.app, FaceTime, Zoom start|join) need no credentials; programmatic channels (Twilio voice/SMS, Bland AI, Zoom schedule) follow the standard credential-resolution order.

# Native — no creds
${CLAUDE_PLUGIN_ROOT}/bin/ops-voice phone    "+1234567890" --json
${CLAUDE_PLUGIN_ROOT}/bin/ops-voice facetime user@example.com --audio --json
${CLAUDE_PLUGIN_ROOT}/bin/ops-voice zoom     start
${CLAUDE_PLUGIN_ROOT}/bin/ops-voice zoom     join 1234567890 --pwd <password>

# Programmatic — gated by Rule 6 (per-message approval)
${CLAUDE_PLUGIN_ROOT}/bin/ops-voice twilio-call "+1234567890" "$TWILIO_FROM_NUMBER" --twiml "<URL>" --json
${CLAUDE_PLUGIN_ROOT}/bin/ops-voice twilio-sms  "+1234567890" "$TWILIO_FROM_NUMBER" "<body>" --json
${CLAUDE_PLUGIN_ROOT}/bin/ops-voice bland-call  "+1234567890" "<task prompt>" --json

Send-flow integration: when $ARGUMENTS looks like call <contact>, facetime <contact>, text <contact> "<body>", or have an AI call <contact> and ...:

  1. Resolve the contact's number/handle (mcp__whatsapp__search_contacts or preferences.json → contacts).
  2. For native calls (phone, facetime, zoom): preview [Place call via <channel> to <contact>] [Cancel] then invoke.
  3. For Twilio voice/SMS and Bland AI: stage the full draft (recipient, channel, body or task-prompt) and gate behind one AskUserQuestion per message (Rule 6). Never batch.
  4. If no credential resolves for a programmatic channel, prompt via AskUserQuestion with [Run /ops:ops-voice setup] / [Paste credential now] / [Try native instead] / [Skip] (Rule 3 — never silently skip).

Empty arguments — channel picker

Display the header, then use batched AskUserQuestion calls (max 4 options each):

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 OPS ► COMMS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Before presenting options, read ${CLAUDE_PLUGIN_DATA_DIR}/preferences.json and check which channels are configured. Only show configured channels. If <=4 total options (configured channels + "Send a message"), present in a single call. If >4, batch:

AskUserQuestion call 1 — Read channels:

  [Read WhatsApp]
  [Read Email]
  [Read Slack]
  [More...]

AskUserQuestion call 2 (only if "More..."):

  [Read Telegram]
  [Make a call (voice)]
  [Send a message]

If all channels are configured, that's 6+ options — always batch. If only 3 channels are configured, "Read X" + "Read Y" + "Read Z" + "Send a message" = 4, fits in one call. The voice channel is configured iff preferences.json → channels.voice is present OR default_channels contains "voice".

Execute the selected action.

Ledger Integration

CLAIM_KEY by channel and message unit:

  • Slack thread: slack:thread:<channel>:<ts>
  • WhatsApp message: slack:thread:wa:<jid>:<ts> (reuse slack: namespace for threads)
  • Outbound draft (no inbound thread): comms:draft:<channel>:<YYYY-MM-DDTHH-MM>

Pre-flight skip-check

CLAIM_KEY="slack:thread:<channel>:<ts>"   # adjust per channel
ledger query --claim-key "$CLAIM_KEY" --since=-PT24H

Skip any message/thread where a done or in_progress entry exists. Surface awaiting_sam entries as "draft already staged — resend or edit?"

Claim + resolve

# Claim before drafting
ledger write \
  --claim-key "$CLAIM_KEY" \
  --kind "draft" \
  --status "in_progress" \
  --title "Comms: <channel> — <brief description>" \
  --ttl-sec 3600

# After user approves + send fires
ledger write \
  --claim-key "$CLAIM_KEY" \
  --kind "send" \
  --status "done" \
  --title "Comms: <channel> — <brief description>" \
  --context "sent via <channel>"

Version History

  • 64bad13 Current 2026-08-12 09:00

Same Skill Collection

boss

claude-ops/skills/boss/SKILL.md

flow

claude-ops/skills/flow/SKILL.md

ledger

claude-ops/skills/ledger/SKILL.md

ops-accounts

claude-ops/skills/ops-accounts/SKILL.md

ops-ar

claude-ops/skills/ops-ar/SKILL.md

ops-aws-audit

claude-ops/skills/ops-aws-audit/SKILL.md

ops-competitors

claude-ops/skills/ops-competitors/SKILL.md

ops-credentials

claude-ops/skills/ops-credentials/SKILL.md

ops-daemon

claude-ops/skills/ops-daemon/SKILL.md

ops-dash

claude-ops/skills/ops-dash/SKILL.md

ops-deploy-fix

claude-ops/skills/ops-deploy-fix/SKILL.md

ops-deploy

claude-ops/skills/ops-deploy/SKILL.md

ops-desktop

claude-ops/skills/ops-desktop/SKILL.md

ops-doctor

claude-ops/skills/ops-doctor/SKILL.md

ops-ecom

claude-ops/skills/ops-ecom/SKILL.md

ops-feature-dev

claude-ops/skills/ops-feature-dev/SKILL.md

ops-fires

claude-ops/skills/ops-fires/SKILL.md

ops-fleet

claude-ops/skills/ops-fleet/SKILL.md

ops-go

claude-ops/skills/ops-go/SKILL.md

ops-gtm

claude-ops/skills/ops-gtm/SKILL.md

ops-home

claude-ops/skills/ops-home/SKILL.md

ops-inbox

claude-ops/skills/ops-inbox/SKILL.md

ops-integrate

claude-ops/skills/ops-integrate/SKILL.md

ops-leadgen

claude-ops/skills/ops-leadgen/SKILL.md

ops-linear

claude-ops/skills/ops-linear/SKILL.md

ops-mac

claude-ops/skills/ops-mac/SKILL.md

ops-marketing

claude-ops/skills/ops-marketing/SKILL.md

ops-mcp

claude-ops/skills/ops-mcp/SKILL.md

ops-merge

claude-ops/skills/ops-merge/SKILL.md

ops-monitor

claude-ops/skills/ops-monitor/SKILL.md

ops-next

claude-ops/skills/ops-next/SKILL.md

ops-orchestrate

claude-ops/skills/ops-orchestrate/SKILL.md

ops-package

claude-ops/skills/ops-package/SKILL.md

ops-pocket

claude-ops/skills/ops-pocket/SKILL.md

ops-projects

claude-ops/skills/ops-projects/SKILL.md

ops-recap

claude-ops/skills/ops-recap/SKILL.md

ops-release

claude-ops/skills/ops-release/SKILL.md

ops-resume

claude-ops/skills/ops-resume/SKILL.md

ops-revenue

claude-ops/skills/ops-revenue/SKILL.md

ops-rotate-setup

claude-ops/skills/ops-rotate-setup/SKILL.md

ops-rotate

claude-ops/skills/ops-rotate/SKILL.md

ops-secret-sync

claude-ops/skills/ops-secret-sync/SKILL.md

ops-settings

claude-ops/skills/ops-settings/SKILL.md

ops-ship

claude-ops/skills/ops-ship/SKILL.md

ops-speedup

claude-ops/skills/ops-speedup/SKILL.md

ops-status

claude-ops/skills/ops-status/SKILL.md

ops-triage

claude-ops/skills/ops-triage/SKILL.md

ops-unifi

claude-ops/skills/ops-unifi/SKILL.md

ops-update

claude-ops/skills/ops-update/SKILL.md

View Skill Collection ›

Metadata

Files
0
Version
64bad13
Hash
4daf1f1a
Indexed
2026-08-12 09:00

홈 - 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-12 18:53
浙ICP备14020137号-1 $방문자$