Agent Skills
返回列表
💻

谷歌日历冲突检测器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/google-calendar-conflict-detector 技能。

技能介绍

解决日程聚合的冲突判定难题

当团队协作或跨账号排期时，如果需要从多个 Google 日历中找出真正冲突的时间段，直接拉取全量 events.list 数据并在内存中做交叉比对通常不是最优解。这种做法不仅会消耗大量 API 配额，还需要开发者自行处理跨时区的时间对齐、忙碌状态过滤以及第三方日历的权限问题。

基于 freebusy 的核心实现

该技能直接利用 Google Calendar API v3 提供的 /calendar/v3/freeBusy 接口来解决这个问题。其核心工作流非常直接：

  • 接收目标日历 ID 列表和待检测的时间范围。
  • 通过 Node.js 客户端库向 freebusy 端点发起 POST 请求。
  • 解析 API 返回的 busy 时间槽，自动提取出重叠的忙碌时段。
  • 输出结构化的冲突报告，省去了前端二次计算的成本。

身份验证：技能支持通过 googleapis Node.js 库配置 Service Account，适合在后端服务中自动化执行。

适用边界与前置条件

这个方案专注于冲突检测本身，不包含日程修改或 UI 渲染逻辑。在调用前，你需要具备以下基础环境：

  • 拥有开启 API 权限的 Google Cloud 项目。
  • 配置有效的 OAuth 2.0 凭证或已授权的服务账号。
  • 本地环境需支持 Node.js 和 Python 的基础运行环境。

使用场景

  • 团队协调员在安排跨部门会议时，需要批量查询多个参与者日历的忙闲状态以找出空闲时段。
  • 后端工程师构建排班系统，通过调用接口自动校验员工在指定时间段内是否存在日程冲突。
  • 开发团队集成日历功能时，需利用服务账号在服务器端获取多个共享日历的重叠忙碌时段。
  • 项目经理在规划项目里程碑前，需要对比多个负责人的多个 Google 日历以避开已有的关键会议。

适合人员

  • 后端开发人员，需要在服务器端自动化处理 Google 日历数据并生成冲突校验逻辑。
  • 日历应用集成者，正在开发排期工具并需要快速接入 Google Calendar 的空闲查询功能。
  • 团队行政或项目经理，负责协调多人日程并需要快速定位跨日历的重叠会议时间。
  • 自动化脚本编写者，希望利用 Service Account 定期检查共享日历的忙碌状态。