← Back to Skills Marketplace
harrylabsj

Family Nutrition Planner

by haidong · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
138
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install family-nutrition-planner
Description
家庭营养规划师 - 根据家庭成员健康需求、饮食偏好和营养目标, 生成营养均衡的一周菜单、食材采购清单和分餐计划。
README (SKILL.md)

Family Nutrition Planner / 家庭营养规划师

你是家庭营养规划师

你的任务是根据家庭成员的健康需求、饮食偏好和营养目标,生成营养均衡的一周菜单、食材采购清单和分餐计划。

产品定位

Family Nutrition Planner 是一个智能家庭饮食规划系统,覆盖:

  • 营养需求计算:基于年龄、性别、体重、身高、活动水平计算每日营养需求
  • 一周菜单生成:生成营养均衡的一周饮食计划(三餐+加餐)
  • 食材采购清单:根据菜单生成优化的分类采购清单和成本估算
  • 过敏原管理:管理食物过敏和禁忌,自动筛选安全食谱

使用场景

用户可能会说:

  • "为家庭制定一周营养计划"
  • "计算一下我家人的营养需求"
  • "生成这周的食材采购清单"
  • "帮我规划健康饮食"

输入 schema(统一需求格式)

interface NutritionPlanRequest {
  familyName?: string;         // 家庭名称(可选)
  members: FamilyMember[];
  preferences?: {
    cuisine?: string[];
    cookingStyle?: string[];
    avoid?: string[];
  };
  constraints?: {
    weeklyBudget?: number;
    maxPrepTime?: number;
    servingSize?: number;
  };
  goals?: {
    type?: "balance" | "low-carb" | "high-protein" | "weight-loss" | "muscle-gain";
    focus?: string[];
  };
}

interface FamilyMember {
  name: string;
  age: number;
  gender: "male" | "female";
  weight: number;
  height: number;
  activityLevel: "sedentary" | "lightly-active" | "moderately-active" | "very-active" | "extra-active";
  goals?: string[];
  allergies?: string[];
}

输出 schema(统一营养规划报告)

interface NutritionPlanReport {
  success: boolean;
  nutritionSummary: {
    averageDailyCalories: number;
    macronutrientBalance: { protein: string; carbohydrates: string; fat: string; };
    foodVariety: number;
  };
  dailyPlans: DailyPlan[];
  shoppingList: {
    categories: CategoryItem[];
    estimatedCost: number;
    savingsTips: string[];
  };
  nutritionAnalysis: {
    strengths: string[];
    concerns: string[];
    suggestions: string[];
  };
  weeklyNutritionTrend: string;
}

核心功能

1. 营养需求计算

基于 Mifflin-St Jeor 方程:

  • 男: BMR = 10×体重(kg) + 6.25×身高(cm) - 5×年龄 + 5
  • 女: BMR = 10×体重(kg) + 6.25×身高(cm) - 5×年龄 - 161
  • TDEE = BMR × 活动系数

2. 菜单生成规则

  • 确保每日至少使用 12 种不同食材
  • 每餐包含:主食 + 蛋白质 + 蔬菜 + 适量健康脂肪
  • 每周食材重复率 \x3C 30%

使用示例

示例1:一周营养计划

输入

家庭成员:
- 爸爸:35岁,男,75kg,175cm,轻度活动
- 妈妈:32岁,女,58kg,162cm,轻度活动
- 孩子:8岁,男,28kg,130cm,中度活动
偏好:中式家常菜,少油少盐
预算:每周500元

输出

成功生成一周营养计划!
📊 营养概览:人均每日热量1850 kcal,宏量营养素均衡
📅 周一计划:早餐420 kcal,午餐580 kcal,晚餐620 kcal
🛒 采购清单:预估成本约480元

示例2:营养需求计算

输入:30岁男性,70kg,175cm,中度活动,增肌目标

输出

📋 营养需求报告
BMR:1665 kcal
TDEE:2581 kcal
目标摄入量:2800 kcal(增肌+8.5%)
蛋白质:210g | 碳水:280g | 脂肪:93g

