形体管理:在 Agent 里做饮食记录与营养目标管理

前言

把减脂、增肌或维持体重拆成「算热量、记每餐、看当天还剩多少」时,常见做法是单独开 App 或表格。若你已经在 Cursor、Claude Code 等环境里用对话完成任务,再切到别的工具记饮食,上下文容易断。下面介绍 SkillHub 社区 Skill「形体管理」(@user_9bf18927/body-shape-manager):用标准 SKILL.md 约定触发词与流程,配合本地 Python 脚本和 JSON/Markdown 数据文件,把档案、营养目标和每日饮食日志留在技能目录内,无需配置 API Key。

这是什么

「形体管理」是发布者 user_9bf18927 在 SkillHub 上架的社区 Skill(source: community),当前版本 1.0.0,分类为 life-service,子类为 健康管理。SkillHub 页面标注 requires_api_key=false,安装包内说明数据存放在 references/user_profile.json 与 memory/YYYY-MM-DD.md,不依赖外部服务存用户数据。

官方入口:

  • API 索引:https://api.skillhub.cn/user_9bf18927/body-shape-manager
  • 技能页:https://www.skillhub.cn/skills/user_9bf18927/body-shape-manager

核心功能

以下能力来自 1.0.0 安装包中的 SKILL.md 与附带脚本,可与页面对照。

  1. 营养目标计算:根据身高、体重、年龄、性别、活动水平与目标类型(减脂 / 增肌 / 维持),计算 BMR、TDEE、每日目标热量及蛋白质、碳水、脂肪配额;减脂场景还可输出分阶段体重计划。
  2. 新用户引导:通过 6 题问卷初始化档案,由 scripts/init_profile.py 校验答案,再调用 scripts/nutrition_calculator.py 的 calculate_all() 写入档案。
  3. 饮食记录:用户以文字描述餐次与食物(支持 , / 和 等分隔),scripts/diet_logger.py 解析份量;命中 references/food_database.json(约 60 种食物)则直接记账,未命中则由 Agent 按常识估算并标记为 AI 估算。
  4. 汇总与建议:按日读取 memory/YYYY-MM-DD.md,展示热量与三大营养素进度,并按减脂(cut)或增肌(bulk)规则生成提示(如热量缺口过大、蛋白质不足等)。

触发示例(节选):「开始形体管理」「形体管理」「记录饮食」「今天吃了 xxx」「今天吃够了吗」「想减脂」等;完整列表见包内 SKILL.md 的「触发关键词」表。

安装与启用

SkillHub 页面给出的方式是让 Agent 阅读安装说明并安装指定坐标:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_9bf18927/body-shape-manager`。

若本机已安装 skillhub CLI,可按 SkillHub 安装文档 将技能装到当前 Agent 的 skills 目录(文档要求必须带 --dir,否则默认 ./skills/ 可能不被识别):

command -v skillhub && skillhub --version

skillhub install @user_9bf18927/body-shape-manager --dir <skills 目录>

常用目录(摘自官方安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

未安装 CLI 时,可先执行文档中的安装脚本(完整安装或 --cli-only),再运行上述 install 命令。安装后按你所用客户端说明重启或刷新,使技能被加载。

典型用法

首次使用:在对话中发送「开始形体管理」或「形体管理」,按问卷依次提供身高体重、年龄、性别、活动水平、目标类型与目标体重;完成后 Agent 应展示 BMR、TDEE、每日热量与营养素目标。

记录一餐:已初始化后,可直接描述摄入,例如:

今天吃了:米饭 200g,鸡蛋 2个(每个60g),西兰花 150g,青菜200g

技能流程会解析食物、查库或 AI 估算,并输出本餐表格与当日累计占比。

查询当天进度:使用「今天吃够了吗」「我还能吃多少热量」等话术,读取当日日志并生成汇总与建议。

Agent 侧可按包内说明调用模块,例如:

from scripts.diet_logger import add_food_entry, load_today_log, format_log_summary, generate_advice

result = add_food_entry("午餐", "米饭", 200)

(实际 import 路径以技能安装后的目录结构为准。)

适用场景与注意

适合:希望在同一 Agent 对话里完成「设目标 → 记饮食 → 看当天是否达标」的个人用户;重视数据留在本地目录、且不需要额外 API Key 的场景。

注意:

  • SkillHub 列表页的简介字段为空(summary / overviewMd 未填),能力细节以安装包内 SKILL.md 为准。
  • 未收录在 food_database.json 的食物依赖 Agent 估算,营养数值仅供参考,不能替代专业医疗或营养师建议。
  • 页面统计(截至抓取):下载 1035 次、安装 1 次;SkillHub 评分字段为 100000。安全扫描在技能页显示为「安全,无风险」(Keen / 三不)。
  • CLI 安装时请使用带 @ 的坐标 @user_9bf18927/body-shape-manager;仅写 user_9bf18927/body-shape-manager 可能导致远程下载失败。

结尾

「形体管理」把体型相关的计算、记账和建议写成可复用的 Agent Skill 流程,并用本地 JSON 与按日 Markdown 持久化进度。若你要从 SkillHub 获取 1.0.0 包或复制安装提示词,可打开官方技能页:https://www.skillhub.cn/skills/user_9bf18927/body-shape-manager。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