meeting-prep

核心用法

Meeting Prep 是一款面向开发团队的自动化工作流工具，主要用于两个场景：

1. 会议准备（Meeting Prep Check）

• 每 15 分钟轮询 Google 日历，检测未来 45 分钟内的会议
• 自动识别包含视频链接（Google Meet）的会议事件
• 会前 30-45 分钟主动询问用户上次更新时间
• 会前 10-20 分钟自动生成基于代码提交的更新摘要

2. 每日提交总结（Daily Commit Summary）

• 每日定时拉取配置仓库的当日全部提交
• 按仓库和子目录分组，包含所有开发者贡献
• 格式化为纯文本，便于复制粘贴到站会或日报

显著优点

• 高度自动化：基于 Cron 定时触发，减少手动准备会议材料的时间
• 多源整合：无缝连接 Google Calendar 与 GitHub，打通日程与代码数据
• 开发者友好：输出格式为纯文本，无 Markdown 和 emoji，适合快速粘贴到聊天工具
• 状态追踪：通过本地状态文件避免重复通知，支持多账户配置

潜在缺点与局限性

• 平台依赖严重：仅支持 Google Calendar 和 GitHub，不兼容企业微信、飞书、GitLab 等国内常用平台
• OAuth 配置复杂：需要手动创建 Google Cloud 项目、启用 API、管理令牌刷新
• 隐私风险：需要存储敏感的 OAuth 令牌和 GitHub PAT 到本地文件
• 无智能摘要：仅按目录分组罗列提交，无 AI 驱动的变更要点提炼
• 时区处理：示例使用 UTC 时间，可能需要用户手动调整

适合人群

• 使用 Google Workspace 的海外开发团队
• 习惯 GitHub 流程的敏捷团队
• 需要每日站会汇报的一线开发者

常规风险

• 令牌泄露风险：本地明文存储 calendar_tokens.json 和 github_token
• 权限过度：GitHub Token 需要 repo 全权限，无法细粒度控制
• 单点故障：依赖 Google API 配额和 GitHub API 速率限制

核心用法

Meeting Prep 是一款面向开发团队的自动化工作流工具，主要功能围绕两个场景展开：

1. 会议准备检查（Meeting Prep Check）

通过定时任务（建议每15分钟）扫描 Google Calendar，识别未来45分钟内带有视频会议链接的日程。系统会在会议前30-45分钟主动提醒用户确认需要汇报的代码仓库，并在会议前10-20分钟自动生成基于 GitHub 提交记录的更新摘要。

2. 每日提交汇总（Daily Commit Summary）

在每日工作结束时，自动拉取配置仓库中所有开发者的提交记录，按仓库和子目录分组，生成格式化的纯文本摘要，便于团队了解全天进展。

输出格式特点

• 纯文本、无 Markdown、无表情符号，便于直接复制粘贴到聊天工具
• 按仓库 → 子目录层级组织
• 包含作者名称和简洁的变更描述
• 预留 Today/Blockers/Discussion 板块供用户补充

显著优点

• 零配置启动：仅需 OAuth 凭证和 GitHub Token，无复杂依赖
• 开发者友好：输出格式专为站会/敏捷更新场景优化
• 多账户支持：可配置多个 Google Calendar 账户
• 状态追踪：通过本地 JSON 文件避免重复通知
• 隐私优先：所有凭证本地存储，无云端数据收集

潜在缺点与局限性

• 纯文档型实现：无实际可执行代码，完全依赖 Claude Code Agent 对提示词的解释执行，行为一致性取决于 Agent 实现
• T3 来源可信度：由个人开发者维护，非企业级项目，长期维护存在不确定性
• 权限范围较宽：Google Calendar OAuth 使用完整 calendar 范围，非只读权限
• 无实时同步机制：基于轮询（Cron）而非事件驱动，存在15分钟级延迟
• bash 示例需手动执行：文档中的 API 调用示例需用户手动运行，非自动化集成

适合人群

• 使用 Google Calendar + Google Meet 安排站会的敏捷开发团队
• 习惯每日站会同步进度的技术团队
• 希望减少手动整理提交记录时间的开发负责人
• 已在 Claude Code Agent 生态中的用户

常规风险

1. 凭证管理风险：用户需手动保管 credentials/ 目录下的 OAuth 凭证和 GitHub Token，若权限配置不当可能导致泄露
2. API 速率限制：高频轮询可能触发 Google Calendar 或 GitHub API 限制
3. Agent 解释偏差：由于无实际代码，提示词理解偏差可能导致输出格式不一致
4. 第三方服务依赖：功能完全依赖 Google 和 GitHub 服务的可用性