Skip to content

jasonbai/howtocook

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
data
data
 
 
references
references
 
 
scripts
scripts
 
 
README.md
README.md
 
 
SKILL.md
SKILL.md
 
 

Repository files navigation

HowToCook - 智能菜谱推荐与烹饪指导助手

一个专为家庭烹饪者设计的 Claude Code 技能，基于 357+ 精选家常菜谱，提供智能菜谱推荐、详细烹饪指导和多人用餐菜单规划功能。

功能介绍

这个技能帮助解决日常烹饪中的三大难题：吃什么、怎么做、怎么安排。它适合从烹饪新手到家庭厨师的所有水平，内置来自 HowToCook 项目 的丰富菜谱数据库。

设计理念

这个技能基于以下信念：

💡 选择比搜索更重要

通过智能推荐和交互式问题收集，帮助用户快速找到合适的菜谱，而不是在海量数据中迷失。

🎯 细节决定成败

提供详尽的步骤说明和实用小贴士，确保烹饪成功。

⚖️ 平衡是关键

菜单规划注重荤素搭配、营养均衡和肉类多样性。

🚀 简单开始，逐步提升

从简单菜谱开始，让新手建立信心，逐步挑战更高难度。

🏠 实用至上

所有菜谱都是家常菜，使用常见食材和调料，易于实现。

核心功能

  • 🤖 智能菜谱推荐 — 根据场景、时间、难度、偏好多维度推荐菜谱
  • 📖 详细烹饪指导 — 提供完整的食材清单、分步步骤和实用小贴士
  • 🍽️ 菜单规划系统 — 为多人用餐自动规划营养均衡的菜单
  • 🔍 快速菜谱查询 — 支持模糊搜索，快速找到想要的做法
  • 🥗 配菜智能建议 — 基于已选菜品推荐互补的配菜

核心特点

📊 精准的菜谱分类

  • 10 大分类：荤菜、素菜、汤品、主食、水产、早餐、甜品、饮品、酱料、半成品
  • 9 级难度：从 ★ (极简单) 到 ★★★★★★★★★ (大师级)
  • 智能时间估算：根据难度自动预估烹饪时间（5-120分钟）

🎚️ 多维度智能筛选

可根据以下条件智能筛选菜谱：

  • 用餐场景：早餐、午餐、晚餐、夜宵
  • 时间限制：5-10分钟、10-20分钟、20-40分钟、40分钟以上
  • 厨艺水平：新手、进阶、熟练
  • 菜品偏好：荤菜、素菜、汤品、主食等

🧮 专业的菜单规划算法

内置智能菜单规划系统：

菜的数量 = 人数 + 1
荤菜数 = ceil((人数 + 1) / 2)
素菜数 = floor((人数 + 1) / 2)

特殊规则支持：

  • 8人以上：自动增加水产类
  • 有儿童：增加甜味菜
  • 肉类多样性：避免重复使用同一种肉类
  • 肉类优先级：猪肉 → 鸡肉 → 牛肉 → 羊肉 → 鸭肉 → 鱼肉

⚡ 高性能搜索

  • 索引化搜索，查询速度 < 1秒
  • 支持模糊匹配菜名
  • 多条件组合筛选
  • 自动检测肉类类型，确保菜单多样性

最佳实践

💡 推荐使用场景

  1. 日常用餐规划 — 每天不知道做什么菜时使用菜谱推荐
  2. 周末聚餐 — 使用菜单规划功能，为客人准备丰盛餐食
  3. 学习新菜 — 查询不熟悉的菜谱，学习新的烹饪技巧
  4. 快手菜选择 — 时间紧张时，筛选低难度、短时间的菜谱

📝 使用技巧

  1. 善用模糊搜索 — 输入部分菜名即可，如"西红柿"可匹配"西红柿炒鸡蛋"
  2. 组合筛选条件 — 可以同时限制时间、难度和分类
  3. 查看配菜建议 — 选中主菜后，可以询问推荐的配菜
  4. 注意小贴士 — 菜谱最后的小贴士包含实用技巧和变体做法

使用方法

场景 1：菜谱推荐 🍴

/howtocook

> "今天晚餐吃什么？"

