适用场景

用户需要协助处理杂货采购的物流事务——例如创建购物清单、跟踪家庭储藏室库存、记录家庭常用数量，或核对商品是否符合饮食限制。重点在于采购行为本身，而非膳食规划。

架构设计

记忆数据存储于 ~/grocery/ 目录下。初始化配置请参阅 memory-template.md。

~/grocery/
├── memory.md          # HOT：偏好设置、饮食限制、当前购物清单
├── pantry.md          # WARM：家中现有物品、数量、保质期
├── history.md         # COLD：历史采购记录、消费模式
└── stores.md          # 用户偏好的商店及其货架布局

快速参考

数据存储

所有数据均存于 ~/grocery/ 目录中。首次使用时需手动创建：

mkdir -p ~/grocery

能力边界

本技能 **仅支持以下功能**：

• 根据用户输入维护购物清单
• 跟踪用户报告的家庭储藏室库存
• 记住用户的饮食限制与偏好设置
• 基于家庭人数建议合理采购数量

本技能 **绝不执行以下操作**：

• 访问真实超市的库存或价格信息
• 代为下单或完成购买行为
• 扫描条形码或收据
• 读取 ~/grocery/ 目录以外的任何文件

核心规则

1. 学习家庭上下文信息

首次提及上述信息时即写入 memory.md；后续不得重复询问。

2. 数量智能判断

• 默认采用适配家庭规模的份量（单人 = 小份，家庭 = 批量）
• 记住历史采购数量：“你通常采购 2kg 鸡肉”
• 对异常请求主动提示：“该意面用量是你平时的 3 倍——是在做餐食预处理吗？”

3. 饮食限制安全保障

• 新增商品时始终比对已存储的饮食限制
• 识别隐性成分名称：caseína = 乳制品，酱油中含麸质
• 遇不确定情况时明确提示：“含小麦成分——正在核查你的限制：你为无麸质饮食。是否跳过？”

4. 购物清单组织逻辑

• 按用户要求按商店分区归类（生鲜、乳制品、冷冻食品等）
• 支持多个活跃清单并行（如：周常采购、聚会采购、露营采购）
• 自动去重，并合并相同商品的数量

5. 储藏室状态感知

当用户提供家中现有物品信息时：

• 在 pantry.md 中更新对应数量与录入日期
• 与当前购物清单交叉比对，避免重复添加
• 主动确认：“你家中已有 6 枚鸡蛋——是否仍需额外添加 12 枚？”

6. 食谱输入处理（非膳食规划）

若用户提供食谱或某顿餐食信息：

• 提取其中所需食材并加入购物清单
• 根据 pantry.md 中的现有库存进行调整
• 按家庭人数缩放食材用量
• 注意：膳食 **PLANNING** 属于 meals 技能职责范围；本技能仅接收并处理食材清单

常见陷阱

• 向独居用户推荐 4 人份食谱 → 务必优先核查家庭人数
• 推荐本地无法获取的冷门食材 → 应严格限定于用户常用商店范围内
• 跨会话遗忘饮食限制 → 每次启动必须加载 memory.md
• 忽略家庭中“挑食者”的个体偏好 → 需支持按人员维度记录偏好

与 meals 技能的职责边界

若用户提问：“这周我该吃什么？” → 应引导其使用 meals 技能。
本技能仅响应：“我需要买些什么？”