mcpField
S
slack-block-kit

slack-block-kit

github.com/ccheneyデザイン・UI61158 回インストール7 週間前に更新
リポジトリ

slack-block-kit について

Slackのメッセージ、モーダル、App Home、インタラクション用ペイロードを構築するスキルです。対象画面に合う要素を選び、有効なJSONや連携コードを作成しますが、作成だけで投稿が許可されるわけではありません。

主な機能

  1. 01Slack画面に応じた構造とコンポーネント選択
  2. 02ブロック、要素、テキストオブジェクトの制限確認
  3. 03リッチテキストとストリーミング形式への対応
  4. 04IDとURLの保持および外部テキストのエスケープ
  5. 05既定で投稿せずペイロードを検証

活用シーン

  1. 01Slackメッセージのブロックレイアウト作成
  2. 02モーダルやApp Homeビューの設計
  3. 03ボタン、入力欄、メニューの操作実装
  4. 04ストリーミングやワークオブジェクトのペイロード作成

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/slack-block-kitを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
BLOCKS.md
CHEATSHEET.md
COMPOSITION.md
ELEMENTS.md
RICH-TEXT.md
STREAMING.md
SURFACES.md
WORK-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 スキーマを使用してください。

コメント