# 🍳 Cook Skill — 食用手册 AI 美食助手

> 围绕「今天吃什么」的生活灵感助手，内置数百道中文家常菜谱数据库。

## 功能介绍

### 🥘 食材找菜谱

告诉 AI 你冰箱里有什么食材，它会从内置的菜谱数据库中检索匹配的菜谱，并附上 B 站视频教程链接。

- 支持模糊匹配和食材别名（如「西红柿 → 番茄」「泡面 → 方便面」）
- 标注匹配程度：「你有其中 X 样，还需要 XX」
- 可按厨具、难度、做法、标签进一步筛选
- 数据库匹配不足时，会补充通用家常菜建议

### 📅 饮食规划

帮你做一周菜单安排：

- 荤素搭配，主食轮换，不重样
- 食材复用——买一次菜用一周
- 工作日要快，周末可以花点时间
- 兼顾口味变化，不会连着几天吃同一类

### 🧠 食材知识

- **食物相克查询**：基于内置数据，理性说明影响程度，不传播谣言
- **保存方法**：什么该放冰箱、保鲜期多久、剩菜怎么处理
- **食材替代**：没有某个食材时的替代方案及口味差异

### 🍜 烹饪技巧

新手友好的实用指南：

- 调味基本比例
- 肉类腌制技巧
- 蔬菜炒制不出水
- 常见翻车避坑

### 🎯 适用场景

| 场景           | 关注点                           |
| -------------- | -------------------------------- |
| 冰箱清理日     | 不浪费，用有限食材做出好吃的     |
| 新手第一次做饭 | 失败率低、步骤少、不需复杂调料   |
| 给家人朋友做饭 | 有面子但不难做                   |
| 减脂/健康饮食  | 低油低盐、高蛋白，附热量参考     |
| 一人食         | 份量小、不浪费、做起来快         |
| 带便当         | 适合加热、不易变味、方便携带     |
| 宝宝辅食       | 新鲜安全、口味清淡、注意过敏风险 |

## 数据源

菜谱数据来自 [Cook（食用手册）](https://github.com/YunYouJun/cook) 开源项目，包含：

- **数百道家常菜谱**（含食材、难度、厨具、做法标签、B 站视频链接）
- **食物相克数据**（食物 A/B + 不宜同食原因）
- **食材/厨具分类**

Skill 自带菜谱数据（`data/` 目录），离线即可使用；数据也可通过 GitHub Raw URL 在线获取最新版本。

## 系统要求

- **支持工具**：[CodeBuddy](https://www.codebuddy.ai)（IDE 插件 / CLI）、[Claude Code](https://docs.anthropic.com/en/docs/claude-code)
- **操作系统**：macOS / Linux / Windows（任何支持上述工具的系统）
- **网络**：可选——Skill 内置菜谱数据，离线可用；联网时可获取最新数据
- **本地依赖**：无——Skill 本身是 Markdown 提示词 + CSV 数据，不需要安装任何运行时

## 安装

### 方式一：让 AI 帮你装

把下面这句话直接发给你的 AI 助手（CodeBuddy / Claude Code），它会自动完成下载、解压和安装：

> 帮我安装 cook skill：从 https://github.com/YunYouJun/cook/releases/latest/download/cook.zip 下载并解压到用户级 skills 目录

### 方式二：手动安装

1. 下载 [cook.zip](https://github.com/YunYouJun/cook/releases/latest/download/cook.zip)
2. 解压到对应工具的 Skills 目录：

| 工具                  | 用户级 Skills 目录          |
| --------------------- | --------------------------- |
| CodeBuddy (IDE / CLI) | `~/.codebuddy/skills/cook/` |
| Claude Code           | `~/.claude/skills/cook/`    |

3. 确认目录下包含 `SKILL.md` 文件即安装成功

> **项目级安装**：也可将文件解压到项目根目录下的 `.codebuddy/skills/cook/`（或 `.claude/skills/cook/`），仅对当前项目生效。

### 验证安装

安装完成后，随便跟 AI 说一句：

> 冰箱里有鸡蛋和番茄，能做什么菜？

如果 AI 开始检索菜谱数据库并给出带视频链接的推荐，说明 Skill 已生效。

## 使用方法

安装后无需任何配置，直接用自然语言对话即可。以下是一些使用示例：

### 食材找菜谱

```
家里有土豆、鸡蛋和米，能做什么？
只有电饭煲，有什么简单的菜？
冰箱里有猪肉和白菜，想做个汤
```

### 饮食规划

```
帮我安排下周的晚餐菜单，两个人吃
做个减脂餐一周计划
工作日的快手晚餐有什么推荐？
```

### 食材知识

```
虾和柠檬能一起吃吗？
牛肉怎么保存比较好？
没有料酒可以用什么代替？
```

### 烹饪技巧

```
怎么炒青菜不出水？
排骨怎么焯水？
第一次用空气炸锅，有什么注意事项？
```

## 注意事项

- **不替代专业建议**：涉及婴幼儿、孕妇、过敏体质等特殊人群时，请咨询专业医师或营养师
- **食物相克信息**：基于公开数据整理，会理性说明影响程度，不过度恐慌
- **网络可选**：Skill 内置菜谱数据，离线即可使用；联网时 CLI 或 Fallback 可获取最新数据
- **数据更新**：重新下载安装 Skill 即可获取最新菜谱数据

## 许可

[MIT](https://github.com/YunYouJun/cook/blob/main/LICENSE)