Communitygithub.com

richardbowman/agent-skills

个人助理技能,用于 Gmail 收件箱分类、草拟回复、扫描新闻通讯中感兴趣的内容,以及准备旅行报告。拥有完整的定时 Gmail 收件箱分类流程(包括 Obsidian 中的“邮件操作项”基础)。用于管理邮件或自动化工作/开发工作流。

agent-skills 是什么?

该技能是一个高度专业的 AI 代理助手,专注于管理 Rick 的 Gmail 收件箱和日常专业工作流。它提供了一套完整的收件箱分类流程,包括扫描未读邮件、归档常规噪音、提取新闻通讯要点、识别需要操作的项目,并通过一个结构化的操作项基础数据库进行维护和自动老化处理。该技能还包含旅行行程追踪和邮件草稿创建功能。它被设计为与 Claude 和 Gemini 等 AI 代理一起工作,利用宿主平台的 Gmail 连接器和安全秘密检索功能,而不是替代它们。核心价值在于完全自动化了从邮件分类到关闭操作项的整个闭环,减少了手动操作,确保重要的项目不会被遗漏。

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/richardbowman/agent-skills/tree/HEAD/rb-personal-assistant

在你喜欢的 AI 中提问

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

文档

RB 个人助理

利用平台可移植性

使用当前宿主平台的 Gmail 连接器、安全秘密请求、保险库/文件工具以及调度器等效功能。如果所需的连接器不可用,则准备草稿/报告并识别缺失的能力;切勿绕过发送邮件或更改外部状态的确认规则。在 Claude Sessions 保险库中已有的标题应作为存储模式保留,而不是作为宿主平台的要求。

该技能允许 AI 助手(Claude 或 Gemini)充当 Rick 的 Gmail 收件箱和专业工作流的主动助理。它是收件箱分类流程的唯一真实来源——计划的 cron 作业只需调用此技能,因此请将完整逻辑保留在此处,而不是在 cron 提示词中重复。


Gmail 收件箱分类——完整流程

每当被要求分类收件箱时运行此流程,包括计划/无人值守的运行。使用 gws CLI(已在 PATH 中)。按顺序执行步骤。

关键常量

  • 保险库路径: 下面的每个保险库路径都是相对于保险库根目录的;运行时提供保险库根目录。切勿硬编码。
  • Jarvis 归档标签: Label_9220311120338883160——要归档,需在同一个 modify 调用中同时添加此标签并移除 INBOX。
  • 收件箱扫描查询: gws gmail +triage --query 'is:unread label:INBOX' --max 60
  • 上下文笔记: Jarvis Summaries/triage-context.md
  • 操作项文件夹: Jarvis Summaries/Action Items/
  • 操作项基础(已存在——切勿重新创建):Jarvis Summaries/Email Action Items.base
  • 摘要文件夹: Jarvis Summaries/
  • 每日笔记: Daily/<YYYY-MM-DD>.md
  • gws 注意事项: 标签参数必须是纯字符串,而不是数组——例如 addLabelIds: "Label_9220311120338883160",removeLabelIds: "INBOX"。
  • zsh 注意事项: 此环境的 shell 是 zsh,而不是 bash。for x in $VAR; do 在 zsh 中不会对未加引号的变量进行单词分割(与 bash 不同)——以这种方式构建的多 ID 循环会静默运行一次,并将整个字符串作为 $x。请改用 zsh 数组:IDS=(id1 id2 id3); for id in "${IDS[@]}"; do ...。另外,status 是 zsh 的只读内置变量——切勿将 shell 变量命名为 status(请使用 st 或类似名称),否则赋值会失败。

第 0 步——读取上下文笔记

读取上下文笔记文件。这些是 Rick 关于他已经处理过或希望本次运行以不同方式处理的事项的笔记——将它们纳入下面的每个决策中。运行后,移除你已处理的任何笔记(编辑“待处理笔记”部分)。如果某条笔记应成为永久规则,请将其添加到 references/preferences.md 中,而不是保留在上下文文件中。

第 0b 步——对先前运行和操作项基础进行去重

  1. ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null(相对于保险库根目录)——如果存在,读取它们并提取所有已列为需操作的邮件主题/发件人以及已列为新闻通讯亮点的新闻通讯。
  2. ls "Jarvis Summaries/Action Items/" 并检查你即将标记的每封邮件是否已有追踪笔记:grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/"。

如果某件事今天已被报告过,或者已有未关闭的操作项笔记,则不要在摘要中重复,也不要创建重复的笔记——只更新现有笔记(第 5b 步),除非有真正的新信息(回复、更新、同一主题的不同邮件)。

第 0c 步——处理待处理的基础操作项

操作项基础有一个 archive 复选框列(Rick 在 Obsidian 中勾选它)。在扫描收件箱之前,扫描待处理的操作项:

  1. grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md(如果缩进有差异,也要匹配没有插入符的 archive: true)。
  2. 对于每个匹配项,读取笔记的前置元数据。如果 status 已经是 Done 或 Dismissed(已在之前运行中处理——无需操作),则跳过它。
  3. 否则归档底层邮件:gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'。
  4. 成功后,更新笔记的前置元数据:设置 status: Dismissed 和 last_run 为当前时间。保留 archive: true 作为操作的记录——不要取消勾选它。
  5. 失败时(例如消息已被删除),保持 status 不变,不要无休止地重试,并在本次运行的分类摘要(第 7 步)的 Errors 行中记录失败,以便 Rick 看到。

