메뉴
Diet and nutrition tracking: log meals, manage food items, view daily/weekly nutrition summaries, analyze calorie trends. Integrates with mediwise-health-tracker and weight-manager.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Private local health assistant for Skills-compatible AI agents. Use for personal or family health records, medical files, metrics, medications, reminders, diet, weight, exercise, sleep, health cards, pre-visit summaries, backups, and Apple Health or Gadgetbridge imports. Local SQLite storage is the default; optional cloud features require explicit setup.
智能健康监测与告警。基于阈值检测、趋势分析和多级告警系统， 按需或在设备同步后检查家庭成员的已记录健康指标。支持全家健康 dashboard 一屏总览。 Intelligent health monitoring and alerting. Uses threshold detection, trend analysis, and multi-level alert records to check recorded family health metrics on demand or after wearable imports. Supports a family dashboard. 关键词：健康监测、异常告警、指标预警、趋势分析、健康报告、心率异常、血压异常、血氧低、告警管理、全家概览、健康dashboard。
Family health and medical record management. Tracks members, visits, medications, lab results, daily metrics, reminders, health cards, and pre-visit summaries.
睡眠追踪与质量分析。记录每晚睡眠时长和各阶段（深睡/浅睡/REM/清醒）， 评估睡眠质量评分，查看每日详情和每周趋势。支持手动录入和可穿戴设备自动同步。 Sleep tracking and quality analysis. Records nightly sleep duration and stages (deep/light/REM/awake), scores sleep quality, and shows daily details and weekly trends. 关键词：睡眠记录、睡眠质量、深睡、REM、睡眠趋势、睡眠分析、失眠、睡了多久、昨晚睡眠。
Import Apple Health or Gadgetbridge exports into MediWise health records. Garmin is experimental; Huawei, Zepp cloud, and OpenWearables are not user-ready.
Weight management: set goals, track progress, log exercise, calculate BMI/BMR/TDEE, analyze calorie balance and body composition. Integrates with diet-tracker and mediwise-health-tracker.
| name | diet-tracker |
| description | Diet and nutrition tracking: log meals, manage food items, view daily/weekly nutrition summaries, analyze calorie trends. Integrates with mediwise-health-tracker and weight-manager. |
提供每餐饮食记录、食物条目管理、每日/每周营养摘要、热量趋势分析等功能。与 mediwise-health-tracker 共享数据库，可与 weight-manager 联动形成"饮食 → 热量 → 体重"完整闭环。
本 Skill 只记录和展示饮食数据、数据来源、用户目标差异与记录完整度，不提供营养治疗或饮食指导。内置参考区间只用于客观对比，不据此推荐用户增加、减少或替换食物。
| 字段 | 说明 |
|---|---|
| id | 记录 ID |
| member_id | 成员 ID |
| meal_type | 餐次: breakfast/lunch/dinner/snack |
| meal_date | 日期 YYYY-MM-DD |
| meal_time | 时间 HH:MM（可选） |
| total_calories | 总热量 kcal |
| total_protein | 总蛋白质 g |
| total_fat | 总脂肪 g |
| total_carbs | 总碳水 g |
| total_fiber | 总膳食纤维 g |
| note | 备注 |
| 字段 | 说明 |
|---|---|
| id | 条目 ID |
| record_id | 关联 diet_records.id |
| food_name | 食物名称 |
| amount | 数量 |
| unit | 单位（g/ml/份/个等） |
| calories | 热量 kcal |
| protein | 蛋白质 g |
| fat | 脂肪 g |
| carbs | 碳水 g |
| fiber | 膳食纤维 g |
| note | 备注 |
| 动作 | 子命令 | 必要参数 | 可选参数 | 说明 |
|---|---|---|---|---|
| add-meal | add-meal | --member-id, --meal-type, --meal-date | --meal-time, --note, --items (JSON) | 添加一餐记录（可同时包含多个食物条目） |
| add-item | add-item | --record-id, --food-name | --amount, --unit, --calories, --protein, --fat, --carbs, --fiber, --note | 向已有餐次追加食物条目 |
| list | list | --member-id | --date, --start-date, --end-date, --meal-type, --limit | 查看饮食记录 |
| delete | delete | --id | --type (record/item) | 删除记录或条目 |
| daily-summary | daily-summary | --member-id, --date | 某日营养摘要 |
| 动作 | 子命令 | 必要参数 | 可选参数 | 说明 |
|---|---|---|---|---|
| weekly-summary | weekly-summary | --member-id | --end-date | 一周营养趋势（每日热量、平均三大营养素） |
| calorie-trend | calorie-trend | --member-id | --days (默认 7) | 热量趋势分析（N 天每日总热量） |
| nutrition-balance | nutrition-balance | --member-id | --days (默认 7) | 三大营养素比例分析 |
| 动作 | 子命令 | 必要参数 | 可选参数 | 说明 |
|---|---|---|---|---|
| food-lookup | search | params.query | params.limit (默认5), params.source (auto/cfcd/brands/usda/openfoodfacts/off/all) | 按可用数据源搜索食物营养（本地数据包 → USDA → Open Food Facts） |
| food-stats | stats | — | — | 查看食物数据库概况（各数据源条目数） |
数据来源（按优先级）：
diet-tracker/data/ 才会启用USDA_API_KEY 环境变量OPENFOODFACTS_ENABLED=1；数据采用 ODbL 1.0，结果会返回产品页和许可证。正式使用应按官方文档填写 API usage form、设置可联系的 User-Agent，并避免搜索即输入等高频调用food-stats 会返回每个数据源的可用状态、来源网址、许可证和本地数据目录。所有在线来源都可用 MEDIWISE_FOOD_ONLINE_ENABLED=0 强制关闭。远程 API 只收到食物查询词及语言/分页参数，不得发送 owner_id、member_id、餐次记录或健康数据。没有任何来源可用时，查询返回 status: unavailable，不得把“数据源不可用”当成“该食物不存在”。
记录一餐的标准流程（不得跳步）：
food-lookup search，见下方"强制规则"）add-meal，通过 --items JSON 一次录入多个食物add-item 向已有餐次添加daily-summary 查看当天营养摄入weekly-summary 或 calorie-trend 查看长期趋势禁止用 AI 自身知识直接估算营养数值写入数据库。 记录每种食物之前，必须先调用 food-lookup search 查询，用数据库返回的数据填充 --items。
自动填充说明：若
--items中某条目未提供热量数据，diet.py会尝试调用本地 food_lookup 数据包补全营养值，并在note字段标注[自动填充]及数据来源。仓库默认不捆绑本地数据包；数据源不可用时必须请用户补充营养标签或显式配置在线来源，不能凭模型知识写入估算值。
# 步骤 1：先查每种食物
python3 {baseDir}/scripts/food_lookup.py search --query "炸排骨"
python3 {baseDir}/scripts/food_lookup.py search --query "米饭"
# 步骤 2：用查询结果里的营养数据填 --items，再记录
python3 {baseDir}/scripts/diet.py add-meal \
--member-id <id> --meal-type lunch --meal-date 2025-03-15 \
--items '[{"food_name":"炸排骨","amount":150,"unit":"g","calories":298,"protein":21.2,"fat":19.3,"carbs":9.1,"note":"来源:CFCD6"}]'
查询未命中时的处理：
note 保留页面 URL、每 100g/每份基准和访问日期。不得采用博客、营销软文、搜索摘要或模型记忆中的数值。note 字段写明数据来源（如"来源：CFCD6"、"来源：用户手动输入"）。--items 参数接受 JSON 数组。所有营养字段必须来自 food-lookup search 的查询结果，不得由 AI 自行估算填充：
[
{"food_name": "鸡胸脯肉", "amount": 150, "unit": "g", "calories": 158, "protein": 31.6, "fat": 3.2, "carbs": 0.0, "note": "来源:CFCD6"},
{"food_name": "米饭", "amount": 200, "unit": "g", "calories": 232, "protein": 4.6, "fat": 0.6, "carbs": 51.5, "note": "来源:CFCD6"}
]
自动换算规则：CFCD6/USDA/Open Food Facts 数据按 amount（克）换算；中国品牌/外食本地数据按每份直接使用。使用 Open Food Facts 时应向用户提示其为社区维护数据，并优先核对具体条码对应的产品页。
owner_id。food-lookup search，或经用户明确确认的手动输入，不得由 AI 凭自身知识估算后直接写入。note 字段必须记录数据来源，便于用户事后核查。