Back to Details

k2f-menu

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

K2F Menu — AI-Native Aesthetic Design

K2F Menu — AI 原生美学设计

Purpose

用途

Teach agents to author 
content_and_design.md
for hospitality menus: category and item structure, inclusion cuts, and aesthetic intent (tone, hierarchy, density)—not K2F packaging or export.
指导 Agent 编写用于餐饮菜单的 
content_and_design.md
：涵盖分类与条目结构、内容取舍和美学意图（基调、层级、信息密度），而非 K2F 打包或导出。

Built on K2F

基于 K2F

This skill produces menus as 
.K2F
packages. Follow the k2f skill for authoring: unpack or init a workspace, edit the semantic tree, pack/verify, and export. K2F keeps agents on meaning (sections, dishes, prices, dietary notes)—not pixel coordinates—while the engine compiles layout, typography, and theme into consistent output across PDF and other formats.
Before you build, install the core skill: 
npx skills add suzheng/k2f --skill k2f
.
此 skill 会将菜单生成为 
.K2F
包。编写时请遵循 k2f skill：解包或初始化工作区，编辑语义树，执行打包/验证并导出。K2F 让 Agent 专注于含义（章节、菜品、价格、饮食提示），而不是像素坐标；引擎则将布局、排版和主题编译为一致的输出，适配 PDF 及其他格式。
开始构建前，安装核心 skill：
npx skills add suzheng/k2f --skill k2f
。

When to Use

何时使用

  • Restaurants, cafés, bars, bakeries, food trucks, hotels, catering, or private dining.
  • Boards, folded inserts, food/drink splits, wine or cocktail lists, kids or brunch add-ons.
  • Print or digital PDF—not full websites or POS exports.
  • 餐厅、咖啡馆、酒吧、面包店、餐车、酒店、宴会服务或私人餐饮。
  • 看板、折页插页、食品/饮品分栏、酒单或鸡尾酒单、儿童或早午餐附加页。
  • 印刷或数字 PDF——而非完整网站或 POS 导出。

Workflow

工作流

Step 1. Generate the content_and_design.md

第 1 步：生成 content_and_design.md

One blueprint pairing information architecture with design intent. Long menus: one file per major section slug (e.g. 
content_and_design_mains.md
).
Sub-steps
  1. Menu lock — Venue type, service style, daypart, language(s), currency, brand constraints. Guest job: pick a dish or drink quickly while seated or at a board.
  2. Section map — Order categories as guests decide (starters → mains → desserts → drinks, or bar-first). Label each Open, Featured (2–6 heroes), or Omit (verbal, QR, other card). Split food/drinks or lunch/dinner when one scan path fails.
  3. Item anatomy — Consistent fields: Name, Description (length scales with venue), Price (one grammar site-wide), Tags (only user-supplied or required), Modifiers (sizes, add-ons) nested under one parent—not duplicate dishes.
  4. Content tiers — Identity (name, logo direction), Navigation (section titles), Catalog (items + prices), Guidance (one short chef or pairing note max), Compliance (allergens, service charge). Keep essays out of Catalog.
  5. Genre fit — Fine dining: brevity, seasonal focus. Casual: moderate density, combos. Bar/wine: column-friendly; glass | bottle. Hotel/catering: packages, per-person lines, tray or service notes in Compliance.
  6. Cut pass — Drop duplicates, unpriced market items without confirmation, mismatched price formats, and naming inconsistency within sections.
  7. Design intent (no coordinates) — Tone: one adjective pair from cuisine/venue cues. Hierarchy: sections > item names > descriptions; prices in one scan band (column or dot leaders). Density: board vs booklet vs fine dining whitespace; note two-column intent for bar lists. Brand: contrast on photos/dark boards (panel intent); 2–3 colors; display vs detail roles. Channel: print header scale vs mobile PDF section breaks.
Rules & constraints
  • Prices and names scannable within ~10 s per section.
  • One price grammar; each dish listed once.
  • No invented dishes, prices, or allergen claims; label placeholders.
  • Compliance stays short unless the user requires more.
