形體管理:在 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。

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

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

小夜