weekly-menu

name

weekly-menu

description

Generate a weekly meal plan with images, recipes, and shopping lists. Searches Xiaohongshu (小红书) for trending seasonal recipes, creates a beautifully formatted Feishu document with photos, source links, headings (for table of contents navigation), and checkboxes, and stores it in the receipts folder. Default: 20 dishes across 6 categories. Use when: user asks for meal planning, weekly menu, "出菜单", "这周吃什么", "推荐菜", "下周菜单", or any food/cooking planning request.

Weekly Menu Skill

Generate a weekly meal recommendation document with images and Xiaohongshu source links, stored as a Feishu doc in the receipts folder.

Prerequisites

• agent-reach skill installed (Xiaohongshu channel configured)
• Feishu channel configured with permissions: docx:document, docx:document:create, drive:drive
• User profile at meals/profile.yaml (see references/profile-template.yaml)

Workflow

1. Load User Profile

Read meals/profile.yaml for:

• location — determines seasonal ingredients
• household.portions — serving size
• cooking.equipment — available appliances (air fryer, pressure cooker, etc.)
• cooking.timeAvailable — quick/moderate/slow
• cooking.spiceTolerance — none/mild/medium-hot/hot
• preferences.cuisinesFavourite — preferred cuisines
• preferences.explorationLevel — conservative/adventurous
• schedule.cookingDays — how many days per week

If profile doesn't exist, ask user the basics and create one from references/profile-template.yaml.

2. Search for Recipe Inspiration

Use agent-reach Xiaohongshu search to find trending recipes:

mcporter call 'xiaohongshu.search_feeds(keyword: "<search_term>")'

Search strategy (3-5 searches):

• Current season + location + "时令菜"
• Equipment-specific: "空气炸锅 家常菜", "高压锅 菜谱"
• Cuisine preference: "川菜 家常", "苏菜 做法"
• General: "一周菜谱 简单好吃"

Pick the top results by likes/collects. Aim for 20 candidate dishes across 6 categories:

• 🌿 春季时令 (seasonal)
• 🔥 空气炸锅 (air fryer)
• 🍲 高压锅硬菜 (pressure cooker)
• 🌶️ 下饭菜 (rice killers)
• 🏠 经典家常 (classic home cooking)
• 🍳 快手 & 主食 (quick meals & staples)

3. Compose the Menu

Organize 20 dishes into 6 themed sections based on equipment, cuisine, and cooking method:

• Balance variety: don't repeat proteins or methods within a section
• Each dish needs: number (①-⑳), name, one-line description, cooking time, equipment used

4. Download Dish Images

Download a representative image for each dish (from Unsplash or similar free sources — Xiaohongshu CDN blocks direct downloads):

curl -sL --connect-timeout 10 --max-time 20 -o ./tmp/dishes/01-name.jpg "<url>"

Store in workspace/tmp/dishes/. Verify each file is a valid JPEG/PNG (not empty or HTML error).

5. Create Feishu Document

Read references/feishu-doc-recipe.md for the full Feishu API procedure.

Summary:

1. Create doc with title 🍽️ YYYY-MM-DD 推荐菜单 (Monday's date) in receipts folder
2. Grant user full_access permission
3. Insert blocks in ≤50-block batches. For each dish, create these blocks in order:
   • heading3 (block_type 5) — dish name, enables table of contents navigation
   • todo/checkbox (block_type 17, done: false) — same dish name, for user to check off
   • text (block_type 2) — description + cooking time
   • empty image (block_type 27) — placeholder, filled later
   • text with link — "📌 小红书菜谱" linking to XHS post
4. After all text blocks inserted, fill images: upload to drive → patch with replace_image
5. Sections separated by divider (block_type 22) + heading2 (block_type 4)

Key constraints:

• Max 50 blocks per insert call — split 20 dishes into 4 batches (~25 blocks each)
• Max 3 edits/second per document — use time.sleep(0.4) between API calls
• Image blocks must be created empty ({"block_type": 27, "image": {}}) then filled via patch
• Insert batches bottom-to-top when adding blocks to avoid index shifting

6. Share Result

Send the document link to the user in chat. Format:

🍽️ 本周菜单已出炉！20 道菜已备好

👉 <document_url>

打开文档，从目录浏览所有菜，勾选你想做的～

7. Update History

Append the week's menu to meals/history.yaml for future reference and to avoid repeats.

Config

Key	Location	Description
User profile	meals/profile.yaml	Taste preferences and constraints
Receipts folder	Feishu drive	Token stored in MEMORY.md
Meal history	meals/history.yaml	Past menus to avoid repeats

File References

• references/profile-template.yaml — blank user profile template
• references/feishu-doc-recipe.md — step-by-step Feishu document creation API guide