前言¶
想控制体重或调整饮食时，常见做法是装一款记录 App，或每次问模型「这顿大概多少卡」却得不到可对比的日汇总。前者要维护账号和数据库，后者往往缺少按餐次归档、三大营养素比例和与建议摄入量对比的结构化输出。
下面介绍 SkillHub 社区 Skill「饮食记录分析」（@user_70c2f807/diet-record-analyzer）。它通过标准 SKILL.md 约束 Agent：在用户用文字描述餐食与份量时，按步骤估算热量、汇总并给出调整方向；不依赖额外 API Key，也不处理食物图片。
这是什么¶
「饮食记录分析」是社区来源（community）的 life-service 类 Skill，当前版本 1.0.0，由发布者 user_70c2f807 维护。在 SkillHub 上的展示名为「饮食记录分析」，坐标为 @user_70c2f807/diet-record-analyzer。
Skill 文档写明：在用户提到饮食记录、热量计算、吃了什么、diet tracking、calorie counting、food log，或要求追踪饮食时启用；不用于菜谱推荐、营养咨询或减肥药相关话题。
它要解决的核心问题是：用户不清楚每天大概摄入多少热量、三大营养素是否失衡，以及如何在对话里得到可读的记录与简要建议。
核心功能¶
以下能力均来自官方 SKILL.md，安装后由 Agent 按文档执行。
- 按餐次记录：根据用户文字描述的食物名称与份量，识别食物类型，估算热量并归入早餐、午餐、晚餐等餐次。
- 汇总与分析：计算各餐与全天总热量；分析碳水、蛋白质、脂肪比例；与建议摄入量对比，标出缺口或超标。
- 评价与建议：评估当日饮食质量，指出亮点与不足，给出可操作的调整方向（例如用什么食物替代），而非空泛的「少吃」。
- 交互与边界：对模糊描述、未知食物、要求精确热量或减肥方案等场景，文档提供了固定提示语与 FAQ；明确不提供医疗或减肥用药建议。
平台元数据标注 requires_api_key=false，无需单独配置 API Key。
安装与启用¶
安装 SkillHub CLI¶
若本机尚未安装 skillhub，可先检查版本；未安装时按 SkillHub 官方安装说明执行（完整安装或仅 CLI）：
command -v skillhub && skillhub --version
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。本 Skill 的安装命令为：
skillhub install diet-record-analyzer --namespace user_70c2f807 --dir <skills 目录>
常见客户端 skills 路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将 SkillHub 页面提供的提示词发给 AI，让其按 https://skillhub.cn/install/skillhub.md 安装 @user_70c2f807/diet-record-analyzer。
安装完成后，需重启或刷新对应客户端，使新 Skill 被加载。
典型用法¶
启用后，对话方式与 SKILL.md「快速开始」一致，下面为可复现的意图示例（用户侧话术）。
- 用户说「记录一下我今天吃的」→ Agent 应引导列出各餐食物与大概份量。
- 用户描述「早餐两个包子一杯豆浆，午餐一份盖饭」→ Agent 估算热量并按餐次记录。
- 用户问「今天吃了多少热量？」→ Agent 汇总当日各餐热量与营养比例。
- 用户问「我吃得健康吗？」→ Agent 分析饮食结构并指出不足与建议。
- 用户问「最近总超标怎么办？」→ Agent 分析可能原因并给出调整方向。
输出上，Skill 要求结构化呈现：按餐次的表格（食物、份量、热量、三大营养素）、当日汇总与建议摄入对比、饮食评价及营养素比例说明；所有热量需用「~」标明为估算值。
适用场景与注意¶
适合谁
- 希望在 Cursor、Claude Code 等环境里，用自然语言快速记一餐、看当日汇总，而不立刻接入专业 App 的用户。
- 需要三大营养素比例与建议值对比、而不仅是单道菜热量粗算的场景。
限制与坑（Skill 文档明确要求提前告知用户）
| 点 | 说明 |
|---|---|
| 热量为估算 | 基于通用食物数据库，烹饪方式与份量不同可能导致约 10%–30% 误差 |
| 无图片识别 | 必须由用户用文字描述食物与份量 |
| 不跨对话持久化 | 数据仅在当前对话中；长期追踪应使用专业饮食记录 App |
| 非医疗用途 | 疾病饮食、减肥方案等应咨询营养师或医生 |
SkillHub 页面统计（截至资料抓取）：下载约 875 次，分类 life-service，社区评分展示为 100000（平台计分方式以 SkillHub 为准）。
结尾¶
「饮食记录分析」把饮食记录、热量估算、营养素比例和简要建议收敛到一套 Agent 可执行的 SKILL.md 流程里，适合对话式记餐与当日复盘；长期存档、图片识菜或临床级方案仍应使用专业工具或医疗机构指导。
官方 Skill 页：https://www.skillhub.cn/skills/user_70c2f807/diet-record-analyzer
API 索引地址：https://api.skillhub.cn/user_70c2f807/diet-record-analyzer
