Private Assistant

消息平台优先的私人助手 skill，覆盖三条子链路：

• 记录：收入、支出、备忘、感悟
• 提醒：创建、查看、取消
• 洞察：消费总结、异常观察、消费与备忘联动复盘、可选订阅简报

References

• references/data-model.md：字段和存储约定
• references/interaction-rules.md：输入解析与输出模板
• references/insight-rules.md：洞察信号、低打扰策略、关联边界
• references/insight-templates.md：周摘要、月复盘、异常观察、联动复盘模板

Scripts

• python SKILL_DIR/scripts/records.py ...
• python SKILL_DIR/scripts/reminders.py ...
• python SKILL_DIR/scripts/insights.py ...

SKILL_DIR 是当前 skill 根目录。数据固定写入 HERMES_HOME/data/private-assistant/，按当前 profile 自动隔离。

When To Use

• 用户要“记一笔”“记账”“查账”“看本月花了多少”
• 用户要“记一下”“备忘”“写个感悟”“找一下上周那条记录”
• 用户要“提醒我明天 8 点”“取消刚才那个提醒”“看看还有哪些提醒”
• 用户要“本周消费总结”“本月花销复盘”“最近消费有什么异常”
• 用户要“最近消费和备忘一起看一下”“开启每周简报”“关闭月度复盘”

Core Rules

1. 普通对话默认只给一条最终回复，不发送过程信息。
2. 回复在一条消息内保持结构清晰，优先用 ｜ 和短标签组织。
3. 缺少一个关键字段时，只追问一个问题；不要发散追问。
4. 不把正文或账目流水写入 memory。memory 只用于稳定偏好，例如“默认币种改成 USD”。
5. 默认币种是 CNY，时间未写明时按当前本地时间处理。
6. 洞察默认只支持手动查询；订阅式周/月简报只有在用户明确开启时才创建。
7. 定时洞察在低信号时必须保持静默；如果脚本返回 [SILENT]，就不要向用户发送额外说明。

Workflow

1. 先判断意图

• 账目：收入 / 支出 / 查询 / 汇总 / 修改 / 删除
• 备忘：记录 / 查询 / 修改 / 删除
• 提醒：创建 / 查看 / 取消
• 洞察：手动总结 / 异常观察 / 联动复盘 / 开启订阅 / 关闭订阅

如果一句话同时包含“记一下”和明确金额，优先按记账处理；如果是情绪、感受、复盘、状态，优先按感悟处理。

2. 记账

新增账目：

python SKILL_DIR/scripts/records.py transaction-add --type expense --amount 32 --category 餐饮 --note "午饭"
python SKILL_DIR/scripts/records.py transaction-add --type income --amount 8000 --category 工资 --note "四月工资"

查询和汇总：

python SKILL_DIR/scripts/records.py transaction-list --range today --limit 5
python SKILL_DIR/scripts/records.py transaction-list --range week --category 餐饮
python SKILL_DIR/scripts/records.py transaction-summary --range month

修改和删除：

python SKILL_DIR/scripts/records.py transaction-update --last --amount 28
python SKILL_DIR/scripts/records.py transaction-delete --last

处理规则：

• 记账至少需要 type 和 amount
• category 未提供时，可依赖脚本自动补默认分类
• counterparty 用于商家、来源、对方名称
• 如果金额是算式，例如 81+13，默认先换算总额并只记 一笔，即 94；只有用户明确要求拆分时才分多笔写入

3. 备忘与感悟

新增记录：

python SKILL_DIR/scripts/records.py memo-add --content "明天联系房东" --kind note
python SKILL_DIR/scripts/records.py memo-add --content "我最近总熬夜，有点焦虑" --kind reflection

查询：

python SKILL_DIR/scripts/records.py memo-list --range 7d --limit 5
python SKILL_DIR/scripts/records.py memo-list --keyword 焦虑 --kind reflection

修改和删除：

python SKILL_DIR/scripts/records.py memo-update --last --content "明天联系房东并确认租金"
python SKILL_DIR/scripts/records.py memo-delete --last

处理规则：

• 明显是想法、情绪、复盘时用 reflection
• 明显是待办、提醒事项时用 note
• 用户没给标题时，脚本会从正文生成短标题

4. 提醒

创建提醒时，先确保对应 memo 已存在，再创建 cron 任务。

创建流程：

1. 用 records.py memo-add 新建或确认目标 memo
2. 生成提醒 payload：