slack-block-kit について
Slackのメッセージ、モーダル、App Home、インタラクション用ペイロードを構築するスキルです。対象画面に合う要素を選び、有効なJSONや連携コードを作成しますが、作成だけで投稿が許可されるわけではありません。
主な機能
- 01Slack画面に応じた構造とコンポーネント選択
- 02ブロック、要素、テキストオブジェクトの制限確認
- 03リッチテキストとストリーミング形式への対応
- 04IDとURLの保持および外部テキストのエスケープ
- 05既定で投稿せずペイロードを検証
活用シーン
- 01Slackメッセージのブロックレイアウト作成
- 02モーダルやApp Homeビューの設計
- 03ボタン、入力欄、メニューの操作実装
- 04ストリーミングやワークオブジェクトのペイロード作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ ccheney/ robust-skills --skill slack-block-kitインストール後、Claude Code で/slack-block-kitを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/BLOCKS.mdCHEATSHEET.mdCOMPOSITION.mdELEMENTS.mdRICH-TEXT.mdSTREAMING.mdSURFACES.mdWORK-OBJECTS.md詳細
Slack Block Kit
受信側のサーフェスのスキーマを使って、指定された Slack のレイアウトやインタラクションを構築します。ユーザーの明示的な指示は、このスキルのガイドラインより優先されます。
サーフェスを特定する
指定されたコンテンツ、インタラクション、対象の Slack メソッド/サーフェス、および既存のペイロードがあれば、それらを入力として使用します。可能であればコードからサーフェスを推測し、選択が不足していてペイロードが変わる場合は確認します。通常のテキスト返信にはブロックは必要ありません。
| 作業 | リファレンス |
|---|---|
| メッセージ、モーダル、App Home、またはインタラクションのライフサイクル | SURFACES.md |
| ブロックの選択、フィールド、制限、サーフェスとの互換性 | BLOCKS.md |
| ボタン、入力、メニュー、ピッカー | ELEMENTS.md |
| テキストオブジェクト、オプション、確認ダイアログ | COMPOSITION.md |
| 構造化されたリッチテキストのネストとインライン要素 | RICH-TEXT.md |
| ストリーミングの開始/追加/停止、チャンク、SDK の違い | STREAMING.md |
| エンティティの展開表示、フレックスペイン、編集、コメント | WORK-OBJECTS.md |
| ブロック/要素/制限の簡易参照 | CHEATSHEET.md |
関連するリファレンスまたはセクションのみを読み込みます。ペイロードの構築に Slack への接続は必要ありません。利用可能な場合は、詳細なテキスト書式の質問には、別途インストールされた slack-mrkdwn スキルを使用してください。ここにある Composition とリッチテキストのリファレンスでは、必要なオブジェクトの形式を個別に説明しています。
ペイロードの仕様を守る
- フィールドごとにテキスト構文を選択します。
mrkdwnでは*bold*と<url|label>を使用し、plain_textはそのままのテキスト、markdownブロックでは標準の Markdown、rich_textでは構造化要素を使用します。 - サーフェスとの互換性を確認します。たとえば、アラートはモーダル専用であり、メッセージペイロードの制限はモーダル/Home ビューとは異なります。
- 指定されている場合は、トップレベルのフォールバックテキストをブロックの内容と意味的に一致させます。スクリーンリーダーやモバイル通知で必要になる場合があります。
- 信頼できないテキストは、受信先フィールドに合わせてエスケープします。指定された ID と URL は保持し、実在するチャンネル、ユーザー、トリガー、エンティティの識別子を捏造しないでください。
- モーダルには有効なトリガーとインタラクション処理が必要です。静的なプレビューだけでは、ライフサイクルが機能することは確認できません。ストリーミングのスキーマに相違がある場合は、最新のメソッド/SDK の仕様に従ってください。
必要なフォールバックテキストと未解決の実行時入力を含め、指定されたサーフェスに有効な JSON または統合コードを提供します。ペイロードの構造と関連する制限を確認し、ライブ配信のテストは依頼された場合、またはすでに許可されている場合にのみ実施します。ペイロードを作成しただけでは、投稿の許可を得たことにはなりません。
バンドルされたリファレンスで確認できない最新のフィールドや制限については、Slack Block Kit リファレンスと、該当する正確な Web API メソッド/SDK スキーマを使用してください。