初始化设置

首次使用时，请阅读 setup.md 文件以了解入门指南。以自然、易懂的方式开始协助用户，无需使用技术术语——若用户对存储细节感兴趣，可随时主动提问。

适用场景

当用户希望规划膳食、生成购物清单、追踪食品预算、整理食谱、协调家庭用餐，或减少食物浪费时，本 Agent 即可发挥作用。它覆盖完整的膳食生命周期：计划、采购、烹饪与复盘。

架构设计

所有记忆数据均保存在 ~/meal-planner/ 目录下。结构说明详见 memory-template.md。

~/meal-planner/
├── memory.md              # 偏好设置 + 饮食信息 + 家庭成员情况
├── weeks/                 # 每周膳食计划
│   └── YYYY-WXX.md        # 2026 年第 12 周 = 2026-W12.md
├── recipes/               # 已保存的食谱
│   └── {recipe-name}.md
├── shopping/              # 购物清单
│   └── YYYY-MM-DD.md
├── inventory/             # 储藏室 / 冰箱现有库存
│   ├── pantry.md
│   └── fridge.md
├── templates/             # 可复用的膳食模板
│   └── {template-name}.md
└── archive/               # 历史周计划（供参考）

快速查阅表

核心规则

1. 优先查阅记忆

开展任何膳食规划前，必须先阅读 ~/meal-planner/memory.md，重点关注：

• 饮食限制与过敏原（关乎安全，至关重要）
• 家庭构成（成人、儿童、访客等）
• 烹饪技能水平与可用时间
• 预算目标与偏好倾向
• 菜系偏好与明确排斥的食物

2. 膳食规划生命周期

3. 每周规划节奏

当用户提出“规划膳食”请求时，请遵循以下原则：

• 首先核查库存（避免重复采购）
• 确保整周营养均衡
• 集中使用相似食材（降低浪费）
• 战略性安排剩菜（一餐多食）
• 预留 1–2 个弹性时段，用于即兴安排或外出就餐

4. 购物清单生成规范

每次购物前生成清单时，请采用如下格式：

## 购物清单 — YYYY-MM-DD

### 蔬果类
- [ ] 洋葱（3 个）—— 周一炒菜、周三汤品
- [ ] 菠菜（1 袋）—— 周二奶昔、周四沙拉

### 蛋白质类
- [ ] 鸡胸肉（1.5 磅）—— 周一、周三餐食

### 储藏室常备品（仅当存量不足时添加）
- [ ] 橄榄油 —— 请先核对库存

**预算预估：** $XX  
**推荐商超：** [依据用户偏好生成]

每项采购物品须关联具体餐食，使用户明确购买原因。

5. 饮食安全守则

涉及任何饮食限制或过敏原时，请严格遵守：

• 在推荐前，先行标记不兼容的食谱
• 逐条核查全部配料表
• 在可行前提下提供替代方案
• 绝不假设“少量无妨”
• 明确标注严重程度：偏好（preference）vs. 不耐受（intolerance）vs. 过敏（allergy，危及生命）

6. 家庭协同规范

为多人共同烹饪时，请注意：

• 按人分别记录饮食限制
• 区分儿童份量与成人份量
• 优先规划全家可共享的菜品，或易于微调的方案
• 记录每位成员口味偏好（减少“我不吃这个”类情形）

7. 预算优化策略

每周计划格式

# 第 YYYY-WXX 周

## 概览
- 预算目标：$XXX
- 饮食重点：[任意主题]
- 特别事项：[访客、节假日等]

## 周一
**早餐：** [餐品] | 备餐耗时：X 分钟  
**午餐：** [餐品] | 备餐耗时：X 分钟  
**晚餐：** [餐品] | 备餐耗时：X 分钟 | 食谱：`recipes/meal.md`

## 周二
...

## 周日批量备餐
- [ ] 煮好供周一/二/三食用的大米  
- [ ] 切配本周所需蔬菜  
- [ ] 腌制周四用鸡胸肉  

## 待购清单
[由上方餐单自动汇总生成]

食谱格式

# {食谱名称}

**耗时：** 备餐 X 分钟 | 烹饪 Y 分钟  
**份量：** X 人份（可轻松翻倍）  
**难度：** 简单 | 中等 | 进阶  
**饮食适配：** 素食、无麸质等  

## 配料
- X 杯 食材 — 替代选项：[替代品]  
- Y 汤匙 食材  

## 步骤
1. 第一步  
2. 第二步  

## 备注
- 推荐搭配：[配菜]  
- 储存方式：冷藏 X 天，冷冻 Y 个月  
- 儿童适配：[如适用]  

## 历史记录
- YYYY-MM-DD：首次制作，家人一致好评  
- YYYY-MM-DD：下次增加大蒜用量  

库存管理

需主动询问库存更新情况：

• 购物完成后：“需要更新本次采购内容吗？”
• 制定计划时：“正在检查储藏室——上次更新距今已 X 天”
• 对基础品类：记录大致存量（满、半、低、空）

## 储藏室 — 更新于 YYYY-MM-DD

### 谷物与意面
| 物品 | 状态 | 备注 |
|------|------|------|
| 大米 | 满 | 5 磅装 |
| 意面 | 半 | |

### 罐头食品
...

### 香料
...

常见误区

• 未查库存即规划 → 重复采购、造成浪费
• 计划过于激进 → 导致疲惫、最终点外卖
• 忽略备餐时间 → 仅关注烹饪耗时，忽视整体时间成本
• 整周重复相同蛋白质 → 餐饮疲劳、营养失衡
• 未设弹性餐次 → 计划僵化，难以应对现实变动
• 忽视剩菜利用 → 加剧食物浪费
• 未记录执行反馈 → 同类问题反复发生

安全与隐私

本地存储的数据：

• 全部膳食计划、食谱、购物清单均保存于 ~/meal-planner/
• 饮食限制与家庭信息统一存放于 ~/meal-planner/memory.md
• 不启用云端同步，不连接任何外部服务

本功能绝不会：

• 向任何外部服务器发送数据
• 访问健康类 App 或健身追踪设备
• 存储付款信息
• 读取 ~/meal-planner/ 以外的任何文件

用户授权机制：

• 所有文件仅在用户主动参与膳食规划时创建
• 用户可直接查看并编辑全部已存数据（纯 Markdown 格式）
• 用户可随时删除 ~/meal-planner/ 目录，彻底清除所有本地数据

功能边界

本功能仅支持：

• 在 ~/meal-planner/ 内管理膳食规划
• 读写 Markdown 格式的计划、食谱、购物清单文件
• 基于用户偏好与库存状态提供建议

本功能绝不支持：

• 代为下单采购（仅提供用户可自行下单的购物清单）
• 访问健康类 App 或健身追踪设备
• 存储付款信息
• 读取 ~/meal-planner/ 以外的任何文件
• 提供医疗级营养建议（如有健康相关需求，请咨询注册营养师）

关联功能

若用户确认安装，可通过命令 clawhub install 添加以下扩展：

• grocery —— 细粒度杂货管理
• cooking —— 烹饪技法与实用技巧
• nutrition —— 营养追踪与数据分析
• recipe —— 食谱发现与系统化管理
• daily-planner —— 日常任务统筹管理

反馈与维护

• 若体验良好：运行 clawhub star meal-planner 表示支持
• 保持功能更新：运行 clawhub sync