关于 slack-mrkdwn
根据 Slack 接收字段格式化内容,涵盖 mrkdwn、Markdown、富文本和纯文本,适用于准备消息或载荷,并保留控制语法及字段要求。
主要功能
- 01按目标字段选择语法
- 02转义不可信的 mrkdwn 字符
- 03保留提及和链接控制语法
- 04检查字段限制与方法规则
- 05查阅对应格式参考
适用场景
- 01格式化普通 Slack 消息文本
- 02准备 rich_text 或 plain_text 字段内容
- 03修正与接收端渲染器不匹配的载荷
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ccheney/ robust-skills --skill slack-mrkdwn安装后在 Claude Code 中输入/slack-mrkdwn确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/CHEATSHEET.mdMESSAGE-BEHAVIOR.mdRENDERERS.mdSYNTAX.md详细介绍
Slack 文本格式
根据实际接收字段格式化所提供的内容。用户的明确指示优先于本技能的指南。
选择渲染器
将文本和目标字段/方法作为输入。根据现有载荷推断目标位置;如果不明确且会影响语法,请询问文本将用于哪个界面。对于没有其他上下文的普通 Slack 消息,请说明你使用的是消息 text 和 mrkdwn。
| 目标位置 | 格式 |
|---|---|
消息 text、type: "mrkdwn" 对象 | Slack mrkdwn:*bold*、`<url |
markdown 块、markdown_text、Work Object Markdown 字段 | 标准 Markdown:**bold**、[label](url) |
rich_text 块 | 嵌套元素和样式对象,而非标记字符串 |
标签或 plain_text 对象 | 纯文本 |
保留内容和控制项
- 在 mrkdwn 中按顺序转义不可信的
&、<和>。JSON 转义另行处理。verbatim: true不会中和显式的<...>控制项。 - 提及用户和频道时使用真实 ID。若缺少 ID,请保留明确标注的模板值,或在输出必须可直接发送时询问;不要根据显示名称猜测。
- 保留预期的提及和链接,同时避免引发大范围通知。日期控制项需要包含时区信息的后备文本。
- 保持所提供的后备文本完整,并与块内容一致。不要假设块渲染会提供移动通知文本。
- 检查特定字段的限制和方法组合规则;在文档所述的聊天方法中,非流式
markdown_text不能与text或blocks同时使用。
返回用户要求的格式化字符串、文本对象或修正后的载荷。保留原意;修正渲染器不匹配时,说明原因。无需发布即可完成格式化任务;只有在用户要求或已获授权时才发送。
参考资料
只阅读与目标位置或控制语法相关的部分。
| 任务 | 参考资料 |
|---|---|
| Markdown 界面、文本对象、富文本、Work Object 文本 | RENDERERS.md |
| mrkdwn 语法、提及、日期标记、转义 | SYNTAX.md |
| 链接/展开、解析标记、通知、旧版附件 | MESSAGE-BEHAVIOR.md |
| 精简字段与语法速查 | CHEATSHEET.md |
如需了解界面支持情况的变更,请参阅 Slack 的格式指南和接收字段/方法参考资料。
评论
支持 Markdown