此步骤是关闭复选框循环的唯一方法——在 Obsidian 中勾选它不会对实际的 Gmail 消息产生任何作用,直到下次计划的分类运行将其拾取(每 6 小时一次,07:00-22:00)。

第 0d 步——老化过时的追踪项目

操作项基础只会增长,除非有人主动关闭笔记——第 0c 步需要 Rick 注意到并勾选一个框,这无法扩展(到 2026-09-18 它已达到 274 条笔记,253 条仍为 Open,有些来自六周前)。此步骤在每次分类时运行,并在可以安全推断项目不再活跃时自动关闭笔记,从而使基础保持为需要 Rick 真正关注的事项的可靠列表。

  1. 列出 Jarvis Summaries/Action Items/ 中每个 Open 笔记的 gmail_id。
  2. 拉取当前完整的收件箱 ID 集(不仅仅是未读):gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'。如果响应包含 nextPageToken,则重复请求并设置 pageToken,直到没有下一页,以确保覆盖整个收件箱(它经常超过 500 封)。
  3. 关闭任何 gmail_id 不再在该集合中的 Open 笔记。 如果底层邮件根本不在收件箱中,那么 Rick(或其他人)已经在此流程之外处理了它——该笔记已成为孤立笔记。设置 status: Dismissed,保留 archive: false(没有东西可以归档了),并在笔记正文中附加一行:**Auto-closed <今天的日期>:** underlying email no longer in inbox — resolved outside the triage flow.。不要触碰邮件仍留在收件箱中的笔记;那些仍需人工查看。
  4. 针对仍在收件箱中的笔记,按类别老化特定噪音:
    • CI/CD: 如果 first_seen 超过 5 天,并且 Rick 从未将笔记更新为 In Progress/Done,则将其视为过时(CI 失败总是会被下一次运行或直接查看仓库所取代——一周前的追踪笔记没有信息价值)。归档邮件(Jarvis 标签)并设置 status: Dismissed,注明 **Auto-closed <日期>:** CI/CD notice unresolved after 5+ days, treated as stale — check the repo directly if still relevant.。
    • Appointment: 如果 due_date(当没有 due_date 时用 email_date)是过去的时间,则约会已经发生或已过期——归档邮件并以 **Auto-closed <日期>:** appointment date has passed. 关闭。
    • 归类为 Other 的运输/配送通知(主题包含“package”/“delivery”/“shipped”/“on the way”):如果超过 10 天,则归档并以 **Auto-closed <日期>:** shipping window has elapsed. 关闭。(更好的是:根据第 5b 步,在创建时就将这些笔记标记为已关闭,这样此步骤永远不必处理它们——请参阅那里的说明。)
    • 保留 Billing、Security、Compliance、Invoice、Benefits、Opportunity、Solar、SEO 和 Account 不变——这些类别可能涉及真金白银、截止日期或需要人工判断,因此第 3 步的收件箱存在性检查适用于它们;切勿通过计时器使其老化。
  5. 在分类摘要(第 7 步)中报告计数,而不是逐项列出——例如 Housekeeping: closed 14 stale notes (9 no longer in inbox, 4 aged CI/CD, 1 past-due appointment).。完整的逐项列表不是有用的信号;计数确认了扫描已运行。

第 1 步——扫描未读消息

运行上述收件箱扫描查询。(注意:不带查询的纯 gws gmail +triage 默认搜索整个邮箱的 is:unread,上限为 20 封——由于已归档但仍未读的邮件会占用真正的收件箱项目,因此它会错过实际的收件箱积压。始终传递显式的 label:INBOX 查询,以便扫描实际的收件箱。)

第 2 步——归档常规噪音

归档(Jarvis 标签 + 移除 INBOX):TestFlight / GitHub / Vercel 成功通知、Experian 促销、TaxSlayer、已知帐户的 Google 安全提醒。另外,在总结新闻通讯亮点(第 4 步)后归档新闻通讯——不要将它们留在收件箱中。

第 3 步——建筑/公寓通知

将公寓协会/建筑邮件移至 Home 标签。

第 4 步——新闻通讯

扫描新闻通讯(WBEZ、Block Club、City Cast 等),查找符合 Rick 兴趣的片段:熏肉、面包、骑行、家庭自动化、Linux、密歇根西南部本地、哥斯达黎加/葡萄牙旅行(完整兴趣图谱在 references/preferences.md 中)。总结任何命中内容,然后归档新闻通讯(Jarvis 标签)。跳过今天已经总结过的任何新闻通讯(第 0b 步)——只需静默归档即可。

第 5 步——标记需要操作的项目

