前言¶
把减脂、增肌或维持体重拆成「算热量、记每餐、看当天还剩多少」时,常见做法是单独开 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 与附带脚本,可与页面对照。
- 营养目标计算:根据身高、体重、年龄、性别、活动水平与目标类型(减脂 / 增肌 / 维持),计算 BMR、TDEE、每日目标热量及蛋白质、碳水、脂肪配额;减脂场景还可输出分阶段体重计划。
- 新用户引导:通过 6 题问卷初始化档案,由
scripts/init_profile.py校验答案,再调用scripts/nutrition_calculator.py的calculate_all()写入档案。 - 饮食记录:用户以文字描述餐次与食物(支持
,/和等分隔),scripts/diet_logger.py解析份量;命中references/food_database.json(约 60 种食物)则直接记账,未命中则由 Agent 按常识估算并标记为 AI 估算。 - 汇总与建议:按日读取
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。