slack-messaging

Slack 消息最佳实践

本技能提供编写格式清晰、效果良好的 Slack 消息的指导。

适用场景

每当编写、起草 Slack 消息或协助用户撰写 Slack 消息时，都应使用本技能，包括使用 slack_send_message、slack_send_message_draft 或 slack_schedule_message 时。以下格式规则适用于这些消息工具。slack_create_canvas 使用另一种更丰富的 Markdown 方言——请参阅下方的 Canvas 说明。

格式

消息工具（slack_send_message、slack_send_message_draft、slack_schedule_message）接受标准 Markdown，并会在发送时将其转换为 Slack 格式。请使用常规 Markdown。不要使用 Slack 旧版的 mrkdwn 语法（*粗体*、~删除线~）；这些单字符形式在标准 Markdown 中含义不同。每个文本元素的长度上限约为 5000 个字符。

格式	语法
粗体	**text**
斜体	_text_（或 *text*）
删除线	~~text~~
行内代码	`code`
引用	> text
链接	[display text](url)
项目符号列表	- item
编号列表	1. item

也可以使用块级元素。请将它们写成原始 Markdown：

• 代码块，可选语言以启用语法高亮：

  ```python
  print("hello")
  ```
  

• 表格，使用 | 分隔符（单元格中的字面竖线请写作 \|）：

  | Feature | Status |
  |---------|--------|
  | Tables  | works  |
  

• 标题，使用 # / ## / ###：

  ## Section title
  

消息中唯一无法嵌入的是行内图片（![alt](url)），它们通常会显示为普通链接，而不是行内图片。若要使用富嵌入式布局（按钮、图片、结构化卡片），需要使用 Block Kit；若要使用可嵌入图片的文档式界面，请使用 canvas。请参阅下方的说明。

消息结构指南

• 开门见山。 在第一行写出最重要的信息。许多人会在手机上或通知中阅读 Slack，而这些场景通常只显示第一行。
• 简明扼要。 尽量控制在 1-3 个简短段落内（约 5000 个字符的上限是限制，而非目标）。如果消息较长或结构复杂，可以考虑改用 Canvas。
• 多用换行。 大段文字不易阅读。用空行分隔不同的想法。
• 列表使用项目符号。 包含 3 项或更多内容时，应使用列表，而不是连写成一个长句。
• 突出关键信息。 对姓名、日期、截止时间和待办事项使用 **粗体**，便于读者快速浏览时注意到。

线程与频道礼仪

• 回复特定消息时，在对应线程中回复，保持主频道整洁。
• 只有当回复包含所有人都需要了解的信息时，才使用 reply_broadcast（同时发布到频道）。
• 开启新话题、发布公告或向整个群组提问时，直接发到频道（不要发在线程中）。
• 不要开启新线程来继续已有对话；请找到原始消息并在其中回复。

语气与受众

• 根据频道调整语气：#general 通常比 #random 更正式。
• 对于简单的确认，请使用 slack_add_reaction 添加表情回应，而不是发送回复消息（使用 slack_get_reactions 查看已有回应）。
• 撰写公告时，请采用清晰的结构：背景、关键信息、行动号召。

定时发送

• 使用 slack_schedule_message 延后发送消息。post_at 是 Unix 时间戳，必须至少比当前时间晚 2 分钟，且不得超过 120 天；消息正文使用与上述相同的标准 Markdown。
• 设定定时消息后，无法通过 API 编辑——用户可在 Slack 的草稿和已发送中管理这些消息。

注意事项

• Canvas 的格式不同。 slack_create_canvas 使用 Canvas 风格的 Markdown，这是一种比消息工具更丰富的方言：标题、表格、清单和内嵌图片（![alt](url)）都能正常显示，它还支持用户／频道引用卡片、提示框和分栏。不要假设上述消息规则适用——编写 Canvas 时，请遵循 slack_create_canvas 工具自身的格式指南。
• 范围： 此技能负责编写和格式化通过 Slack MCP 消息工具发送的消息_文本_。对于交互式布局（按钮、菜单、模态框、主页标签页或任何 Block Kit JSON），请使用 slack:block-kit 技能来编写和验证区块载荷。若要直接调用 Slack Web API（如 chat.postMessage 等），而不是使用 MCP 工具，请使用 slack:slack-api 技能。