mcpField
S
slack-mrkdwn

slack-mrkdwn

github.com/ccheney生产力61121 次安装7 周前更新
代码仓库

关于 slack-mrkdwn

根据 Slack 接收字段格式化内容,涵盖 mrkdwn、Markdown、富文本和纯文本,适用于准备消息或载荷,并保留控制语法及字段要求。

主要功能

  1. 01按目标字段选择语法
  2. 02转义不可信的 mrkdwn 字符
  3. 03保留提及和链接控制语法
  4. 04检查字段限制与方法规则
  5. 05查阅对应格式参考

适用场景

  1. 01格式化普通 Slack 消息文本
  2. 02准备 rich_text 或 plain_text 字段内容
  3. 03修正与接收端渲染器不匹配的载荷

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ccheney/robust-skills --skill slack-mrkdwn

安装后在 Claude Code 中输入/slack-mrkdwn确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
CHEATSHEET.md
MESSAGE-BEHAVIOR.md
RENDERERS.md
SYNTAX.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