claw-household: Instructions file for Claude Code

Household Agent（家庭智能管理系统）

Cursor：Notion MCP

本仓库已配置官方 Notion MCP（.cursor/mcp.json）。重载 Cursor 后在 Settings → MCP 完成 OAuth；详见 .cursor/README.md。

数据位置

• 库存：~/家庭管理/data/inventory.json
• 最近手动录入快捷块：~/家庭管理/data/manual_import_recent.json（最多 10 条）
• 按品牌的尿裤段位：~/家庭管理/config/diaper_brand_segments.json
• 消耗记录：~/家庭管理/data/consumption_history.json
• 餐食日记（食材→菜→餐）：~/家庭管理/data/meal_diary.json
• 宝宝日志：~/家庭管理/data/baby_log.json
• 品类配置：~/家庭管理/config/categories.json
• 购买渠道候选项：~/家庭管理/config/purchase_channels.json（网页可追加新渠道）
• 偏好设置：~/家庭管理/config/preferences.json（含 family.babies 多宝宝列表；未配置 babies 时由 baby_name / baby_log.json 的 baby 合并展示）

Web 底部导航

• 库存 · 补货 · 做菜 · 日历 · 设置 · 宝宝（仅当存在宝宝时显示；Tab 文案为宝宝名字，多个用 · 连接）
• 做菜：按 Notion 式餐食 log 记录「每餐」；数据结构为 食材库 → 菜谱（菜）→ 具体一餐；菜谱可「收藏」
• 日历：按月查看每日聚合：入库（purchase_date + 购买渠道）、宝宝事件、三餐记录
• 设置：维护多宝宝（保存空列表可关闭宝宝 Tab，不再自动从档案合并）

API 摘要

• GET/PATCH /api/preferences（含 llm_cooking_ready：是否已配置大模型，做菜页可用）
• GET /api/meal-diary，POST /api/meal-diary/ingredients|dishes|meals，PATCH /api/meal-diary/dishes/:id（收藏）
• GET /api/cooking-recommendations（常吃 Top、只差 1 样食材）
• POST /api/cooking/llm-recommendations（{ count?, hint? }，需 preferences.json 的 llm）
• POST /api/cooking/llm-expand-steps（{ name, ingredients[], steps_brief? }，展开更详细做法）
• GET /api/calendar?from=&to= 日聚合

库存管理（核心命令）

# 入库（条码自动查 Open Food Facts）
node ~/家庭管理/skills/inventory.js add <条码或商品名>

# 记录消耗
node ~/家庭管理/skills/inventory.js consume <ID或名称> [数量] [备注]

# 查看所有库存
node ~/家庭管理/skills/inventory.js list

# 查看指定位置库存（如：冰箱冷藏）
node ~/家庭管理/skills/inventory.js list 冰箱冷藏

# 即将过期清单（默认7天）
node ~/家庭管理/skills/inventory.js expiring

# 总览看板
node ~/家庭管理/skills/inventory.js status

# 搜索
node ~/家庭管理/skills/inventory.js search 牛奶

常用交互场景

用户说	Claude 操作
扫码入库 / 发送条码	运行 add <条码> 入库
家里还有什么快过期的	运行 expiring 7
今晚吃什么	查库存 → 查菜谱 → 推荐
做好了 / 用掉了XX	运行 consume <名称> <数量>
看看家里有什么	运行 status 或 list
生成购物清单	查 expiring + 库存不足 + 当前菜谱缺料