slack-messaging

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

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

使用するタイミング

Slack メッセージの作成、下書き、ユーザーのメッセージ作成支援を行う際は常に、このスキルを適用してください。slack_send_message、slack_send_message_draft、slack_create_canvas を使用する場合も含みます。

Slack の書式設定（mrkdwn）

Slack は mrkdwn と呼ばれる独自のマークアップ構文を使用しており、標準的な Markdown とは異なります。Slack メッセージを作成する際は、必ず mrkdwn を使用してください。

書式	構文	備考
太字	*text*	アスタリスクは 1 つ。2 つではありません
斜体	_text_	アンダースコアを使用
取り消し線	~text~	チルダを使用
コード（インライン）	`code`	バッククォートを使用
コードブロック	```code```	バッククォートを 3 つ使用
引用	> text	山括弧を使用
リンク	<url|display text>	山括弧内でパイプ区切り
ユーザーへのメンション	<@U123456>	山括弧内にユーザー ID
チャンネルへのメンション	<#C123456>	山括弧内にチャンネル ID
箇条書き	- item または • item	ダッシュまたは箇条書き文字
番号付きリスト	1. item	数字の後にピリオド

よくある間違いとその回避方法

• **bold**（アスタリスク 2 つ）は使用しないでください。Slack では *bold*（アスタリスク 1 つ）を使用します。
• ## headers は使用しないでください。Slack は Markdown の見出しをサポートしていません。代わりに、単独の行に *bold text* を使用してください。
• リンクに [text](url) は使用しないでください。Slack では <url|text> 形式を使用します。
• 水平線に --- は使用しないでください。Slack では表示されません。

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

• 要点から始めます。 最も重要な情報を最初の行に記載してください。Slack をモバイルや通知で読む人の多くは、最初の行しか目にしません。
• 簡潔にします。 短い段落を 1～3 個にまとめることを目指してください。メッセージが長くなる場合は、代わりに Canvas の使用を検討してください。
• 適宜改行します。 テキストが詰まっていると読みにくくなります。内容が変わる箇所では空行を入れてください。
• リストには箇条書きを使用します。 項目が 3 つ以上ある場合は、長い一文にせずリストにしてください。
• 重要な情報は太字にします。 名前、日付、期限、対応事項には *bold* を使用し、ざっと読んだときに目立つようにしてください。

スレッドとチャンネルのマナー

• 特定のメッセージへの返信は、メインチャンネルをすっきり保つためにスレッドで返信してください。
• reply_broadcast（チャンネルにも投稿）は、返信に全員が知る必要のある情報が含まれる場合にのみ使用してください。
• 新しい話題の開始、告知、グループ全体への質問は、スレッドではなくチャンネルに投稿してください。
• 既存の会話を続けるために新しいスレッドを始めないでください。元のメッセージを探して返信してください。

トーンと対象読者

• チャンネルに合わせてトーンを調整してください。通常、#general は #random よりフォーマルです。
• 簡単な了承には返信メッセージではなく絵文字リアクションを使用してください（ただし、MCP ツールではリアクションを追加できないため、適切であればユーザーに手動で行うよう提案してください）。
• 告知を書く際は、背景、重要な情報、次のアクションという明確な構成にしてください。