当前状态

  • 营养计算:stub(基于标准公式的估算)
  • 菜单生成:stub(返回预设模板菜单)
  • 采购清单:stub(基于菜单的成本估算)

自测

cd ~/.openclaw/skills/family-nutrition-planner
python scripts/test-handler.py
Usage Guidance
This skill appears internally consistent with its purpose and does not request credentials or perform network calls in the provided files. Before installing or running it: (1) review handler.py to ensure no omitted/truncated code adds network or file-exfiltration behavior (the supplied handler was truncated in the listing), (2) remove or adjust the hardcoded path in scripts/test-handler.py (it references a specific user's home directory), and (3) run the tests in an isolated environment (or inspect the implementation of handle_nutrition_request/handle_nutrition_calculation) to confirm there are no runtime errors or unexpected behavior. The package.json and small version mismatch are packaging oddities — harmless but worth cleaning up. If you need higher assurance, request the complete handler.py file (untruncated) and a brief description of any runtime logging or telemetry the author may have intended.
Capability Analysis
Type: OpenClaw Skill Name: family-nutrition-planner Version: 1.0.0 The family-nutrition-planner skill is a legitimate tool for calculating nutritional needs and generating meal plans. The code in handler.py implements standard mathematical formulas (Mifflin-St Jeor) and processes local data from JSON files without any network activity, file system access, or suspicious execution patterns. The SKILL.md instructions are strictly aligned with the stated purpose and contain no prompt-injection attempts or malicious directives.
Capability Assessment
Purpose & Capability
Name/description, data files (recipes, nutrition DB), type definitions and handler code all align with a meal-planning/nutrition calculator. The included resources and code are proportional to the stated functionality. Minor mismatch: registry version (1.0.0) vs SKILL.md version (0.1.0) and a package.json (Node metadata) alongside Python code—these are packaging inconsistencies but not security issues.
Instruction Scope
SKILL.md instructions stay on-task (calculate BMR/TDEE, generate weekly menus, shopping list, manage allergens). The self-test instructs running a local test script; that script contains a hardcoded absolute path ('/Users/jianghaidong/.openclaw/skills/...') which is a developer artifact and may not exist on other systems. No instructions ask the agent to read unrelated system files, access secrets, or contact external endpoints.
Install Mechanism
No install spec or remote downloads are present. This is an instruction/code-only skill; everything needed is included in the bundle (Python scripts and JSON data). No external packages are pulled during install.
Credentials
The skill does not declare or require any environment variables, credentials, or config paths. The code shown does not import networking libraries or attempt to read environment secrets.
Persistence & Privilege
The skill does not request persistent/always-on presence (always:false). It does not modify other skills or system-wide agent settings in the materials provided.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install family-nutrition-planner
  3. After installation, invoke the skill by name or use /family-nutrition-planner
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Family Nutrition Planner. - Supports weekly nutrition planning, menu generation, and shopping list creation based on family members' health needs and preferences. - Calculates nutrition needs using standard formulas. - Handles dietary preferences, meal variety, and allergen management. - Provides example usage and output formats.
v0.1.0
Initial release of Family Nutrition Planner. - Generates balanced weekly meal plans based on family health needs, dietary preferences, and nutrition goals. - Calculates nutritional requirements for each family member using standard formulas. - Creates detailed shopping lists with estimated costs. - Manages allergens and dietary restrictions automatically. - Provides nutrition analysis and actionable suggestions.
Metadata
Slug family-nutrition-planner
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Family Nutrition Planner?

家庭营养规划师 - 根据家庭成员健康需求、饮食偏好和营养目标, 生成营养均衡的一周菜单、食材采购清单和分餐计划。 It is an AI Agent Skill for Claude Code / OpenClaw, with 138 downloads so far.

How do I install Family Nutrition Planner?

Run "/install family-nutrition-planner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Family Nutrition Planner free?

Yes, Family Nutrition Planner is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Family Nutrition Planner support?

Family Nutrition Planner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Family Nutrition Planner?

It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.

💬 Comments