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 步——对先前运行和操作项基础进行去重
ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null(相对于保险库根目录)——如果存在,读取它们并提取所有已列为需操作的邮件主题/发件人以及已列为新闻通讯亮点的新闻通讯。ls "Jarvis Summaries/Action Items/"并检查你即将标记的每封邮件是否已有追踪笔记:grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/"。
如果某件事今天已被报告过,或者已有未关闭的操作项笔记,则不要在摘要中重复,也不要创建重复的笔记——只更新现有笔记(第 5b 步),除非有真正的新信息(回复、更新、同一主题的不同邮件)。
第 0c 步——处理待处理的基础操作项
操作项基础有一个 archive 复选框列(Rick 在 Obsidian 中勾选它)。在扫描收件箱之前,扫描待处理的操作项:
grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md(如果缩进有差异,也要匹配没有插入符的archive: true)。- 对于每个匹配项,读取笔记的前置元数据。如果
status已经是Done或Dismissed(已在之前运行中处理——无需操作),则跳过它。 - 否则归档底层邮件:
gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'。 - 成功后,更新笔记的前置元数据:设置
status: Dismissed和last_run为当前时间。保留archive: true作为操作的记录——不要取消勾选它。 - 失败时(例如消息已被删除),保持
status不变,不要无休止地重试,并在本次运行的分类摘要(第 7 步)的 Errors 行中记录失败,以便 Rick 看到。
此步骤是关闭复选框循环的唯一方法——在 Obsidian 中勾选它不会对实际的 Gmail 消息产生任何作用,直到下次计划的分类运行将其拾取(每 6 小时一次,07:00-22:00)。
第 0d 步——老化过时的追踪项目
操作项基础只会增长,除非有人主动关闭笔记——第 0c 步需要 Rick 注意到并勾选一个框,这无法扩展(到 2026-09-18 它已达到 274 条笔记,253 条仍为 Open,有些来自六周前)。此步骤在每次分类时运行,并在可以安全推断项目不再活跃时自动关闭笔记,从而使基础保持为需要 Rick 真正关注的事项的可靠列表。
- 列出
Jarvis Summaries/Action Items/中每个Open笔记的gmail_id。 - 拉取当前完整的收件箱 ID 集(不仅仅是未读):
gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'。如果响应包含nextPageToken,则重复请求并设置pageToken,直到没有下一页,以确保覆盖整个收件箱(它经常超过 500 封)。 - 关闭任何
gmail_id不再在该集合中的Open笔记。 如果底层邮件根本不在收件箱中,那么 Rick(或其他人)已经在此流程之外处理了它——该笔记已成为孤立笔记。设置status: Dismissed,保留archive: false(没有东西可以归档了),并在笔记正文中附加一行:**Auto-closed <今天的日期>:** underlying email no longer in inbox — resolved outside the triage flow.。不要触碰邮件仍留在收件箱中的笔记;那些仍需人工查看。 - 针对仍在收件箱中的笔记,按类别老化特定噪音:
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 步的收件箱存在性检查适用于它们;切勿通过计时器使其老化。
- 在分类摘要(第 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.
…
[为翻译而截断]