Common failure modes
FailureFix
Flyer creepPromos → separate flyer; menu = Identity + Catalog.
Adjective wallsOne description line; move story to Guidance.
Price chaosUnify format; state alignment intent.
Category soupMerge small sections; Featured for orphans.
Website pasteStrip nav/SEO; keep menu tiers only.
Quality checklist
  • Menu lock and guest job; section map with Open/Featured/Omit.
  • Item anatomy + unified prices; tiers assigned.
  • Genre density; design intent (tone, hierarchy, density, channel).
  • Facts traceable to user input; placeholders marked.
生成一份将信息架构与设计意图配对的蓝图。长菜单：每个主要章节 slug 使用一个文件（例如 
content_and_design_mains.md
）。
子步骤
  1. 菜单锁定——场所类型、服务形式、时段、语言、货币、品牌约束。顾客任务：坐着或看板时快速挑选一道菜或一杯饮品。
  2. 分区图——按顾客做选择时的顺序安排分类（前菜 → 主菜 → 甜点 → 饮品，或优先展示酒水）。将每个分类标记为 开放（Open）、精选（Featured）（2–6 个明星菜品）或省略（Omit）（通过口头、QR 或其他卡片提供）。当单一浏览路径无法奏效时，拆分食品/饮品或午餐/晚餐。
  3. 条目结构——统一字段：名称、描述（长度随场所类型调整）、价格（全站使用一种价格语法）、标签（仅使用用户提供或必须包含的信息）、可选项（尺寸、附加项）嵌套在同一个父项下——不要重复菜品。
  4. 内容层级——标识（Identity）（名称、logo 方向）、导航（Navigation）（章节标题）、目录（Catalog）（条目与价格）、引导（Guidance）（最多一条简短的主厨或搭配说明）、合规（Compliance）（过敏原、服务费）。不要在 Catalog 中加入长篇论述。
  5. 类型适配——精致餐饮：简洁、突出时令。休闲餐饮：适中密度、套餐组合。酒吧/酒单：适合分栏；杯装 | 瓶装。酒店/宴会：套餐、每人计价项目，并在 Compliance 中注明托盘或服务说明。
  6. 删减检查——删除重复项、未经确认且未标价的市价商品、格式不一致的价格，以及同一章节内命名不一致的条目。
  7. 设计意图（不涉及坐标）——基调（Tone）：从菜系/场所线索中选一对形容词。层级（Hierarchy）：章节 > 条目名称 > 描述；价格处于同一扫读带（分栏或点状引导线）。密度（Density）：区分看板、册页或精致餐饮的留白；注明酒单的双栏意图。品牌（Brand）：在照片/深色看板上形成对比（面板意图）；使用 2–3 种颜色；区分展示角色与详情角色。渠道（Channel）：印刷页眉尺度与移动端 PDF 分节方式。
规则与约束
  • 每个章节内的价格和名称应能在约 10 秒内扫读完毕。
  • 使用一种价格语法；每道菜仅列出一次。
  • 不虚构菜品、价格或过敏原声明；为占位信息添加标签。
  • 除非用户要求更多内容，否则 Compliance 应保持简短。
常见失败模式
失败模式修复方式
宣传单化促销内容 → 单独制作宣传单；菜单 = Identity + Catalog。
形容词堆砌每项只保留一行描述；将故事移至 Guidance。
价格混乱统一格式；说明对齐意图。
分类混杂合并过小的章节；将零散条目归入 Featured。
网站内容粘贴删除导航/SEO；仅保留菜单层级。
质量检查清单
  • 菜单锁定与顾客任务；分区图包含 Open/Featured/Omit。
  • 条目结构与统一价格；已分配内容层级。
  • 类型密度；设计意图（基调、层级、密度、渠道）。
  • 事实可追溯至用户输入；占位符已标记。

Step 2. Use the content_and_design.md and k2f skill to generate a K2F file and export to an appropriate file format.

第 2 步：使用 content_and_design.md 和 k2f skill 生成 K2F 文件，并导出为适当格式

Follow k2f to map the blueprint into the semantic tree, apply theme roles from design intent, verify, and export (typically PDF).
遵循 k2f 将蓝图映射到语义树，根据设计意图应用主题角色，进行验证并导出（通常为 PDF）。