Slack Search

このスキルは、Slack内で情報を効果的に検索するためのガイダンスを提供します。メッセージ、ファイル、チャンネル、ユーザーの検索に活用できます。

使用場面

ユーザーがSlack内のメッセージ、会話、ファイル、またはユーザーを探すよう求めてきた場合、あるいはSlackで何が起こっているかについての質問に答える前にコンテキストを収集する必要がある場合に、このスキルを適用してください。

検索ツール概要

ツール	使用場面
slack_search_public	パブリックチャンネルのみを検索する。ユーザー同意は不要。
slack_search_public_and_private	プライベートチャンネル、DM、グループDMを含むすべてのチャンネルを検索する。ユーザー同意が必要。
slack_search_channels	チャンネル名または説明でチャンネルを探す。
slack_search_users	名前、メールアドレス、またはロールでユーザーを探す。

検索戦略

広範囲から始めて、絞り込む

1. シンプルなキーワードまたは自然言語の質問で始める。
2. 結果が多すぎる場合は、フィルタ（in:、from:、日付範囲）を追加する。
3. 結果が少なすぎる場合は、フィルタを削除し、同義語や関連用語を試す。

適切な検索モードを選択する

• 自然言語での質問（例：「プロジェクトXの期限は？」）— 正確なキーワードが不明な、あいまいで概念的な検索に最適。
• キーワード検索（例：project X deadline）— 特定の正確なコンテンツを見つけるのに最適。

複数回の検索を行う

単一の検索に頼らないでください。複雑な質問をより小さな検索に分割してください：

• まずトピックを検索する
• 次に特定のユーザーの貢献を検索する
• その後、特定のチャンネル内を検索する

検索修飾子リファレンス

位置フィルタ

• in:channel-name — 特定のチャンネル内を検索
• in:<#C123456> — チャンネルIDでチャンネル内を検索
• -in:channel-name — チャンネルを除外
• in:<@U123456> — 特定ユーザーとのDM内を検索

ユーザーフィルタ

• from:<@U123456> — 特定ユーザーのメッセージ（IDで指定）
• from:username — 特定ユーザーのメッセージ（Slackユーザー名で指定）
• to:me — あなたに直接送られたメッセージ

コンテンツフィルタ

• is:thread — スレッド内のメッセージのみ
• has:pin — ピン留めされたメッセージ
• has:link — リンク含むメッセージ
• has:file — ファイル添付のあるメッセージ
• has::emoji: — 特定のリアクション付きメッセージ

日付フィルタ

• before:YYYY-MM-DD — 指定日前のメッセージ
• after:YYYY-MM-DD — 指定日後のメッセージ
• on:YYYY-MM-DD — 指定日のメッセージ
• during:month — 特定の月のメッセージ（例：during:january）

テキストマッチング

• "exact phrase" — 正確なフレーズにマッチ
• -word — 特定の単語を含むメッセージを除外
• wild* — ワイルドカードマッチング（*の前に最低3文字必要）

ファイル検索

ファイルを検索するには、content_types="files"パラメータをタイプフィルタと共に使用してください：

• type:images — 画像ファイル
• type:documents — ドキュメントファイル
• type:pdfs — PDFファイル
• type:spreadsheets — スプレッドシートファイル
• type:canvases — Slack Canvas

例：content_types="files" type:pdfs budget after:2025-01-01

結果のフォローアップ

関連メッセージを見つけた後：

• スレッド内メッセージの完全なスレッドコンテキストを取得するにはslack_read_threadを使用してください。
• コンテキストのため周辺メッセージを読むには、oldest/latestタイムスタンプを指定してslack_read_channelを使用してください。
• 結果に表示されているユーザーIDが何者であるかを特定するにはslack_read_user_profileを使用してください。

よくある落とし穴

• ブール演算子は機能しません。 AND、OR、NOTはサポートされていません。スペース（暗黙的AND）と-で除外を表してください。
• 括弧は機能しません。 検索用語を()でグループ化しないでください。
• 検索はリアルタイムではありません。 非常に最近のメッセージ（直近数秒）は検索結果に表示されない場合があります。最新のメッセージにはslack_read_channelを使用してください。
• プライベートチャンネルへのアクセス。 プライベートチャンネルを含める必要がある場合はslack_search_public_and_privateを使用してください。ただしこれはユーザー同意が必要です。