Communitygithub.com

SamuelChien/mega-skills-collection

从今日 Granola/Grain 会议中提取待办事项,创建 Todoist 任务,完成已处理的任务,并起草由会议触发的跟进邮件。适用于运行每日待办事项定时任务、会后定时任务,或用户要求处理会议待办事项时使用。不适用于在无会议上下文的情况下编写通用邮件。

mega-skills-collection 是什么?

此技能旨在自动处理每日会议产生的待办事项、任务创建和邮件起草,能够无缝集成 Granola、Grain、Todoist 和 Gmail。它通过从 Granola 和日历中获取会议数据,提取属于用户的个人待办事项,并智能创建 Todoist 任务,同时严格执行去重逻辑以避免重复。对于承诺的邮件(如介绍、跟进、发送文档),该技能会根据特定规则起草草稿,包括针对首次通话的模板和仅提案承诺的规则。它会对照现有任务进行交叉检查,标记在会议中已处理的任务,并将详细结果通过 WhatsApp 发送。该技能支持 Claude Code、Cursor、Codex 和其他 MCP 兼容平台,通过命令行工具和 MCP 服务器实现操作,并提供详细的调试日志记录和错误处理。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/action-items-todoist

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

待办事项 → 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 任务执行重复检查:

  1. 规范化提议标题(小写、去除标点、压缩空白)
  2. 搜索已打开的任务(source {user.workspace}/.env && todoist-cli list --filter "!completed")并比较规范化内容
  3. 将几乎相同的介绍任务视为重复(例如,“介绍 David 给 Marcos” vs “介绍 David (n8n) 给 Marcos Nils”)
  4. 如果存在重复项:不要创建新任务;在有用时将会议上下文附加到现有任务描述中
  5. 在输出中,在“已跳过(重复项):”下报告去重决定

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 演示文稿”(而不是“一页纸”或“我们的演示文稿”)
  • 起草给已知联系人的介绍邮件时:搜索已发送邮件中之前给他们的介绍,使用相同的格式、语气和描述

介绍类邮件硬性要求(必须)

如果待办事项包含介绍,请严格遵循以下步骤:

  1. 为每个介绍对创建一个独立的介绍草稿(切勿将多个介绍合并到一个通用跟进中)。
  2. 主题必须明确:介绍:<人 A> <> <人 B>。
  3. 正文必须包含:
    • 每人一行的人物简介,
    • 一行说明为何进行此介绍的上下文,
    • 以 我把接下来的交流交给你们两位。 和 {user.signature} 结尾。
  4. 切勿在承诺了介绍的情况下,用一个通用的总结邮件(如“今天的会议很棒”)来替代介绍草稿。
  5. 如果收件人邮箱已知,立即创建 Gmail 草稿;如果缺少任一邮箱,仍然生成完整的草稿文本,并报告 MISSING_EMAIL:<姓名>。
  6. 在 WhatsApp 结果中,包含一个 已创建介绍草稿: 部分,列出每个介绍对以及它是否已在 Gmail 中起草或由于缺少邮箱而被阻止。

首次 VC / 首次渠道通话跟进(必须)

当会议是与 VC 或渠道公司的首次通话时:

  1. 创建首次会议跟进草稿(除非被下面的仅提案规则阻止)。
  2. 在正文中使用会议特定的上下文(讨论了什么、明确的下一步、具体提议),而不是通用的客套话。
  3. 包含您的定位(您如何工作)并在相关时附加 {user.workspace}/assets/HGP_Deck_2025.pdf。
  4. 仅对此类首次会议跟进,允许使用“今天的会议很棒”。

仅提案承诺规则(必须)

如果您承诺“构建一个提案”(或类似内容:首先准备提案/演示文稿/范围草稿):

  • 暂时不要起草外发邮件。
  • 创建一个单一的 Todoist 任务来构建并发送提案——例如“构建并发送给 Gabriel (BairesDev) 的咨询提案”。
  • 不要为“构建”和“发送”创建单独的任务——那是多余的。一个任务覆盖整个生命周期。

5. 检查今日会议中是否处理了现有 Todoist 任务

处理完待办事项后,还要检查今日会议中是否处理/完成了任何现有已打开的 Todoist 任务:

  1. 列出已打开的任务:source {user.workspace}/.env && todoist-cli list
  2. 对于每个会议,检查讨论是否涵盖或处理了任何已打开的任务(例如,“与 Colin 分享 AI 策略” → 在通话中直接与 Colin 讨论了 AI 策略)
  3. 如果一个任务在会议中明显被处理了,则完成它:source {user.workspace}/.env && todoist-cli complete <task_id>
  4. 在输出中报告已完成的任务:“✅ 已完成:[任务] — 在 [会议名称] 中已处理”

这确保 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 已打开和最近完成的任务是否存在近似重复:
    1. 获取已打开的任务:source {user.workspace}/.env && todoist-cli list
    2. 获取今日已完成的任务:使用 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 提取待办事项后:

  1. 在 Grain 中找到会议:mcporter call grain.list_attended_meetings --args '{}' 注意:Grain 的模式不支持 start_date/end_date 过滤器。使用空参数调用并按 start_datetime 手动过滤结果,以匹配今天的日期范围。
  2. 获取转录:mcporter call grain.fetch_meeting_transcript --args '{"meeting_id": "<id>"}'
  3. 解析转录以验证 Granola 摘要中提及的每个待办事项是否确实在转录中被明确承诺。
  4. 如果 Granola 声称存在待办事项,但转录中没有对应内容 → 不创建任务,记录警告。
  5. 如果转录包含 Granola 摘要中未出现的额外待办事项 → 添加它们。

为什么这样做: Granola 的 AI 摘要有时会发明或误分配待办事项。Grain 转录是客观事实。此交叉检查消除了错误肯定的待办事项。

性能说明: 对于每个会议,获取完整的 Grain 转录。会议可能很长。当判断是否存在待办事项时,请优先使用 Granola 的 query_granola_meetings 结果是主要来源。仅在 Granola 声称有特定待办事项时使用 Grain 进行验证——不要为每个会议获取完整转录来寻找新内容。

最终检查清单

在完成并发送 WhatsApp 消息之前,验证:

  • 是否未根据 Granola 输入创建任何错误的任务?(例如“Will sent me the doc”≠ 您的待办事项)
  • 每个任务是否都包含具体的人名/公司名,而不是“跟进那个人”?
  • 介绍邮件是否已正确起草(按对分开,而非合并)?
  • 是否已根据 Grain 转录验证了 Granola 的待办事项?
  • 名称去重是否已应用于所有新创建的任务?
  • 今日已完成的任务是否已从 Todoist 中标记完成?
  • 是否已处理所有会议(按 ID 去重)?

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

相关技能