slack-search

Slack 検索

このスキルでは、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> または in:@username：ユーザーとの DM を検索

ユーザーのフィルター

• from:<@U123456>：特定のユーザー（ID 指定）からのメッセージ
• from:username：ユーザー（Slack ユーザー名指定）からのメッセージ
• to:<@U123456>：特定のユーザー宛てのメッセージ
• to:me：自分宛てに直接送られたメッセージ
• creator:@username：特定の人が作成した Canvas

コンテンツのフィルター

• is:thread：スレッド内のメッセージのみ
• is:saved：自分が保存したメッセージのみ
• has:pin：ピン留めされたメッセージ
• has:link：リンクを含むメッセージ
• has:file：ファイル添付のあるメッセージ
• has::emoji:：特定のリアクションが付いたメッセージ
• hasmy::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: フィルターを使用します。

• type:images、type:documents、type:pdfs、type:spreadsheets、type:presentations
• type:canvases、type:lists、type:emails、type:audio、type:videos

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

上記の標準的な修飾子（in:、from:、日付など）は、ファイル検索でも使用できます。

便利なパラメーター

検索クエリに加えて、検索ツールでは結果を大幅に改善するパラメーターを指定できます。

• sort：score（関連度順、デフォルト）または timestamp（新しい順）。sort_dir（asc／desc）と組み合わせます。
• content_types：messages（デフォルト）または files。
• only_my_channels：自分が参加しているチャンネルに絞り込みます。
• limit：ページごとの結果数（上限 20）。返された cursor を使ってページネーションできます。

検索結果の確認

関連するメッセージが見つかったら、次の操作を行います。

• スレッド内のメッセージについて、slack_read_thread を使ってスレッド全体のコンテキストを取得します。
• oldest／latest のタイムスタンプを指定して slack_read_channel を使い、前後のメッセージを読んでコンテキストを確認します。
• 結果にユーザー ID が表示されたときは、slack_read_user_profile を使ってユーザーを特定します。
• ファイル検索で見つかったファイルの内容を読むには、slack_read_file を使います。
• slack_list_channel_members を使って、見つかったチャンネルのメンバーを確認します。

よくある落とし穴

• ブール演算子は使えません。 AND、OR、NOT はサポートされていません。スペース（暗黙の AND）と、除外を表す - を使います。同じ修飾子（たとえば from:）を繰り返すと、それらの値は OR として扱われます。
• 括弧は使えません。 () で検索語をグループ化しようとしないでください。
• 検索結果はリアルタイムではありません。 ごく最近（直近数秒以内）のメッセージは、検索結果に表示されないことがあります。最新のメッセージを確認するには slack_read_channel を使います。
• プライベートチャンネルへのアクセス。 プライベートチャンネルも検索対象に含める必要がある場合は、slack_search_public_and_private を使います。ただし、ユーザーの同意が必要です。

注意事項

• 対象範囲： このスキルは、Slack 内のメッセージ、ファイル、チャンネル、ユーザーなど、ワークスペースのコンテンツ の検索を担当します。Slack の機能に関する概念的な質問や使い方の質問など、docs.slack.dev にある公式の Slack プラットフォームドキュメント を検索・閲覧するには、代わりに slack:slack-docs スキルを使います。