关于 workiq-copilot
用于通过自然语言查询 Microsoft 365 组织数据的 WorkIQ 技能，面向 Copilot 用户。它提供设置、精准提问、结果摘要及后续操作指引。
主要功能
- 01查询邮件、会议和文档
- 02搜索 Teams 消息与人员
- 03通过 CLI 命令提交 WorkIQ 查询
- 04以 MCP 模式向 Agent 提供工具
- 05注重隐私的摘要与后续建议
适用场景
- 01查找即将举行的会议及日程冲突
- 02汇总项目沟通和待办事项
- 03定位近期规划文档
- 04了解项目相关人员和阻碍
MCP 相关
WorkIQ 可通过 `workiq mcp` 作为 MCP stdio 服务运行，向其他 Agent 和工作流提供工具。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/workiq-copilot确认已加载。
详细介绍
WorkIQ Copilot Skill
概述
WorkIQ（公共预览版）让 Copilot 能够用自然语言查询 Microsoft 365 数据。它支持日程、文档、Teams 消息、电子邮件会话、跟进事项跟踪、相关方摘要等。只要任务需要本地仓库之外的实时组织情报，就使用此 skill。
支持的数据与示例提示词
- 电子邮件 – “总结 Sarah 发来的关于预算的电子邮件。”
- 会议 – “我本周即将召开的会议有哪些？”
- 文档 – “查找关于 Q4 规划的近期文档。”
- Teams – “总结今天 Engineering 频道中的消息。”
- 人员/项目 – “谁正在参与 Project Alpha？”
获取访问权限
- Copilot CLI 插件（推荐）
copilot/plugin marketplace add github/copilot-plugins/plugin install workiq@copilot-plugins- 重启 Copilot CLI。
- 独立 CLI / MCP 服务
npm install -g @microsoft/workiq（或npx -y @microsoft/workiq mcp）。- 如有需要，运行
workiq mcp以暴露 MCP 工具。
- 租户同意
- 首次使用会提示进行 Microsoft 365 管理员同意（EULA + 权限）。非管理员必须按照《租户管理员启用指南》联系租户管理员进行批准。
飞行前检查清单
- 运行
Get-Command workiq以确保该二进制文件可用。 - 通过
workiq accept-eula接受一次 EULA。 - 确认正确的租户（如果与默认的
common不同，请使用-t <tenant-id>）。 - 准备好根据提示在浏览器中完成设备登录。
核心工作流
- 明确意图 – 议程、行动项、文档查找、人员搜索、风险摘要等。
- 精心编写精确的提示词 – 包含时间范围、来源或主题（例如 “总结今天 #eng 中的 Teams 帖子”）。
- 运行命令 –
workiq ask --question "<prompt>"（如需要，可使用-q作为简写）。 - 监控执行 – 较长的回答可能会流式输出；在发出其他请求之前，等待响应完成。
- 总结并脱敏 – 突出关键洞察，记录冲突/任务，除非必要，避免粘贴原始链接。
- 提供后续操作 – 预留时间、起草笔记、更深入的查询等。
命令参考
| 命令 | 用途 |
|---|---|
workiq --help | 显示全局选项。 |
workiq version | 显示已安装版本。 |
workiq accept-eula | 接受许可（首次使用时）。 |
workiq ask | 交互模式。 |
workiq ask --question "..." | 提出特定问题（如偏好，可使用 -q 简写）。 |
workiq ask -t <tenant> -q "..." | 面向特定租户。 |
workiq mcp | 启动 MCP stdio 服务器（向其他 Agent 暴露 WorkIQ 工具）。 |
提示词模式
- 议程：“我明天日历上有什么？”
- 行动项：“总结今天客户同步会议中的跟进事项。”
- 文档：“列出关于 Contoso FY26 路线图的 PowerPoint。”
- 沟通：“我的经理对截止日期是怎么说的？”
- 洞察：“最近三次会议中出现了哪些阻碍？”
- 规划：“为周二下午建议专注时间段。”
响应准则
- 保持摘要简洁（2–3 句话），指出负载、优先事项、阻碍以及可选的后续步骤。
- 除非用户特别需要链接，否则以通用方式提及会议/文档。
- 说明 WorkIQ 是否可以继续（例如 “如需要，WorkIQ 可以显示周四至周日的内容”）。
- 将 WorkIQ 建议的操作映射为明确的提议（预留时间、发送跟进、请求录制、运行更深入的查询）。
最佳实践
- 优先使用范围较窄的提示词以减少噪声；如有需要，运行多次查询。
- 在回复前，将输出按逻辑组合（议程 + 冲突 + 行动项）。
- 尊重隐私：除非明确要求，否则不要暴露参会者名单或机密片段。
- 记录运行了哪些命令，以便后续步骤可以引用它们（“向 WorkIQ 询问议程 + 冲突”）。
- 当其他 Agent/工作流需要直接访问工具时，使用 MCP 模式（
workiq mcp）。
故障排查
- 缺少 CLI – 通过 npm 安装或确保已设置 PATH；如果不可用，请通知用户。
- 同意/认证错误 – 在管理员授予权限后或完成设备登录后，重新运行命令。
- 输出过长/不完整 – 以更精确的范围重新运行，或请求特定的数据切片（按天/项目/人员）。
- 命令挂起 – 在你的终端中取消正在运行的命令（例如使用 Ctrl+C），或重启 Copilot CLI 会话，然后重试；确保浏览器登录已完成。
可提供的后续操作
- 在建议的时间阻止专注/溢出占用。
- 起草引用 WorkIQ 指导的改期/拒绝消息。
- 为时间重叠的会议请求录制或摘要。
- 将行动项记录到任务跟踪器中。
- 运行更多 WorkIQ 查询（按项目、相关方、时间范围）以进行更深入的分析。
评论
支持 Markdown