技能将：

  1. 使用交互式问题收集你的偏好（用餐时间、时间限制、厨艺水平、菜品类型）
  2. 根据你的选择智能筛选菜谱
  3. 展示 3-5 道匹配的菜谱（紧凑格式）
  4. 你可以输入菜名查看详细做法

示例输出：

根据你的需求，推荐以下菜谱：

📍 西红柿炒鸡蛋 | 素菜 | 难度:★★ | 约20分钟
📍 酸辣土豆丝 | 素菜 | 难度:★★ | 约20分钟
📍 蒜蓉西兰花 | 素菜 | 难度:★★ | 约20分钟
📍 手撕包菜 | 素菜 | 难度:★★ | 约20分钟
📍 凉拌黄瓜 | 素菜 | 难度:★ | 约10分钟

输入菜名可查看详细做法 👆

场景 2：菜谱查询 🔍

/howtocook

> "怎么做红烧肉？"
> "可乐鸡翅怎么做？"
> "查一下西红柿炒鸡蛋的做法"

技能将：

  1. 直接搜索目标菜谱
  2. 展示完整的菜谱详情（食材、步骤、小贴士）
  3. 提供难度、时间预估和烹饪建议

示例输出：

# 西红柿炒鸡蛋

**难度等级:** ★★
**分类:** 素菜
**预估时间:** 约 20 分钟

**简介:**
西红柿炒蛋是中国家常几乎最常见的一道菜肴...

**食材:**
  - 西红柿
  - 鸡蛋
  - 食用油
  - 盐
  - 糖（可选）
  - 葱花（可选）

**制作步骤:**
  1. 西红柿洗净，去蒂，切成边长不超过 4cm 的小块
  2. 将鸡蛋打入碗中，加入盐，搅匀
  3. 热锅，加入食用油
  4. 油热后，倒入鸡蛋液。翻炒至鸡蛋结为固体且颜色微微发黄
  5. 关火。将鸡蛋盛盘，重新开火
  6. 加入西红柿块，锅铲拍打并翻炒 20 秒
  7. 向锅中加入鸡蛋，翻炒均匀
  8. 加入剩余的盐、糖（可选）、葱花（可选），翻炒均匀
  9. 关火，盛盘

**小贴士:**
  - 可以考虑向鸡蛋中加入 1ml 醋，这可以去除腥味
  - 可以考虑加入 10ml 番茄酱和 50ml 清水，增加汤汁
  - 快速做法：直接在有半熟鸡蛋的锅中加入西红柿块

场景 3：菜单规划 📋

/howtocook

> "明天有4个客人来吃饭，帮我规划一下"
> "帮6个人规划聚餐菜单"

技能将：

  1. 收集用餐场景和偏好信息
  2. 应用菜单规划算法
  3. 确保荤素搭配合理
  4. 保证肉类多样性
  5. 展示组织良好的菜单

示例输出：

# 🍽️ 推荐菜单

## 🥩 荤菜
- 📍 红烧肉 | 荤菜 | 难度:★★★ | 约35分钟
- 📍 宫保鸡丁 | 荤菜 | 难度:★★★ | 约35分钟
- 📍 糖醋排骨 | 荤菜 | 难度:★★★ | 约35分钟

## 🥬 素菜
- 📍 西红柿炒鸡蛋 | 素菜 | 难度:★★ | 约20分钟
- 📍 酸辣土豆丝 | 素菜 | 难度:★★ | 约20分钟

**总计: 5 道菜**

*💡 输入菜名可查看详细做法*

菜谱数据库

📊 数据统计

  • 总菜谱数：356 道
  • 数据来源：HowToCook 项目
  • 分类覆盖：10 大类别
  • 难度范围：9 个等级

📑 分类分布

分类 数量 示例菜谱
🥩 荤菜 103 红烧肉、宫保鸡丁、糖醋排骨
🥬 素菜 60 西红柿炒鸡蛋、酸辣土豆丝、蒜蓉西兰花
🍜 主食 58 炒米饭、意面、煎饼
🐟 水产 27 红烧鱼、清蒸鲈鱼
🌅 早餐 25 牛奶面包、煎蛋
🥤 饮品 23 各类饮品
🍲 汤品 22 西红柿豆腐汤羹、紫菜蛋花汤
🍮 甜品 19 拔丝土豆、清蒸南瓜
📦 半成品 10 基础食材处理
🧂 酱料 9 自制酱料

