mcpField
W
workiq-copilot

workiq-copilot

github.com/github生産性40.5k8.8k 回インストール今日更新
リポジトリ

workiq-copilot について

自然言語で Microsoft 365 の組織データを検索する WorkIQ スキルです。Copilot ユーザー向けに、セットアップ、範囲を絞った検索、要約、フォローアップの手順を案内します。

主な機能

  1. 01メール、会議、ドキュメントの検索
  2. 02Teams のメッセージや人物の検索
  3. 03WorkIQ クエリ用 CLI コマンド
  4. 04エージェント向け MCP ツール提供
  5. 05プライバシーに配慮した要約と提案

活用シーン

  1. 01今後の会議とスケジュールの競合を確認
  2. 02プロジェクトの連絡やアクション項目を要約
  3. 03最近の計画ドキュメントを検索
  4. 04プロジェクト関係者や課題を特定

MCP 対応

`workiq mcp` を使うと、WorkIQ を MCP stdio サーバーとして起動し、他のエージェントやワークフローにツールを提供できます。

インストール

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

$npx skills add https://github.com/github/awesome-copilot --skill workiq-copilot

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

詳細

WorkIQ Copilot スキル

概要

WorkIQ(パブリックプレビュー)を使用すると、Copilot は自然言語で Microsoft 365 のデータをクエリできます。スケジュール、ドキュメント、Teams メッセージ、メールスレッド、フォローアップの追跡、ステークホルダーのサマリーなどをサポートします。ローカルリポジトリを超えたライブの組織インテリジェンスが必要なタスクでは、このスキルを使用してください。

サポートされるデータとサンプルプロンプト

  • メール – 「Sarah からの予算に関するメールを要約して。」
  • 会議 – 「今週の今後の会議は何ですか?」
  • ドキュメント – 「第4四半期の計画に関する最近のドキュメントを探して。」
  • Teams – 「今日の Engineering チャネルのメッセージを要約して。」
  • 人/プロジェクト – 「Project Alpha に取り組んでいるのは誰ですか?」

アクセスの取得

  1. Copilot CLI プラグイン(推奨)
    • copilot
    • /plugin marketplace add github/copilot-plugins
    • /plugin install workiq@copilot-plugins
    • Copilot CLI を再起動します。
  2. スタンドアロン CLI / MCP サーバー
    • npm install -g @microsoft/workiq(または npx -y @microsoft/workiq mcp)。
    • 必要に応じて workiq mcp を実行して MCP ツールを公開します。
  3. テナントの同意
    • 初回使用時に Microsoft 365 管理者の同意(EULA とアクセス許可)を求められます。管理者以外の場合は、テナント管理者向け有効化ガイドに従って承認するようテナント管理者に連絡する必要があります。

事前チェックリスト

  • Get-Command workiq を実行して、バイナリが利用可能であることを確認します。
  • workiq accept-eula で一度 EULA に同意します。
  • 正しいテナントを確認します(デフォルトの common と異なる場合は -t <tenant-id> を使用)。
  • 求められたら、ブラウザでデバイスログインを完了できるように準備します。

コアワークフロー

  1. 意図を明確化 – アジェンダ、アクションアイテム、ドキュメント検索、人物検索、リスクサマリーなど。
  2. 正確なプロンプトを作成 – 期間、ソース、トピックを含めます(例:「今日の #eng の Teams 投稿を要約して」)。
  3. コマンドを実行 – workiq ask --question "<prompt>"(必要であれば省略形の -q を使用)。
  4. 実行を監視 – 長い回答はストリーミングされる場合があります。追加のリクエストを発行する前に、応答が完了するまで待ちます。
  5. 要約と秘匿化 – インサイトを強調し、競合やタスクに言及し、必要でない限り生のリンクを貼り付けないようにします。
  6. フォローアップを提案 – 時間のブロック、メモの下書き、より深いクエリなど。

コマンドリファレンス

コマンド目的
workiq --helpグローバルオプションを表示します。
workiq versionインストールされているバージョンを表示します。
workiq accept-eulaライセンスに同意します(初回使用時)。
workiq ask対話モード。
workiq ask --question "..."特定の質問をします(希望する場合は省略形の -q を使用)。
workiq ask -t <tenant> -q "..."特定のテナントを対象にします。
workiq mcpMCP stdio サーバーを起動します(WorkIQ ツールを他のエージェントに公開)。

プロンプトパターン

  • アジェンダ:「明日のカレンダーには何がありますか?」
  • アクションアイテム:「今日の顧客定例からのフォローアップを要約して。」
  • ドキュメント:「Contoso FY26 ロードマップに関する PowerPoint をリストして。」
  • コミュニケーション:「上司は締め切りについて何と言いましたか?」
  • インサイト:「直近3回の会議でどのようなブロッカーが発生しましたか?」
  • 計画:「火曜日の午後の集中時間帯を提案して。」

応答ガイドライン

  • サマリーは簡潔に保ち(2~3文)、負荷、優先事項、ブロッカー、および任意の次のステップを指摘します。
  • ユーザーが特にリンクを必要としない限り、会議やドキュメントは一般的に言及します。
  • WorkIQ が続行できるかどうかに言及します(例:「必要であれば WorkIQ は木~日を表示できます」)。
  • WorkIQ が提案するアクションを明確な提案に対応付けます(時間のブロック、フォローアップの送信、録画のリクエスト、より深いクエリの実行)。

ベストプラクティス

  • ノイズを減らすために、範囲を絞ったプロンプトを優先してください。必要に応じて複数のクエリを実行してください。
  • 応答する前に、出力を論理的に組み合わせてください(アジェンダ + 競合 + アクションアイテム)。
  • プライバシーを尊重してください。明示的に要求されない限り、参加者リストや機密の抜粋を公開しないでください。
  • 実行したコマンドを記録して、今後のステップがそれらを参照できるようにしてください(「WorkIQ にアジェンダ + 競合を問い合わせた」など)。
  • 別のエージェントやワークフローがツールに直接アクセスする必要がある場合は、MCP モード(workiq mcp)を使用してください。

トラブルシューティング

  • CLI が見つからない – npm 経由でインストールするか、PATH が設定されていることを確認してください。利用できない場合はユーザーに通知してください。
  • 同意/認証エラー – 管理者が権限を付与した後、またはデバイスログインを完了した後に、コマンドを再実行してください。
  • 出力が長い/不完全 – 範囲を絞って再実行するか、特定のデータスライス(日別/プロジェクト別/担当者別)を要求してください。
  • コマンドがハングする – ターミナルで実行中のコマンドをキャンセルする(たとえば Ctrl+C を使用)か、Copilot CLI セッションを再起動してから再試行してください。ブラウザログインが完了していることを確認してください。

提案できるフォローアップアクション

  • 提案された時間に集中/オーバーフローの予定をブロックする。
  • WorkIQ のガイダンスを参照したリスケジュール/辞退メッセージを作成する。
  • 重複するセッションの録画または要約をリクエストする。
  • アクションアイテムをタスクトラッカーに取り込む。
  • より深い分析のために、追加の WorkIQ クエリ(プロジェクト別、ステークホルダー別、期間別)を実行する。

コメント