# Slack Block Kit 格式化技巧这项技能教代理使用 Block Kit 格式化 Slack 消息，Block Kit 是一个基于 JSON 的 UI 框架，用于构建丰富的交互式消息。 ## 何时应用此技能申请时间： * 通过MCP工具发送Slack消息 * 创建通知、警报或状态更新 * 使用按钮或菜单构建交互式消息 * 为 Slack 格式化 EOD/EOW 报告 * 任何看起来专业的消息 ## MCP 工具 **服务器：** `composio-config` (Composio) **工具：** `SLACK_SEND_MESSAGE` { “频道”：“C12345678”， "text": "通知的备用文本", “块”：[...] } **重要提示：** 始终包含顶级“文本”作为通知后备。 ** ** ## 架构消息负载 └──blocks[]（布局容器，最多50个） └── 块元素（交互组件） └── 合成对象（文本、选项） ** ** ## 块类型快速参考类型 |用于 |关键规则 ---|---|--- `标题` |标题 |最多 150 个字符，仅限“纯文本” `部分` |主要内容 | 3000个字符，可以有配件 `分隔线` |视觉分离|没有内容 `图像` |独立图像 |需要 HTTPS URL，需要“alt_text” `上下文` |元数据、时间戳 |最多 10 个元素，呈现小/静音 `行动` |按钮行、菜单|最多 25 个元素 `表` |表格数据| **每条消息 1 条**，最多 100 行，20 列 `丰富的文本` |格式化文本|列表、引号、代码块、样式文本 ** ** ## 表块（新） **限制：** * **每条消息仅 1 个表**（错误：`only_one_table_allowed`） * 表格呈现在消息底部（已附加） * 最大100行，20列 * 单元格可以是“raw_text”或“rich_text” ### 基本表 { “类型”：“表”， “列设置”：[ {“对齐”：“左”}， {“对齐”：“居中”}， {“对齐”：“右”} ], “行”：[ [ {“类型”：“raw_text”，“文本”：“名称”}， {“类型”：“raw_text”，“文本”：“计数”}， {“类型”：“raw_text”，“文本”：“值”} ], [ {“类型”：“raw_text”，“文本”：“项目A”}， {“类型”：“raw_text”，“文本”：“5”}， {“类型”：“raw_text”，“文本”：“$ 100”} ] ] } ### 列设置物业 |类型 |描述 ---|---|--- `对齐` |字符串| “左”、“中”或“右” `is_wrapped` |布尔 |是否对长文本进行换行（默认：false） ### 带有富文本单元格的表格（链接，粗体） { “类型”：“表”， “行”：[ [ { "type": "raw_text", "text": "交易" }, {“类型”：“raw_text”，“文本”：“ARR”} ], [ { “类型”：“rich_text”， “元素”：[ { “类型”：“rich_text_section”， “元素”：[ { “类型”：“链接”， “文本”：“Acme 公司”， “网址”：“https://hubspot.com/deal/123” } ] } ] }, { “类型”：“rich_text”， “元素”：[ { “类型”：“rich_text_section”， “元素”：[ { "type": "text", "text": "$50,000", "style": { "bold": true } } ] } ] } ] ] } ** ** ## 富文本块富文本比 mrkdwn 提供了更多的灵活性。用于复杂的格式化需求。 ### 富文本部分（基本） { “类型”：“rich_text”， “元素”：[ { “类型”：“rich_text_section”， “元素”：[ {“类型”：“文本”，“文本”：“你好”}， { "type": "text", "text": "粗体文本", "style": { "bold": true } }, {“类型”：“文本”，“文本”：“和”}， {“类型”：“文本”，“文本”：“斜体”，“样式”：{“斜体”：true } } ] } ] } ### 富文本列表（项目符号/编号） { “类型”：“rich_text”， “元素”：[ { “类型”：“rich_text_section”， "elements": [{ "type": "text", "text": "发布的功能:" }] }, { “类型”：“rich_text_list”， “风格”：“子弹”， “元素”：[ { “类型”：“rich_text_section”， "elements": [{ "type": "text", "text": "HubSpot 集成" }] }, { “类型”：“rich_text_section”， "elements": [{ "type": "text", "text": "移动改进" }] } ] } ] } ### 富文本引用 { “类型”：“rich_text”， “元素”：[ { “类型”：“rich_text_quote”， “元素”：[ { “类型”：“文本”， "text": "这确实会改变我们的工作方式。" } ] } ] } ### 富文本元素类型类型 |属性 |用于 ---|---|--- `文本` | `文本`、`样式` |纯文本/样式文本 `链接` | `url`、`text`、`style` |可点击的链接 `用户` | `user_id`, `风格` | @提及 `频道` | `channel_id`, `风格` | #频道链接 `用户组` | `usergroup_id`, `风格` | @group 提及 `表情符号` | `名称`、`unicode` |表情符号 `日期` | `时间戳`、`格式` |格式化日期 `广播` | `范围`（此处/频道/所有人）| @这里/@频道/@大家 ### 文本样式对象 { “风格”：{ “大胆”：真实， “斜体”：正确， “罢工”：真实， “代码”：正确 } } ** ** ## 块 JSON 结构 ### 标题块 { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":rocket: 标题文本在这里", “表情符号”：正确 } } ### 节块 { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*粗体*和_斜体_文本带有 " } } ### 带配件（按钮）部分 { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "您的会议已处理。" }, “配件”：{ “类型”：“按钮”， "text": { "type": "plain_text", "text": "查看", "emoji": true }, “url”：“https://app.askelephant.com/meetings/123”， “action_id”：“查看会议” } } ### 包含字段的部分（两列布局） { “类型”：“部分”， “字段”：[ { "type": "mrkdwn", "text": "*状态:*\n完成" }, { "type": "mrkdwn", "text": "*持续时间:*\n45 分钟" }, { "type": "mrkdwn", "text": "*出席人数:*\n4 人" }, { "type": "mrkdwn", "text": "*优先级:*\n高" } ] } **规则：** 最多 10 个字段，每个字段最多 2000 个字符。 ### 分隔块 { “类型”：“分隔符” } ### 图像块 { “类型”：“图像”， "image_url": "https://example.com/chart.png", "alt_text": "第四季度收入图表" } ### 上下文块 { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": ":clock1: 发布于 " } ] } ### 动作块 { “类型”：“动作”， “block_id”：“actions_1”， “元素”：[ { “类型”：“按钮”， "text": { "type": "plain_text", "text": "批准", "emoji": true }, “风格”：“主要”， "action_id": "approve_btn", “值”：“已批准” }, { “类型”：“按钮”， "text": { "type": "plain_text", "text": "拒绝", "emoji": true }, “风格”：“危险”， "action_id": "reject_btn", “价值”：“拒绝” } ] } **按钮样式：** `primary`（绿色）、`danger`（红色）或省略默认灰色。 ** ** ## mrkdwn 语法（不是标准 Markdown！） ### 文本格式格式|语法 |示例 ---|---|--- 大胆| `*文本*` | `*重要*` 斜体 | `_文本_` | `_强调_` 删除线 | `~文本~` | `~删除了~` 代码| ``代码`` | ``函数（）`` 代码块 | ````代码```` |多线报价 | `>文本` |缩进 ### 链接和提及类型 |语法 ---|--- 网址 | `` 带有文字的网址 | `` 用户提及| `<@U12345678>` 频道链接| `<#C12345678>` @这里 | `<！此处>` @频道 | `` ### 转义字符人物 |逃脱为 ---|--- `&` | `&` `<` | `<` `>` | `>` ### 不支持（常见错误）错误 |正确 ---|--- `**粗体**` | `*粗体*` `*斜体*` | `_斜体_` `[文本](url)` | `` `# 标头` |使用标题块 ** ** ## 按用例划分的消息模板 ### 通讯模板（抛光）用于公司范围内的更新、每周摘要或公告。 { "text": "造纸公司通讯 - 2019 年 11 月 12 日", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， “文本”：“：报纸：AskElephant更新：报纸：”， “表情符号”：正确 } }, { “类型”：“上下文”， “元素”：[ { "text": "*2026 年 1 月 28 日* | 产品团队", “类型”：“mrkdwn” } ] }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， “text”：“：loud_sound：*以防万一您错过了*：loud_sound：” } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*HubSpot 集成*上周发布。客户现在可以自动将所有会议数据同步到 HubSpot。" }, “配件”：{ “类型”：“按钮”， "text": { "type": "plain_text", "text": "了解更多", "emoji": true }, “url”：“https://docs.askelephant.com/hubspot” } }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， “文本”：“：日历：| *即将到来* |：日历：” } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "`02/01` *发言者 ID V2* - 改进了发言者识别\n`02/15` *管理员入门* - 简化的工作区设置" } }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， “text”：“*供您参考*” } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": ":bulb: *移动应用程序更新*现已推出。确保客户进行更新以获得更好的录音可靠性。" } }, {“类型”：“分隔符”}， { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": ":pushpin: 有问题吗？请将它们放入 *#product-forum*" } ] } ] } ### Rob Report（收入团队，简单语言）仅用于使用简化语言和客户可见功能的 CRO/收入团队更新。 { "text": "新增内容 - 2026 年 1 月 27 日", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "新增内容 - 2026 年 1 月 27 日", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "嘿收入团队！这是您现在可以供客户使用的已发货内容。" } }, {“类型”：“分隔符”}， { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "最新消息", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*应用程序现在运行速度更快* — 页面加载速度更快，尤其是在进行大量对话时。\n\n*@ 在聊天中提及效果更好* — AskElephant 更可靠地了解您在谈论谁。" } }, {“类型”：“分隔符”}， { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "我们修复了什么", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "• 通知横幅在错误的时间显示\n• 滚动不再跳跃\n• 会议详细信息中的单词被切断" } }, {“类型”：“分隔符”}， { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "收入获胜", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*新 ARR 总额：* 20,399 美元（4 笔交易）\n*扩张：* 5,700 美元（Hadco Construction）\n*ARR 影响总额：* 26,100 美元" } }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "_您的团队现在可以使用列出的所有功能。_" } }, { “类型”：“表”， “列设置”：[ {“对齐”：“左”}， {“对齐”：“居中”}， {“对齐”：“居中”}， {“对齐”：“居中”}， {“对齐”：“居中”} ], “行”：[ [ {“类型”：“raw_text”，“文本”：“SDR”}， { "type": "raw_text", "text": "Convos" }, { "type": "raw_text", "text": "音调" }, { "type": "raw_text", "text": "会议" }, { "type": "raw_text", "text": "ICP 举行" } ], [ {“类型”：“raw_text”，“文本”：“贾米斯·本森”}， {“类型”：“raw_text”，“文本”：“7”}， {“类型”：“raw_text”，“文本”：“6”}， {“类型”：“raw_text”，“文本”：“4”}， {“类型”：“raw_text”，“文本”：“2”} ], [ { "type": "raw_text", "text": "卡特·托马斯" }, {“类型”：“raw_text”，“文本”：“8”}， {“类型”：“raw_text”，“文本”：“6”}， {“类型”：“raw_text”，“文本”：“5”}， {“类型”：“raw_text”，“文本”：“1”} ], [ { "type": "raw_text", "text": "团队总计" }, {“类型”：“raw_text”，“文本”：“18”}， {“类型”：“raw_text”，“文本”：“14”}， {“类型”：“raw_text”，“文本”：“12”}， {“类型”：“raw_text”，“文本”：“3”} ] ] } ] } ### 每日文摘（工程/产品） { "text": "问大象每日文摘", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "问大象每日文摘", “表情符号”：正确 } }, { “类型”：“上下文”， “元素”：[ { "type": "mrkdwn", "text": ":报纸: 2026 年 1 月 23 日，星期四" } ] }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:奖杯：今日头条*\n\n>*拨号盘上线 + 桌面稳定性* — 现已集成另一个主要电话平台。" } }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:sparkles：新功能*\n\n*CRM 集成*\n• 拨号盘直接集成 — 全面的电话支持\n• 拨号盘事件处理 — 重复数据删除和路由\n\n*录音和捕获*\n• 桌面 MP4 音频 — 更高质量的录音\n• 网络录音视觉反馈" } }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:扳手：改进*\n\n• 恢复参与页面\n• AI 描述改进\n• 查询性能检测" } }, {“类型”：“分隔符”}， { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:bug: 已修复的错误：6*\n\n• 自动注销切换已恢复\n• 桌面录制停止可靠性\n• 移动推送通知传送" } }, {“类型”：“分隔符”}， { “类型”：“部分”， "text": { "type": "mrkdwn", "text": "*:busts_in_silhouette: 团队焦点*" } }, { “类型”：“部分”， “字段”：[ { "type": "mrkdwn", "text": "*Eduardo*\n拨号盘、桌面、移动" }, { "type": "mrkdwn", "text": "*Matt Noxon*\n性能，数据加载器" }, { "type": "mrkdwn", "text": "*Jason*\nStripe, PostHog, 分析" }, { "type": "mrkdwn", "text": "*Dylan*\n声纹、嵌入" } ] }, {“类型”：“分隔符”}， { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": ":chart_with_upwards_trend: *统计:* 6 个功能 | 3 个改进 | 6 个错误修复" }, { “类型”：“mrkdwn”， "text": ":rocket: *21 个 PR 合并* • *Eduardo 领先 10*" } ] } ] } ### 交易结束庆祝 { "text": "交易结束：Acme Corp - 50,000 美元 ARR", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":tada: 交易结束！", “表情符号”：正确 } }, { “类型”：“部分”， “字段”：[ { "type": "mrkdwn", "text": "*帐户:*\nAcme Corp" }, { "type": "mrkdwn", "text": "*ARR:*\n$50,000" }, { "type": "mrkdwn", "text": "*Rep:*\n<@U12345>" }, { "type": "mrkdwn", "text": "*类型:*\n新业务" } ] }, { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": "关闭于 " } ] } ] } ### 批准请求（交互式） { "text": "需要批准：企业定价", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":raised_hand: 需要批准", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*企业定价建议*\n新等级为 50 个以上席位，每月 2,500 美元。" } }, { “类型”：“部分”， “字段”：[ { "type": "mrkdwn", "text": "*请求者：*\n<@U12345>" }, { "type": "mrkdwn", "text": "*截止日期:*\n2026 年 2 月 1 日" } ] }, { “类型”：“动作”， "block_id": "approval_actions", “元素”：[ { “类型”：“按钮”， "text": { "type": "plain_text", "text": "批准", "emoji": true }, “风格”：“主要”， “action_id”：“批准提案” }, { “类型”：“按钮”， "text": { "type": "plain_text", "text": "拒绝", "emoji": true }, “风格”：“危险”， “action_id”：“拒绝提案” }, { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "查看详情", “表情符号”：正确 }, “url”：“https://notion.so/proposal-123”， “action_id”：“查看详细信息” } ] } ] } ### 警报/警告 { "text": "警报：API 错误率较高", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":rotating_light: 警报：高错误率", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "API 错误率已超过 5% 阈值。\n\n*当前错误率：* 7.2%\n*阈值：* 5%\n*持续时间：* 15 分钟" } }, { “类型”：“动作”， “元素”：[ { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "查看仪表板", “表情符号”：正确 }, “url”：“https://grafana.example.com/alerts”， “风格”：“主要” }, { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "确认", “表情符号”：正确 }, “action_id”：“ack_alert” } ] }, { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": ":clock1: 在触发" } ] } ] } ** ** ## 模板选择决策树你要送什么？ │ ├── 收入团队的更新（Rob、AE、SDR）？ │ └── 使用：抢劫报告模板 │ • 简单语言（高中阅读水平） │ • 仅限客户可见的功能 │ • SDR 指标的表块 │ ├── 全公司公告？ │ └── 用途：通讯模板 │ • 带表情符号的标题 │ • 日期背景 │ •“以防万一您错过了”部分 │ •“即将到来”，日期用反引号括起来 │ •“供您参考”标注 │ ├── 工程/产品文摘？ │ └── 使用：每日摘要模板 │ • 标题引用块 │ • 分类部分（功能、改进、错误） │ • 团队聚焦领域 │ • 上下文块中的统计信息 │ ├── 成交了吗？ │ └── 使用：交易结束模板 │ • 带有 :tada: 的标头： │ • 账户/ARR/代表/类型字段 │ • 日期背景 │ ├── 需要批准吗？ │ └── 使用：审批请求模板 │ • 带有“批准/拒绝”按钮的操作块 │ • 请求者/截止日期字段 │ ├── 警报/错误？ │ └── 使用：警报模板 │ • :rotating_light: 表情符号 │ • 电流与阈值 │ • 确认按钮 │ └── 表格数据？ └── 使用：表块（每条消息 1 个） • 放在块数组的末尾 • 使用column_settings 进行对齐 • 居中数字列 ** ** ## 块选择快速指南内容类型 |最佳街区 ---|--- 标题/标题 | `标头` 正文 | `部分` 键值对 |带有“字段”的“部分” 文字+按钮| “部分”与“配件” 独立图像 | `图像` 按钮行| `行动` 元数据/页脚 | `上下文` 视觉突破| `分隔线` 表格数据| `table`（每条消息 1 个，位于末尾）复杂的格式| `富文本` ** ** ## 验证清单发送前： * 有效的 JSON 语法 * 根级别的回退“文本”字段 * 所有 `action_id` 值都是唯一的 * 遵守字符限制（标题：150，部分：3000） * 图片 URL 为 HTTPS * mrkdwn 语法正确（不是标准 Markdown） * 最多 50 个消息块 * 只有 1 个表块（如果使用表） * 表块是块数组中的最后一个 ** ** ## 常用表情符号参考类型 |表情符号 ---|--- 成功| `:white_check_mark:` `:tada:` `:rocket:` 警报 | `:警告:` `:rotating_light:` `:感叹号:` 信息 | `:信息来源:` `:备忘录:` `:报纸:` 收入| `:moneybag:` `:chart_with_upwards_trend:` `:troy:` 会议 | `:movie_camera:` `:calendar:` `:busts_in_silhouette:` 开发| `:hammer_and_wrench:` `:gear:` `:package:` `:bug:` 时间 | `:clock1:` `:沙漏:` `:秒表:` 类别 | `:闪闪发光:` `:扳手:` `:大声:` `:灯泡:` ** ** ## 日期格式在 mrkdwn 中使用 ``。代币|输出 ---|--- `{date_num}` | 2026-01-28 `{date_short}` | 2026 年 1 月 28 日 `{date_long}` | 2026 年 1 月 28 日星期一 `{date_pretty}` |今天/昨天/明天或日期 `{时间}` |下午 2:34 `{前}` | 3 分钟前示例： ** ** ## 测试建议在发送之前在 [Block Kit Builder]() 中进行测试。

松弛块套件

包含技能