⭐ 难度分布

难度 星级 数量 预估时间
极简单 ★ 33 5 分钟
新手友好 ★★ 88 10 分钟
简单 ★★★ 126 20 分钟
中等 ★★★★ 86 35 分钟
进阶 ★★★★★ 23 50 分钟
困难 ★★★★★★ - 60 分钟
较难 ★★★★★★★ - 75 分钟
很难 ★★★★★★★★ - 90 分钟
大师级 ★★★★★★★★★ - 120 分钟

输出格式说明

📋 紧凑格式（推荐列表）

用于展示多个菜谱选项，简洁明了：

📍 菜名 | 分类 | 难度:X级 | 约X分钟

📖 详细格式（菜谱详情）

用于展示完整菜谱，包含：

  • 菜名、难度、分类、预估时间
  • 简介（如有）
  • 食材清单
  • 制作步骤（编号列表）
  • 小贴士（烹饪技巧和变体建议）

适用场景

  • ✅ 家庭日常烹饪 — 日常三餐规划
  • ✅ 聚会宴请菜单规划 — 为客人准备丰盛餐食
  • ✅ 烹饪新手学习 — 从零开始学习烹饪
  • ✅ 菜谱查询和参考 — 快速查找具体菜谱
  • ✅ 营养搭配建议 — 荤素搭配、营养均衡
  • ✅ 快手菜选择 — 时间紧张时的快速选择

安装

对于 Claude Code 用户

方法 1：直接克隆仓库（推荐）

# 克隆整个技能目录到 Claude Code 技能目录
git clone https://github.com/你的用户名/howtocook.git ~/.claude/skills/howtocook

方法 2：手动复制

# 创建技能目录
mkdir -p ~/.claude/skills/howtocook

# 复制整个项目内容（包括 SKILL.md、scripts/、data/、references/）
cp -r /path/to/howtocook/* ~/.claude/skills/howtocook/

验证安装

安装完成后，确认以下文件结构：

~/.claude/skills/howtocook/
├── SKILL.md                    # 主技能文件
├── README.md                   # 说明文档
├── scripts/
│   ├── __init__.py            # Python 包初始化
│   ├── recipe_parser.py       # 菜谱解析器
│   ├── recipe_search.py       # 菜谱搜索引擎
│   └── menu_planner.py        # 菜单规划算法
├── data/
│   └── dishes/                # 356+ 个菜谱文件
└── references/
    └── recipe_index.json      # 菜谱索引缓存

然后在 Claude Code 中输入 /howtocook 即可使用。

系统要求

  • Claude Code CLI
  • Python 3.6+
  • 无需额外依赖（仅使用 Python 标准库）

技术架构

📁 技能结构

~/.claude/skills/howtocook/
├── SKILL.md                    # 主技能文件（工作流程和指令）
├── README.md                   # 说明文档
├── scripts/
│   ├── __init__.py            # 包初始化
│   ├── recipe_parser.py       # Markdown 菜谱解析器
│   ├── recipe_search.py       # 菜谱搜索引擎（带索引）
│   └── menu_planner.py        # 菜单规划算法
└── data/dishes/               # 菜谱数据库
    ├── meat_dish/             # 荤菜
    ├── vegetable_dish/        # 素菜
    ├── soup/                  # 汤品
    └── ...                    # 其他分类

⚡ 性能指标

  • 索引构建：约 2 秒（一次性，缓存后复用）
  • 搜索查询：< 1 秒
  • 菜单生成：< 1 秒
  • 菜谱解析：实时处理

致谢

  • 数据来源：HowToCook 项目 by Anduin2017
  • 创建者：@Jasonbai 使用 Claude Code 创建
  • 适用对象：所有热爱烹饪的家庭厨师

许可证

MIT — 自由使用、修改和分享。

🎉 开始使用

在 Claude Code 中输入 /howtocook，开始你的智能烹饪之旅！

试试这些问题：

  • 🍴 "今天晚餐吃什么？"
  • 🥘 "怎么做红烧肉？"
  • 📋 "帮我规划6个人的聚餐菜单"
  • 🥬 "有什么简单易做的素菜推荐？"
  • 👥 "来客人了怎么安排菜单？"

About

程序员在家做饭方法指南 Skill版

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages