待办事项 → Todoist + 邮件草稿
配置 — 开始前先阅读
读取 ../config/user.json(解析为 ~/executive-assistant-skills/config/user.json)。
提取并全程使用:
name,full_name— 用于在会议笔记中识别您的待办事项(例如 "Gonto (Martin)")whatsapp— 用于结果交付workspace— OpenClaw 工作空间的绝对路径
在获得这些值之前,请勿继续。
调试日志(必须)
阅读 ../config/DEBUG_LOGGING.md 了解完整规范。在每一步关键步骤中使用 python3 {user.workspace}/scripts/skill_log.py action-items <level> "<message>" ['<details>']。在每次外部调用(gog、mcporter、todoist-cli)之前和之后记录日志。出现任何错误时,先记录完整的命令和 stderr,然后再继续。
步骤
0. 检查今日日历中的会议(两个账号)
在查询 Granola 之前,先从两个日历获取今日实际会议,以了解预期内容:
python3 {user.workspace}/scripts/skill_log.py action-items INFO "正在启动待办事项运行"
# 获取今天的日期(YYYY-MM-DD)和明天的日期
TODAY=$(date -u -d "$(TZ=America/Argentina/Buenos_Aires date +%Y-%m-%d)" +%Y-%m-%d)
TOMORROW=$(date -u -d "$(TZ=America/Argentina/Buenos_Aires date -d '+1 day' +%Y-%m-%d)" +%Y-%m-%d)
# 检查两个日历
gog --account {user.primary_email} --no-input calendar list primary --from "${TODAY}T00:00:00-03:00" --to "${TOMORROW}T00:00:00-03:00" --json 2>&1
gog --account {user.work_email} --no-input calendar list primary --from "${TODAY}T00:00:00-03:00" --to "${TOMORROW}T00:00:00-03:00" --json 2>&1
记录结果:python3 {user.workspace}/scripts/skill_log.py action-items DEBUG "找到日历事件" '{"primary": N, "work": M, "total": N+M}'
合并两个日历的事件。筛选出有参与者的会议(跳过单人/个人事件)。这样您就能掌握今日实际发生的会议事实——用于交叉检查 Granola 结果,并发现 Granola 遗漏的任何会议。
关键日期语法: 使用显式的 ISO8601 日期及 -03:00 偏移量。不要在 gog 标志中使用类似 +1 day、today 或 tomorrow 的相对表达式——它们可能不被支持。始终计算实际的日期字符串。
1. 从 Granola 获取今日会议
时区说明: Granola 以 UTC 存储会议时间。对于 ART(UTC-3),查询“今天”意味着使用今天的日期和明天的日期(UTC)。例如,对于 ART 时间 3 月 3 日,查询 custom_start: "2026-03-03" 和 custom_end: "2026-03-04" 以捕获所有 ART 日的会议。
mcporter call granola list_meetings --args '{"time_range": "custom", "custom_start": "<今天 YYYY-MM-DD>", "custom_end": "<明天 YYYY-MM-DD>"}'
收集会议 ID 和标题。记录:python3 {user.workspace}/scripts/skill_log.py action-items INFO "找到 Granola 会议" '{"count": N, "titles": [...]}'
与日历交叉检查: 将 Granola 会议与步骤 0 中的日历事件进行比较。如果某个有参与者的日历会议在 Granola 中没有匹配项(按时间重叠在 15 分钟内),记录一条警告——该会议可能未被记录。继续处理 Granola 已有的内容,但在输出中注明未匹配的会议。
如果未找到任何会议(来自 Granola 或日历),则跳过。
2. 查询 Granola 获取我的待办事项和邮件触发器
mcporter call granola query_granola_meetings --args '{"query": "What are all of {user.name} ({user.full_name}) personal action items, follow-ups, and commitments from these meetings? Only things HE needs to do, not what others committed to. For each item, include the specific person, company, project, or candidate name involved — never use generic references. Also identify: any promises made to do ANYTHING via email (intros, follow-ups, sending docs, sharing info, connecting people, etc.), and whether each meeting was a FIRST meeting with that person/company or a follow-up.", "document_ids": ["<id1>", "<id2>", ...]}'
传入所有会议 ID。保留引用链接。
3. 创建 Todoist 任务
说明: 在同一个命令中加载环境变量——每个 shell 调用都是一个全新会话。
阅读 {user.workspace}/skills/todoist-api/SKILL.md 了解 CLI 用法。对于每个待办事项:
source {user.workspace}/.env && todoist-cli add "<可操作标题>" --description "<上下文:会议名称、会议日期/时间、请求者、Granola 链接>" --priority <1-4> --labels "<相关标签>"
任务描述必须包含:
- 会议名称(例如 "Braintrust 周例会")
- 会议日期和时间(例如 "周三 3月5日, 15:00 ART")
- 请求者 / 上下文
- Granola 引用链接
规则:
- 仅限你的操作:Granola 摘要经常列出没有明确归属的“下一步”。保持怀疑——如果该操作可能属于对方(例如“消化他们自己的内容”、“检查可用性”、“回复我们”),则不要创建任务。如有疑问,创建一个跟进任务(“向 X 询问 Y 的进展”)而不是一个归属任务。
- 捕获他人的承诺:如果对方表示他们会做某事(例如“我两天内回复”),请创建一个带有相应截止日期的跟进/提醒任务,而不是创建一个由你自己完成该事项的任务。
- 具体性:每个任务必须包含具体的人名/公司/项目。
- 截止日期:如果隐含截止日期,请使用
--due及自然语言。 - 标签:视情况标记:介绍、跟进、邮件、紧急。
- 优先级:4=紧急/时效性,3=承诺交付物,2=一般跟进,1=普通。
禁止拆分顺序步骤任务(必须)
切勿为同一工作流中的步骤创建单独的任务。如果操作是“先准备 X 再发送 X”——那是一个任务,而不是两个。例如:
- ❌ “编写提案” + “发送提案” → ✅ “编写并发送提案”
- ❌ “写草稿” + “发送邮件” → ✅ “起草并发送给 X 的邮件”
- ❌ “审阅演示文稿” + “分享演示文稿” → ✅ “审阅并与 X 分享演示文稿”
每个意图一个任务。用户自然会按顺序执行步骤。
任务去重(必须)
在创建任务之前,针对已打开的 Todoist 任务执行重复检查:
- 规范化提议标题(小写、去除标点、压缩空白)
- 搜索已打开的任务(
source {user.workspace}/.env && todoist-cli list --filter "!completed")并比较规范化内容 - 将几乎相同的介绍任务视为重复(例如,“介绍 David 给 Marcos” vs “介绍 David (n8n) 给 Marcos Nils”)
- 如果存在重复项:不要创建新任务;在有用时将会议上下文附加到现有任务描述中
- 在输出中,在“已跳过(重复项):”下报告去重决定
4. 起草跟进邮件
对于需要起草的任何邮件(介绍、跟进、VC 回复、发送文档等):
- 阅读并遵循
~/executive-assistant-skills/email-drafting/SKILL.md——它是所有起草规则、风格、模板、人工化和交付的唯一真实来源 - 从会议笔记中识别起草触发器:
- 承诺的介绍或跟进
- 承诺的文档/PDF/演示文稿
- 与 VC 或新线索的首次通话
- 任何承诺通过邮件联系某人的事项
- 如有疑问是否应起草 → 那就起草
- 例外:下面的仅提案承诺规则将覆盖此规则。如果承诺是先构建提案,则不要起草——仅创建 Todoist 任务。
- HGP 演示文稿:
{user.workspace}/assets/HGP_Deck_2025.pdf— 通过--attach {user.workspace}/assets/HGP_Deck_2025.pdf附加。在邮件正文中说“Hypergrowth Partners 演示文稿”(而不是“一页纸”或“我们的演示文稿”) - 起草给已知联系人的介绍邮件时:搜索已发送邮件中之前给他们的介绍,使用相同的格式、语气和描述
介绍类邮件硬性要求(必须)
如果待办事项包含介绍,请严格遵循以下步骤:
- 为每个介绍对创建一个独立的介绍草稿(切勿将多个介绍合并到一个通用跟进中)。
- 主题必须明确:
介绍:<人 A> <> <人 B>。 - 正文必须包含:
- 每人一行的人物简介,
- 一行说明为何进行此介绍的上下文,
- 以
我把接下来的交流交给你们两位。和{user.signature}结尾。
- 切勿在承诺了介绍的情况下,用一个通用的总结邮件(如“今天的会议很棒”)来替代介绍草稿。
- 如果收件人邮箱已知,立即创建 Gmail 草稿;如果缺少任一邮箱,仍然生成完整的草稿文本,并报告
MISSING_EMAIL:<姓名>。 - 在 WhatsApp 结果中,包含一个
已创建介绍草稿:部分,列出每个介绍对以及它是否已在 Gmail 中起草或由于缺少邮箱而被阻止。
首次 VC / 首次渠道通话跟进(必须)
当会议是与 VC 或渠道公司的首次通话时:
- 创建首次会议跟进草稿(除非被下面的仅提案规则阻止)。
- 在正文中使用会议特定的上下文(讨论了什么、明确的下一步、具体提议),而不是通用的客套话。
- 包含您的定位(您如何工作)并在相关时附加
{user.workspace}/assets/HGP_Deck_2025.pdf。 - 仅对此类首次会议跟进,允许使用“今天的会议很棒”。
仅提案承诺规则(必须)
如果您承诺“构建一个提案”(或类似内容:首先准备提案/演示文稿/范围草稿):
- 暂时不要起草外发邮件。
- 创建一个单一的 Todoist 任务来构建并发送提案——例如“构建并发送给 Gabriel (BairesDev) 的咨询提案”。
- 不要为“构建”和“发送”创建单独的任务——那是多余的。一个任务覆盖整个生命周期。
5. 检查今日会议中是否处理了现有 Todoist 任务
处理完待办事项后,还要检查今日会议中是否处理/完成了任何现有已打开的 Todoist 任务:
- 列出已打开的任务:
source {user.workspace}/.env && todoist-cli list - 对于每个会议,检查讨论是否涵盖或处理了任何已打开的任务(例如,“与 Colin 分享 AI 策略” → 在通话中直接与 Colin 讨论了 AI 策略)
- 如果一个任务在会议中明显被处理了,则完成它:
source {user.workspace}/.env && todoist-cli complete <task_id> - 在输出中报告已完成的任务:“✅ 已完成:[任务] — 在 [会议名称] 中已处理”
这确保 Todoist 保持整洁并反映实际情况。
错误处理
- 如果
gog calendar失败:记录带有完整命令和 stderr 的错误(python3 {user.workspace}/scripts/skill_log.py action-items ERROR "gog calendar 失败" '{"command": "...", "stderr": "..."}'),继续使用另一个账号和/或仅使用 Granola。 - 如果
mcporter call granola因认证错误失败:报告“⚠️ Granola 认证已过期,运行mcporter auth granola --reset”并停止。 - 如果
todoist-cli失败:验证.env是否已加载且 token 是否有效。报告错误。 - 如果 Grain MCP 不可用:继续仅使用 Granola 进行提取,并在输出中注明“⚠️ Grain 不可用,结果为仅限 Granola。”
- 如果任何步骤失败,在可能的情况下继续执行其余步骤——不要因一次失败而中止整个运行。
去重(关键 — 防止重复任务)
会议级去重
- 任何处理前的第一步:读取
{user.workspace}/state/processed-meetings-YYYY-MM-DD.json(如果存在——Granola 会议 ID 数组) - 跳过其 ID 已在该列表中的任何会议——不要重新处理它们
- 处理完每个会议后立即(在移动到下一个之前),将其 Granola 会议 ID 追加到该文件中。不要等到最后——在每个会议后写入,以防止与其他定时任务发生竞态。
- 此文件是“此会议今天是否已被处理?”的唯一真实来源。
说明: 对于共享相同名称的定期会议,标题是不可靠的。始终按 Granola 会议 ID 去重。
任务级去重
- 在创建任何任务之前,检查 BOTH 已打开和最近完成的任务是否存在近似重复:
- 获取已打开的任务:
source {user.workspace}/.env && todoist-cli list - 获取今日已完成的任务:使用 Todoist Sync API
completed/get_all,带since=<今日 00:00 UTC>或source {user.workspace}/.env && todoist-cli list --filter "completed today"(如果支持)
- 相同的人 + 相同的操作意图 = 重复(例如“给 Morgane 发短信关于 Hank”和“给 Morgane (Braintrust) 发短信在 Hank 通话之后”)
- 规范化:小写、去除括号内容、压缩空白
- 如果重复项出现在已打开或已完成中的任一 → 跳过,不创建
- 获取已打开的任务:
- 在输出中报告跳过的重复项:“⏭️ 已跳过(已存在):[任务]”
- 为什么检查已完成的任务:用户可能已经在今天早些时候完成了由会后定时任务创建的任务。重新创建是错误的——工作已经完成。
为什么两层都很重要
会后定时任务针对每个会议触发。每日的日终定时任务处理所有会议。没有会议级去重,同一个会议会被处理两次。没有任务级去重,即使会议被重新处理(例如文件写入失败),单个任务也不会被重复创建。
去重是不可协商的
如果一个会议出现在 processed-meetings-YYYY-MM-DD.json 中,在任何情况下都不要再次处理它——即使您认为会后定时任务“可能遗漏了某些内容”。会后定时任务已经处理过了。如果出现问题,用户会手动要求重新运行。
输出
- 已创建任务或已起草草稿 → 列出任务及简短摘要
- 已完成任务(在会议中已处理)→ 用 ✅ 列出
- 始终指明已处理的具体会议(例如“来自 Fyxer 通话、Braintrust 周例会、HGP 员工会议”)——绝不说“来自今天的会议”
- 没有会议或没有待办事项 → NO_REPLY
与 Grain 交叉检查(活跃 — 转录级验证)
Grain MCP 可用,具有完整的转录访问权限。在从 Granola 提取待办事项后:
- 在 Grain 中找到会议:
mcporter call grain.list_attended_meetings --args '{}'注意:Grain 的模式不支持start_date/end_date过滤器。使用空参数调用并按start_datetime手动过滤结果,以匹配今天的日期范围。 - 获取转录:
mcporter call grain.fetch_meeting_transcript --args '{"meeting_id": "<id>"}' - 解析转录以验证 Granola 摘要中提及的每个待办事项是否确实在转录中被明确承诺。
- 如果 Granola 声称存在待办事项,但转录中没有对应内容 → 不创建任务,记录警告。
- 如果转录包含 Granola 摘要中未出现的额外待办事项 → 添加它们。
为什么这样做: Granola 的 AI 摘要有时会发明或误分配待办事项。Grain 转录是客观事实。此交叉检查消除了错误肯定的待办事项。
性能说明: 对于每个会议,获取完整的 Grain 转录。会议可能很长。当判断是否存在待办事项时,请优先使用 Granola 的 query_granola_meetings 结果是主要来源。仅在 Granola 声称有特定待办事项时使用 Grain 进行验证——不要为每个会议获取完整转录来寻找新内容。
最终检查清单
在完成并发送 WhatsApp 消息之前,验证:
- 是否未根据 Granola 输入创建任何错误的任务?(例如“Will sent me the doc”≠ 您的待办事项)
- 每个任务是否都包含具体的人名/公司名,而不是“跟进那个人”?
- 介绍邮件是否已正确起草(按对分开,而非合并)?
- 是否已根据 Grain 转录验证了 Granola 的待办事项?
- 名称去重是否已应用于所有新创建的任务?
- 今日已完成的任务是否已从 Todoist 中标记完成?
- 是否已处理所有会议(按 ID 去重)?