capability:teams:read

目的

日付範囲、メッセージ内容、キーワード検索によるフィルタリング機能をサポートしながら、Microsoft Teams のチャットまたはチャネル会話を読み込んで取得します。Microsoft 365 MCPツールを使用して Teams データにアクセスします。

実行

1. チャット/チャネルの解決: --chat-name を使用して Teams チャットとチャネルを検索します

   • Microsoft 365 MCP で利用可能なチャットとチャネルをクエリします
   • 提供された名前と照合します(部分一致をサポート)
   • 一意のチャットを確認するか、複数の一致がある場合は選択肢を返します
   • あいまいな名前の場合は、ユーザーに明確化を求めます

2. メッセージの取得: 一致した会話からすべてのメッセージを自動ページネーションで取得します

   • Microsoft 365 MCP Teams ツールを使用してメッセージ履歴をページ単位で取得します(--limit でページサイズを制御、デフォルト 50)
   • 完全になるまでページネーション: 終了境界(--last-message)に到達するか、それ以上のメッセージがなくなるまで次のページを取得し続けます — 単一ページが枯渇したからといって停止しません
   • ページサイズは呼び出しごとに 1000 メッセージ以下に制限されます。1000 を超える値は自動的に制限されます
   • メタデータを取得: 送信者、タイムスタンプ、コンテンツ
   • すべてのページ間でメッセージの順序とスレッド情報を保持します

3. 範囲フィルタを適用: --begin-message および --last-message 境界を解析して適用します

   • 境界が日付(YYYY-MM-DD)の場合: その日付以降のメッセージをフィルタリングします
   • 境界が時刻(HH:MM)の場合: 日付内の時刻でフィルタリングします
   • 境界がテキストスニペットの場合: テキストを含むメッセージを検出し、アンカーとして使用します
   • 日時の場合: 正確な日時比較を使用します

4. キーワードフィルタを適用: 指定されている場合は --filter でメッセージをフィルタリングします

   • メッセージコンテンツ内の大文字小文字を区別しない検索
   • キーワードに一致するメッセージのみを含めます

5. 出力をフォーマット: フィルタ適用後に収集されたすべてのメッセージを返します

   • 一致したチャット/チャネル名
   • 取得したメッセージの総数(すべてのページ)とフィルタ適用後のメッセージ数
   • 各メッセージ: [YYYY-MM-DD HH:MM] Sender: message content
   • 適用されたフィルタの概要
   • ページ数とソース確認(Teams MCP)

委譲

必須: このコマンドのフロントマターで定義されたエージェントを、その指定された責務に対して常に呼び出します。スキップ、置き換え、または直接シミュレートしないでください。

• zzaia-web-searcher — チャット名または境界があいまいな場合、クエリパラメータを分析および明確化します

ワークフロー

sequenceDiagram
    participant U as User
    participant C as Command
    participant A as zzaia-web-searcher
    participant M as Microsoft 365 MCP

    U->>C: /capability:teams:read --chat-name <name> [filters]
    C->>A: Clarify parameters if ambiguous
    A-->>C: Resolved parameters
    C->>M: Search chats/channels by name
    M-->>C: Matching chat/channel
    C->>M: Fetch page (--limit size)
    M-->>C: Message page + next cursor
    loop Until end boundary reached or no more pages
        C->>M: Fetch next page
        M-->>C: Message page + next cursor
    end
    C->>C: Apply date/time/text range filters
    C->>C: Apply keyword filter
    C-->>U: All matching messages (all pages)

受入基準

• Microsoft 365 MCP を使用してチャット/チャネル名を解決します(部分一致をサポート)
• --begin-message/--last-message 範囲内のすべてのメッセージが取得されるまで自動的にページネーションします — 単一ページで停止しません
• --limit は MCP 呼び出しごとのページサイズを制御します(デフォルト 50)、総結果数ではなく
• すべてのページ間で送信者とタイムスタンプを含む完全なメッセージ履歴を取得します
• 範囲フィルタリング用に日付(YYYY-MM-DD)、時刻(HH:MM)、およびテキストアンカーを解析します
• メッセージコンテンツに対する大文字小文字を区別しないキーワードフィルタリング
• メッセージを時系列順で返します
• 見つからないチャットをクリアなエラーメッセージで処理します
• あいまいなチャット名をユーザーの明確化を求めることで処理します
• 出力はページ数、適用されたフィルタ、および結果数を表示します

例

/capability:teams:read --chat-name "Product Launch" --limit 25
/capability:teams:read --chat-name "engineering" --filter "deployment" --limit 100
/capability:teams:read --chat-name "#general" --begin-message "2026-03-20" --last-message "2026-03-26"
/capability:teams:read --chat-name "planning" --begin-message "Started work on" --filter "deadline"
/capability:teams:read --chat-name "status-updates" --begin-message "10:00" --last-message "16:30" --limit 50

出力

• 確認付きで一致したチャットまたはチャネル名
• 取得したメッセージの総数(すべてのページ)とフィルタ適用後のメッセージ数
• フォーマット済みメッセージリスト: [YYYY-MM-DD HH:MM] Sender: message content
• 適用されたフィルタの概要(日付範囲、キーワード、ページサイズ)
• ページ数とソース確認(Microsoft 365 MCP)
• パラメータがあいまいな場合の明確化リクエスト