标记:来自优先联系人的发票、生产/计费/安全警报、合规/鉴证截止日期、约会准备以及有偿机会。跳过上下文笔记中 Rick 说他已经处理过的任何内容。跳过今天已经报告过或已有未关闭操作项笔记跟踪的任何内容(第 0b 步),除非有真正的新信息。纯运输/配送通知(“您的订单已发货”)报告一次,然后归档——在创建时(第 5b 步)将其追踪笔记标记为已关闭(status: Dismissed,archive: true),而不是 Open,因为配送通知无需后续操作。将这些保留为 Open 正是第 0d 步后来需要无缘无故清理的那种笔记。

第 5b 步——维护操作项基础

对于第 5 步中标记的每个项目,确保其在操作项文件夹中作为笔记被跟踪,以便出现在邮件操作项基础中。基础文件已存在——不要重新创建它。

  • 按 gmail_id 去重(第 0b 步)。如果存在具有该 id 的笔记:仅更新 last_run(和 last_seen)为当前运行——不要覆盖 status(Rick 手动管理它),也不要重复。如果现有笔记的状态是 Done 或 Dismissed,则保持关闭状态;不要重新打开或重新标记它。
  • 如果不存在笔记,则创建一个。 文件名:<发件人> - <简短主题>.md(去除文件名中的无效字符:/ \ : 等)。前置元数据模式:
---
type: email-action
status: Open            # Open | In Progress | Done | Dismissed  (Rick 在 Obsidian 中编辑此字段)
archive: false          # Rick 在基础中勾选此框以归档邮件并关闭项目(第 0c 步)
priority: High          # High | Medium | Low
priority_rank: 1        # 1=高, 2=中, 3=低  (驱动排序顺序)
category: Billing       # Billing | Invoice | Security | Compliance | CI/CD | Account | Benefits | Appointment | Opportunity | Solar | SEO | Other
sender: "Vercel"
subject: "..."
email_date: YYYY-MM-DD  # 邮件收到的日期
due_date:               # 可选;仅当邮件陈述了一个截止日期时使用
gmail_id: <gws 返回的 hex id>
gmail_link: https://mail.google.com/mail/u/0/#all/<hex id>
first_seen: YYYY-MM-DD  # 今天的日期
last_run: YYYY-MM-DD-HH-MM
---

正文:一个 H1 # <发件人> — <主题>,1-2 句描述所需操作的句子,以及一个 **[Open in Gmail](<gmail_link>)** 行。gmail_link 的 hex id 与 gws 返回的十六进制消息/线程 id 相同——它是 Gmail 的网页永久链接。

  • 合理分配优先级: 高 = 资金风险/生产故障/硬性截止日期(计费失败、逾期付款、安全漏洞、合规鉴证);中 = 需要尽快做出决定或回复(发票、CI 失败、帐户设置、约会、有偿机会);低 = 信息性但可操作(对账单、SEO 审计、营销提示)。

第 6 步——旅行保留

在旅行确认结束之前,不要归档旅行邮件(万豪、AC 酒店、UPS、航空公司)。请参阅下面的旅行与行程报告。

第 7 步——编写分类摘要

写入 Jarvis Summaries/Triage-<YYYY-MM-DD-HH-MM>.md,包含以下部分:需操作项、新闻通讯亮点、已归档、内务管理。在“需操作项”下,注明这些项目也在 [[Jarvis Summaries/Email Action Items.base|邮件操作项]] 基础中进行了跟踪。如果第 0c 步处理了任何复选框操作,则添加一个 通过基础归档 行列出它们,并为任何失败项添加一个 错误 行。在内务管理下,报告第 0d 步的关闭计数。如果没有发现新内容,则写入一条简短的“自上次运行以来没有新项目”的说明(第 0d 步的内务管理仍会运行并报告),然后停止。

第 8 步——在每日笔记中创建链接

在 Daily/<YYYY-MM-DD>.md 的 ## Claude Sessions 部分下添加一个指向摘要文件的 Wiki 链接(如果该部分不存在,则创建它)。

计划/无人值守的运行:完成第 0-8 步然后停止——无需将摘要发布到任何其他地方。


旅行与行程报告

  • 识别: 追踪酒店(万豪、AC 酒店)、航班和运输(UPS)邮件。
  • 工作流: (未来)检查日历以将这些关联成一个单一的“行程报告”。
  • 操作: 在行程结束前,不要归档旅行收据/信息。

回复协议

  • 优先联系人: (例如 HVAC 承包商)草拟简短、礼貌的回复以处理发票或询问。
  • 安全: 未经 Rick 明确确认,切勿授权付款或点击财务链接。

创建 Gmail 草稿(带或不带附件)

gws CLI 无法处理作为命令行参数的大负载。请改用下面的 Python 配方,它直接解密 gws 凭据并调用 Gmail API。

纯文本草稿:

import base64, json, subprocess
from email.mime.text import MIMEText

# Get fresh access token
from cryptography.hazmat.primitives.ciphers.aead import AESGCM
key = base64.b64decode(subprocess.run(['security', 'find-generic-password', '-s', 'gws-cli', '-w'], capture_output=True, text=True).stdout.

…

[为翻译而截断]

相关技能