slack-messaging

Slack メッセージ作成のベストプラクティス

このスキルでは、読みやすく効果的な Slack メッセージを作成するためのガイダンスを提供します。

使用する場面

slack_send_message、slack_send_message_draft、slack_schedule_message を使用する場合を含め、Slack メッセージの作成、下書き、またはユーザーによる執筆の支援を行う際は、いつでもこのスキルを適用してください。以下の書式ルールは、これらのメッセージツールを対象としています。slack_create_canvas では、より豊富な別の Markdown 方言を使用します。下記の Canvas に関する注記を参照してください。

書式

メッセージツール（slack_send_message、slack_send_message_draft、slack_schedule_message）は標準的な Markdownを受け付け、送信時に Slack の書式へ変換します。通常の Markdown を記述してください。Slack の従来の mrkdwn 構文（*bold*、~strike~）は使用しないでください。これらの1文字形式は、標準的な Markdown では別の意味になります。各テキスト要素は約5000文字までです。

書式	構文
太字	**text**
斜体	_text_（または *text*）
取り消し線	~~text~~
インラインコード	`code`
引用	> text
リンク	[display text](url)
箇条書き	- item
番号付きリスト	1. item

ブロック要素も使用できます。リテラルな Markdown として記述してください。

• 構文ハイライト用に言語を指定できるコードブロック：

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

• | 区切りの表（セル内のパイプ文字は \| でエスケープします）：

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

• # / ## / ### を使った見出し：

  ## Section title
  

メッセージに埋め込めないものが1つあります。インライン画像（![alt](url)）は通常、インライン画像ではなく通常のリンクとして表示されます。ボタン、画像、構造化カードなどのリッチな埋め込みレイアウトには Block Kit が必要です。画像を埋め込めるドキュメント形式の画面を使う場合は、Canvas を使用してください。下記の注記を参照してください。

メッセージ構成のガイドライン

• 要点を先に述べます。 最も重要な情報を1行目に置いてください。Slack をモバイルや通知で読む人も多く、その場合は1行目だけが表示されます。
• 簡潔にまとめます。 短い段落を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 の Drafts & sent から管理します。

注意事項

• Canvas の書式は異なります。 slack_create_canvas は、メッセージツールよりも表現力豊かな Canvas 独自の Markdown を使用します。見出し、表、チェックリスト、インライン画像（![alt](url)）を埋め込めるほか、ユーザー／チャンネルの参照カード、コールアウト、カラムにも対応しています。上記のメッセージのルールが適用されると決めつけないでください。Canvas を作成する際は、slack_create_canvas ツール独自の書式ガイドラインに従ってください。
• 対象範囲： このスキルは、Slack MCP メッセージツール経由で送信するメッセージの テキスト の作成と書式設定を担います。インタラクティブなレイアウト（ボタン、メニュー、モーダル、ホームタブ、または Block Kit JSON）には、ブロックのペイロードを作成・検証する slack:block-kit スキルを使用してください。MCP ツールではなく、Slack Web API（chat.postMessage など）を直接呼び出す場合は、slack:slack-api スキルを使用してください。