Skip to content

yzsp-studio/mediakit-shared-suite / creative-design

creative-design

Unverified

当用户要求从零生成或设计商业、品牌、社交媒体及知识表达类创意图片,编辑、复刻或审查已有视觉成品,或进行系列延展、多比例适配、多资产视觉系统设计时使用。触发任务包括做图、出图、生成图片、设计海报、主视觉/KV、Banner、封面、社媒配图、社媒长图、电商主图、详情页、产品图、Logo、IP 角色、吉祥物、包装、品牌应用物料、活动物料、宣传册、落地页、知识科普海报、信息图、教学图、教材插图、课件配图、思维导图、知识图谱、流程图、数据图表、科学结构图、公式推导图、工程图纸,以及分图层 HTML/CSS 视觉设计。

FileKindSize
SKILL.mdskill md74.3 KB
assets/fonts/catalogs/chinese.jsonconfig215.8 KB
assets/fonts/catalogs/latin.jsonconfig995.0 KB
assets/fonts/catalogs/multilingual.jsonconfig580.6 KB
assets/fonts/font-cdn-manifest.jsonconfig1.9 KB
assets/fonts/font-curated-pool.jsonconfig689.8 KB
assets/fonts/web-font-manifest.jsonconfig194.4 KB
assets/svg/binder-clip.svgother280 B
assets/svg/catalog.jsonconfig10.0 KB
assets/svg/folder-bottom-left.svgother98 B
assets/svg/folder-bottom-right.svgother97 B
assets/svg/folder-slope.svgother151 B
assets/svg/folder-top-left.svgother96 B
assets/svg/folder-top-right.svgother96 B
assets/svg/frosted-grain.svgother540 B
assets/svg/invite-ceremony-mask.svgother227 B
assets/svg/invite-wave-mask.svgother182 B
assets/svg/paper-fiber.svgother23.5 KB
assets/svg/paper-torn.svgother2.1 KB
assets/svg/plastic-grain.svgother538 B
assets/svg/resume-3899116ad59e17.svgother288 B
assets/svg/resume-c0728a36f2c5ec.svgother258 B
assets/svg/resume-f932e5fdcc7fcc.svgother222 B
assets/svg/retro-worn-ink.svgother18.1 KB
assets/svg/route-s.svgother271 B
assets/svg/screen-grain.svgother270 B
assets/svg/text-arc.svgother365 B
assets/templates/.gitkeepother1 B
assets/templates/css/README.mdmarkdown48.9 KB
assets/templates/css/catalog.jsonconfig240.5 KB
assets/templates/css/colors/bright-and-playful.mdmarkdown2.7 KB
assets/templates/css/colors/calm-and-rational.mdmarkdown6.6 KB
assets/templates/css/colors/fresh-and-natural.mdmarkdown3.4 KB
assets/templates/css/colors/high-contrast-pop.mdmarkdown3.8 KB
assets/templates/css/colors/palettes.mdmarkdown12.9 KB
assets/templates/css/colors/rich-and-retro.mdmarkdown7.5 KB
assets/templates/css/colors/soft-and-muted.mdmarkdown2.1 KB
assets/templates/css/combinations/beverage-sensory-longpage.htmlother15.1 KB
assets/templates/css/combinations/blue-silver-concert-longpage.htmlother55.4 KB
assets/templates/css/combinations/blue-silver-prize-console.htmlother41.8 KB
assets/templates/css/combinations/blue-silver-roster-ticket.htmlother41.1 KB
assets/templates/css/combinations/botanical-four-zone-spread.htmlother2.0 KB
assets/templates/css/combinations/botanical-tea-panel-suite.htmlother1.6 KB
assets/templates/css/combinations/clay-citywalk-longpage.htmlother26.1 KB
assets/templates/css/combinations/dark-editorial.htmlother822 B
assets/templates/css/combinations/food-sensory-templates.htmlother23.6 KB
assets/templates/css/combinations/interior-cut-window-spread.htmlother828 B
assets/templates/css/combinations/material-recipes.htmlother59.1 KB
assets/templates/css/combinations/pink-party-level-heading.htmlother30.7 KB
assets/templates/css/combinations/pink-party-linked-stages.htmlother30.8 KB
assets/templates/css/combinations/pink-party-longpage.htmlother40.7 KB
assets/templates/css/combinations/pink-party-window.htmlother30.8 KB
assets/templates/css/combinations/recipes.mdmarkdown945.4 KB
assets/templates/css/combinations/red-conference-spread.htmlother2.0 KB
assets/templates/css/combinations/resume-reference-01.htmlother2.7 KB
assets/templates/css/combinations/resume-reference-02.htmlother4.0 KB
assets/templates/css/combinations/resume-reference-03.htmlother5.3 KB
assets/templates/css/combinations/resume-reference-04.htmlother1.8 KB
assets/templates/css/combinations/resume-reference-05.htmlother5.6 KB
assets/templates/css/combinations/resume-reference-06.htmlother4.3 KB
assets/templates/css/combinations/resume-reference-07.htmlother4.4 KB
assets/templates/css/combinations/resume-reference-08.htmlother3.2 KB
assets/templates/css/combinations/resume-reference-09.htmlother6.7 KB
assets/templates/css/combinations/resume-reference-10.htmlother5.8 KB
assets/templates/css/combinations/resume-reference-11.htmlother6.5 KB
assets/templates/css/combinations/resume-reference-12.htmlother5.8 KB
assets/templates/css/combinations/resume-reference-13.htmlother6.7 KB
assets/templates/css/combinations/resume-reference-14.htmlother14.0 KB
assets/templates/css/combinations/resume-reference-15.htmlother18.6 KB
assets/templates/css/combinations/resume-reference-16.htmlother16.7 KB
assets/templates/css/combinations/ribbon-image-group.htmlother2.1 KB
assets/templates/css/combinations/sport-longpage-templates.htmlother31.0 KB
assets/templates/css/layouts/airy-and-spacious.mdmarkdown1.5 KB
assets/templates/css/layouts/asymmetric-balance.mdmarkdown19.4 KB
assets/templates/css/layouts/brochure-and-booklet-layouts.mdmarkdown38.7 KB
assets/templates/css/layouts/carousel-content-pages.mdmarkdown10.9 KB
assets/templates/css/layouts/continuous-flow.mdmarkdown17.5 KB
assets/templates/css/layouts/fold-full-page.mdmarkdown21.6 KB
assets/templates/css/layouts/fold-pages/botanical.htmlother38.8 KB
assets/templates/css/layouts/fold-pages/care.htmlother36.7 KB
assets/templates/css/layouts/fold-pages/conference.htmlother37.0 KB
assets/templates/css/layouts/fold-pages/floral.htmlother14.5 KB
assets/templates/css/layouts/fold-pages/interior.htmlother13.7 KB
assets/templates/css/layouts/fold-pages/panel-view.htmlother562 B
assets/templates/css/layouts/fold-pages/tea.htmlother31.3 KB
assets/templates/css/layouts/grid-and-alignment.mdmarkdown31.1 KB
assets/templates/css/layouts/hero-focus.mdmarkdown8.2 KB
assets/templates/css/layouts/layout-and-type.mdmarkdown24.3 KB
assets/templates/css/layouts/notice-and-invitation.mdmarkdown9.3 KB
assets/templates/css/layouts/overlap-and-collage.mdmarkdown12.9 KB
assets/templates/css/layouts/resume-full-page.mdmarkdown52.1 KB
assets/templates/css/layouts/resume-pages/01.htmlother14.9 KB
assets/templates/css/layouts/resume-pages/02.htmlother13.3 KB
assets/templates/css/layouts/resume-pages/03.htmlother24.2 KB
assets/templates/css/layouts/resume-pages/04.htmlother9.9 KB
assets/templates/css/layouts/resume-pages/05.htmlother17.9 KB
assets/templates/css/layouts/resume-pages/06.htmlother16.4 KB
assets/templates/css/layouts/resume-pages/07.htmlother21.6 KB
assets/templates/css/layouts/resume-pages/08.htmlother14.0 KB
assets/templates/css/layouts/resume-pages/09.htmlother26.7 KB
assets/templates/css/layouts/resume-pages/10.htmlother23.6 KB
assets/templates/css/layouts/resume-pages/11.htmlother21.9 KB
assets/templates/css/layouts/resume-pages/12.htmlother20.5 KB
assets/templates/css/layouts/resume-pages/13.htmlother29.3 KB
assets/templates/css/layouts/spread-relations.mdmarkdown10.8 KB
assets/templates/css/shapes/capsules-and-badges.mdmarkdown6.0 KB
assets/templates/css/shapes/cards-and-panels.mdmarkdown46.4 KB
assets/templates/css/shapes/containers.mdmarkdown2.2 KB
assets/templates/css/shapes/notes-and-paper.mdmarkdown12.7 KB
assets/templates/css/shapes/organic-shapes.mdmarkdown11.8 KB
assets/templates/css/shapes/tabs-and-folders.mdmarkdown6.7 KB
assets/templates/css/shapes/tickets-and-notches.mdmarkdown8.6 KB
assets/templates/css/surfaces/craft-detail.mdmarkdown14.1 KB
assets/templates/css/surfaces/diffuse-light.mdmarkdown14.0 KB
assets/templates/css/surfaces/glass-and-frost.mdmarkdown6.3 KB
assets/templates/css/surfaces/materials.mdmarkdown12.3 KB
assets/templates/css/surfaces/metal-and-relief.mdmarkdown2.9 KB
assets/templates/css/surfaces/paper-and-print.mdmarkdown17.8 KB
assets/templates/css/surfaces/plastic-and-gel.mdmarkdown927 B
assets/templates/css/surfaces/textile-and-craft.mdmarkdown2.9 KB
assets/templates/ref-bindings.jsonconfig18.5 KB
docs/superpowers/plans/2026-09-17-ecommerce-color-palette-expansion.mdmarkdown6.0 KB
docs/superpowers/specs/2026-09-17-ecommerce-color-palette-expansion-design.mdmarkdown5.4 KB
example/asset-manifest.mdmarkdown3.0 KB
example/brief.mdmarkdown25.3 KB
example/create-HTML.xmlconfig274 B
example/html-validation.htmlother2.1 KB
references/cli/README.mdmarkdown12.3 KB
references/cli/create-batch.mdmarkdown7.2 KB
references/cli/create.mdmarkdown8.5 KB
references/cli/get-workspace.mdmarkdown2.3 KB
references/cli/get.mdmarkdown4.0 KB
references/cli/ls.mdmarkdown2.1 KB
references/cli/tree.mdmarkdown1.9 KB
references/cli/update-batch.mdmarkdown4.7 KB
references/cli/update.mdmarkdown3.9 KB
references/cli/workspace-create.mdmarkdown2.5 KB
references/html/coding-rendering.mdmarkdown16.2 KB
references/items/HTML.mdmarkdown4.5 KB
references/items/README.mdmarkdown9.1 KB
references/items/fonts.mdmarkdown7.2 KB
references/items/image.mdmarkdown2.5 KB
references/items/line.mdmarkdown5.1 KB
references/items/shape.mdmarkdown7.4 KB
references/items/text.mdmarkdown4.6 KB
references/items/video.mdmarkdown1.5 KB
references/rendering/font-family-library.mdmarkdown14.6 KB
references/rendering/font-recommendation-list.mdmarkdown37.4 KB
references/rendering/font-theme-strategy.mdmarkdown16.7 KB
references/rendering/shape-library.mdmarkdown1.6 KB
references/rendering/web-font-contract.mdmarkdown4.1 KB
references/style/README.mdmarkdown2.9 KB
references/style/coding/ai-coding/art-title-prompt-library.mdmarkdown17.2 KB
references/style/coding/ai-coding/asset-prompt-guide.mdmarkdown42.3 KB
references/style/coding/ai-coding/font-selection.mdmarkdown16.3 KB
references/style/coding/ai-coding/reference-analysis.mdmarkdown16.1 KB
references/style/coding/composition-layout.mdmarkdown31.6 KB
references/style/coding/concept-production.mdmarkdown2.7 KB
references/style/coding/generic-visual-fallback.mdmarkdown12.8 KB
references/style/coding/platforms/xiaohongshu.mdmarkdown8.6 KB
references/style/coding/scenarios/announcement-poster-spec.mdmarkdown10.1 KB
references/style/coding/scenarios/ecommerce-detail-page-spec.mdmarkdown34.0 KB
references/style/coding/scenarios/flowchart-spec.mdmarkdown3.3 KB
references/style/coding/scenarios/knowledge-graph-spec.mdmarkdown3.3 KB
references/style/coding/scenarios/logo-spec.mdmarkdown12.6 KB
references/style/coding/scenarios/menu-data-reference.mdmarkdown16.9 KB
references/style/coding/scenarios/menu-spec.mdmarkdown8.1 KB
references/style/coding/scenarios/menu-visual-reference-library.mdmarkdown11.7 KB
references/style/coding/scenarios/mind-map-spec.mdmarkdown6.5 KB
references/style/coding/scenarios/personal-card-spec.mdmarkdown7.3 KB
references/style/coding/scenarios/resume-spec.mdmarkdown12.0 KB
references/style/coding/scenarios/social-carousel-spec.mdmarkdown23.6 KB
references/style/coding/scenarios/social-long-image-spec.mdmarkdown31.3 KB
references/style/coding/scenarios/tri-fold-spec.mdmarkdown12.2 KB
references/style/coding/scenarios/vi-spec.mdmarkdown44.5 KB
references/style/coding/systems/announcement-poster-visual-system.mdmarkdown66.0 KB
references/style/coding/systems/diagram-visual-system.mdmarkdown19.7 KB
references/style/coding/systems/ecommerce-visual-system.mdmarkdown94.4 KB
references/style/coding/systems/logo-visual-system.mdmarkdown35.6 KB
references/style/coding/systems/menu-visual-system.mdmarkdown32.0 KB
references/style/coding/systems/personal-card-visual-system.mdmarkdown17.9 KB
references/style/coding/systems/resume-visual-system.mdmarkdown32.5 KB
references/style/coding/systems/social-visual-system.mdmarkdown169.6 KB
references/style/coding/systems/tri-fold-visual-system.mdmarkdown54.2 KB
references/style/coding/systems/vi-visual-system.mdmarkdown84.8 KB
references/style/pure-image/media/media-banner.mdmarkdown27.6 KB
references/style/pure-image/media/media-bilibili.mdmarkdown28.0 KB
references/style/pure-image/media/media-douyin.mdmarkdown27.8 KB
references/style/pure-image/media/media-h5.mdmarkdown29.5 KB
references/style/pure-image/media/media-kuaishou.mdmarkdown27.8 KB
references/style/pure-image/media/media-poster.mdmarkdown28.5 KB
references/style/pure-image/media/media-wechat-moments.mdmarkdown24.5 KB
references/style/pure-image/media/media-wechat-official.mdmarkdown25.3 KB
references/style/pure-image/media/media-xiaohongshu.mdmarkdown39.3 KB
references/style/pure-image/models/model-4.5.mdmarkdown17.6 KB
references/style/pure-image/models/model-5.0-pro.mdmarkdown31.8 KB
references/style/pure-image/prompt-guide.mdmarkdown10.9 KB
references/style/pure-image/scenarios/brand-application-system.mdmarkdown39.9 KB
references/style/pure-image/scenarios/brand-ip-character-system.mdmarkdown36.9 KB
references/style/pure-image/scenarios/brand-logo-system.mdmarkdown26.5 KB

references/style/coding/scenarios/menu-data-reference.md

View on GitHub
# 菜单数据与检查参考(按需读取)

配合 [菜单设计 Spec](menu-spec.md) 使用。本文件保存原有 menu-plan-v1 字段、示例与检查语义,供批量改价、数据驱动排版或复杂套餐引用;简单视觉设计无需填满这套结构。

**能力状态**:当前包内尚未核实到实现这些菜单专属检查的可执行程序。下文 error、warning、SHA-256、locked-facts 等描述属于约定,不能据此声称已经自动运行。使用外部检查器时记录真实入口与运行结果;没有工具时按 Spec 核对实际成品。保留字段语义不等于新增必交文件。

示例不承载真实营业事实;不得把演示价、来源或 planned 资产当作已核实数据。共同事实、字体、资产与交付协议仍以公共规范为准。

##### 独立锁定事实

可把用户已确认、不允许此次改变的值记录到独立文件,交给 `--locked-facts` 比对:

```json
{
  "facts": [
    {"pointer": "/items/0/item_id", "expected": "item-latte", "source": "用户确认菜品表第 2 行"},
    {"pointer": "/items/0/name", "expected": "拿铁", "source": "用户确认菜品表第 2 行"},
    {"pointer": "/items/0/pricing/options/0/amount", "expected": "28.00", "source": "用户确认菜品表第 2 行中杯价格"}
  ]
}
```

`pointer` 使用绝对 JSON Pointer;锁定值进行精确 JSON 比对,不执行表达式,也不自动解析 PDF、图片或表格。使用数组位置时同时锁定该位置的 ID;重排数组后根据原始资料更新路径,不能为消除错误改写 expected。获准改价时用新的确认资料建立新的锁定版本,保留变更依据。

锁定文件是人工提供的核验输入,不是来源真实性证明。未提供时,报告明确提示没有执行独立源值比对,事实 QA 仍需执行。

## 附录 A:品类计划字段与示例

### 最小计划示例

以下是虚构演示菜单的数据示例,不能作为真实商家的事实。JSON 为合法结构示例,制作时按真实任务替换内容;本示例示范少品项饮品图文方向;图片来源与样式仅为计划记录,未实际生成资产,不能用于声明素材已就绪。

```json
{
  "schema_version": "menu-plan-v1",
  "scene": "menu",
  "project": {
    "task_id": "menu-demo-01",
    "title": "演示咖啡单",
    "mode": "create",
    "content_context": "fictional_demo",
    "delivery_stage": "draft",
    "carrier": "single-sheet",
    "reading_context": "桌面近距离阅读",
    "languages": [
      "zh-CN"
    ],
    "currency": "CNY",
    "scope_item_ids": [
      "item-latte"
    ],
    "deliverables": [
      "单页菜单图片"
    ],
    "assumptions": [
      "示例菜品和价格为虚构演示"
    ]
  },
  "sources": [
    {
      "source_id": "src-demo",
      "status": "agent_generated",
      "description": "本示例获准创作的演示内容"
    }
  ],
  "categories": [
    {
      "category_id": "cat-coffee",
      "name": "咖啡",
      "item_ids": [
        "item-latte"
      ]
    }
  ],
  "items": [
    {
      "item_id": "item-latte",
      "name": "拿铁",
      "source_ref": "src-demo",
      "pricing": {
        "mode": "variants",
        "options": [
          {
            "option_id": "latte-medium",
            "label": "中杯",
            "amount": "28.00",
            "unit": "杯",
            "display_text": "28"
          },
          {
            "option_id": "latte-large",
            "label": "大杯",
            "amount": "32.00",
            "unit": "杯",
            "display_text": "32"
          }
        ]
      }
    }
  ],
  "units": [
    {
      "unit_id": "page-01",
      "unit_type": "page",
      "category_ids": [
        "cat-coffee"
      ],
      "item_ids": [
        "item-latte"
      ],
      "reading_mode": "comparison",
      "layout": {
        "reference": "MN-L06",
        "description": "独立饮品插画与菜名成组,下方中杯大杯规格价格明确对齐"
      },
      "visible_text_refs": [
        "text-category",
        "text-columns",
        "text-latte"
      ]
    }
  ],
  "visual_brief": {
    "intent": "安静、清楚的咖啡单,留白围绕价格比较区展开",
    "typography_roles": "分类名突出,菜名清晰,中大杯价格等权",
    "color_roles": "暖白背景,深色文字,一种分类强调色",
    "image_policy": "图文结合,独立饮品插画与规格价格表相邻,纸感底面承托准确文字",
    "container_policy": "无卡片,以列对齐和留白分组"
  },
  "text_bindings": [
    {
      "text_id": "text-category",
      "entity_id": "cat-coffee",
      "field": "name",
      "text": "咖啡"
    },
    {
      "text_id": "text-columns",
      "entity_id": "item-latte",
      "field": "pricing.options.label",
      "text": "中杯 / 大杯"
    },
    {
      "text_id": "text-latte",
      "entity_id": "item-latte",
      "field": "name + pricing.options.display_text",
      "text": "拿铁 28 / 32"
    }
  ],
  "text_contract": {
    "render_text": [
      "咖啡",
      "中杯 / 大杯",
      "拿铁 28 / 32"
    ],
    "planning_text": [
      "菜名左列,规格价格各自成列"
    ],
    "metadata_text": [
      "menu-demo-01"
    ],
    "visible_text_projection": "render_text"
  },
  "validation_targets": [
    "MENU-PRICE-001",
    "MENU-COVER-001",
    "MENU-READ-001"
  ],
  "open_issues": [],
  "visual_strategy": {
    "image_mode": "illustrated",
    "reference_templates": [
      "MN-S01"
    ],
    "selection_reason": "用独立杯型图帮助辨认饮品,并清楚比较规格价格",
    "featured_item_ids": [
      "item-latte"
    ],
    "image_assignments": [
      {
        "item_id": "item-latte",
        "visual_role": "item",
        "image_id": "image-latte"
      }
    ]
  },
  "asset_plan": [
    {
      "asset_id": "asset-latte",
      "role": "dish_illustration",
      "production": "image_generate",
      "source_ref": "src-demo",
      "version": "planned-v1",
      "replacement_entry": "独立饮品插画槽位",
      "status": "planned"
    }
  ],
  "images": [
    {
      "image_id": "image-latte",
      "asset_id": "asset-latte",
      "role": "dish_illustration",
      "item_ids": [
        "item-latte"
      ],
      "source_ref": "src-demo",
      "unit_ids": [
        "page-01"
      ]
    }
  ]
}
```

### 字段与条件模块

核心字段为 `project`、`sources`、`categories`、`items`、`units`、`visual_brief`、`text_bindings`、`text_contract`、`validation_targets`、`open_issues`。无分类的菜单可使用一个不显示标题的逻辑组,增加 `show_heading: false`,不要为满足字段新增可见分类名。

| 字段/模块 | 约定与触发条件 |
|---|---|
| `project.mode` | `create / content-update / reprice / redesign / adaptation` |
| `project.content_context` | `real_business / fictional_demo` |
| `project.delivery_stage` | `draft / final`,真实营业终稿不能保留价格占位或未确认营业事实 |
| `project.carrier` | `single-sheet / booklet / folded / wall-board / mobile-static / interactive / custom` |
| `project.scope_item_ids` | 本次需要展示的菜品集合;套餐内部组件可不在此集合中 |
| `project.physical_spec` | 印刷或墙面任务记录尺寸、单位及已知制作条件;每项区分提供、确认或假设状态 |
| `project.display_spec` | 数字任务记录目标显示尺寸和阅读方式;交互任务另记实现范围 |
| `items[].translations` | 多语言时使用语言键值映射,并记录 `translation_status` 与待核对项 |
| `items[].description / tags` | 内容存在才启用;事实标签需有来源,图例通过 ID 关联 |
| `items[].field_sources` | 一个条目的价格、描述等来源不同时,按字段路径覆盖默认 `source_ref` |
| `items[].pricing` | `fixed/from` 使用 `amount`;`variants` 使用 `options`;`market` 使用 `display_text`;`included` 使用 `package_ref`;`pending` 使用 `missing_fields`;其他模式按 §2.3 |
| `items[].pricing.currency` | 默认继承项目币种,不同时显式覆盖并在展示中区分 |
| `packages` | 套餐存在时启用,结构见下文 |
| `images` | 有图时记录 `image_id`、公共 `asset_id`、`role`、`item_ids`、`source_ref`;示意图追加 `disclosure_text` 与显示位置 |
| `notices` | 有适用规则时记录 `notice_id`、准确文案、来源、适用菜品/分类/全局范围及展示单元 |
| `legends` | 有符号时记录 `legend_id`、准确含义、符号引用和出现单元;条目标签引用同一 ID |
| `units[].repeated_item_reasons` | 跨单元重复菜品时记录菜品 ID 与重复原因;共享源数据 |
| `units[].continued_from` | 连续分类或条目需要显式续接时引用前一单元 |
| `units[].reading_mode` | `lookup / comparison / package-choice / sequence / custom` |
| `units[].constraints` | 按需记录折线、装订、远读、裁切、长文本和交互约束 |
| 公共资产与生产字段 | 按选定 workflow 写入 Brief/HTML 实现;引用现有字体、资产、图层及生产契约 |

套餐结构:

```text
packages[]:
  package_id: 稳定 ID
  menu_item_id: 作为套餐入口的菜品 ID,其 pricing 保存套餐基础价格
  fixed_components[]: {item_id, quantity}
  choice_groups[]:
    group_id: 稳定 ID
    label: 准确组名
    min_select: 非负整数
    max_select: 不小于 min_select 的整数
    options[]: {choice_id, item_id, quantity, surcharge_amount}
  notice_ids: 适用说明引用
```

第一版套餐选项不重复选择同一 `choice_id`,数量由 `quantity` 表达;若真实业务支持重复选择,先扩展明确的数据语义,不能用重复 ID 模拟。`surcharge_amount` 是在基础套餐价上增加的金额,币种继承套餐入口;禁止套餐递归包含自身。内部组件可被多个套餐引用,`included.package_ref` 只用于明确从属于一个套餐的组件。

`text_bindings` 是菜单实体到可见文案的追溯记录,`field` 为说明性字段路径,不是可执行表达式。`text` 必须能在 `render_text` 找到;实际文字可以按排版拆分为多个 TEXT,但不能改写事实。QA 检查只能核对明确绑定和源数据,不声称已自动证明任意自然语言改写保持等义。

### 可执行接口补充

以下约定补齐条件字段的具体形状,避免规划与 QA 各自解释:

- 所有实体、规格、可选组和选项 ID 在计划内唯一。数组中的同一引用不重复;重复展示通过不同单元表达。
- `project.languages` 第一项是 `name` 的主语言;其余语言使用 `items[].translations`,`translation_status` 为 `pending / confirmed`。
- `physical_spec / display_spec / custom_spec` 使用 `{size: "带单位的尺寸说明", status: "provided | confirmed | assumed"}`,可追加制作条件。交互菜单的 `display_spec` 另有 `implementation_scope`。草稿缺规格输出 warning,终稿缺规格输出 error;尺寸可读性仍由 QA 验证。
- `fixed / from` 的价格记录 `amount / unit / display_text`;`variants` 每个选项记录 `option_id / label / amount / display_text`,单位按实际需要记录。`unavailable` 记录 `display_text / display_policy`。不适用的 `amount / options` 不保留,避免模式切换后的旧价格残留。
- `tags` 是图例 ID 数组。`legends[]` 为 `{legend_id, text, symbol_ref, source_ref, unit_ids}`。`symbol_ref` 是供渲染与人工核对的符号说明或资产引用,计划 QA 不验证外部符号文件。
- `notices[]` 为 `{notice_id, text, source_ref, scope, unit_ids}`;`scope` 使用 `{type: "global"}` 或 `{type: "items | categories", ids: [...]}`。品牌标题、币种说明等独立可见文案也可作为全局说明绑定,不虚构菜品来容纳文案。
- `images[].disclosure_unit_ids` 保存示意标识所在单元;`disclosure_text` 进入可见文案。图像的 `asset_id` 引用本计划公共 `asset_plan` 条目;公共资产的完整生产契约仍由原工作流验证。
- `units[].repeated_item_reasons` 是 `{菜品ID: "重复原因"}` 对象,在后续出现单元记录;缺少原因输出 warning。
- `open_issues[]` 为 `{message, status: "open | resolved", blocks_final: true | false}`;营业终稿仍有阻塞项则输出 error,草稿未解决项输出 warning。
- `text_bindings` 支持菜品、分类、套餐、说明、图例和图片实体。所有 `render_text` 有绑定,所有绑定有单元引用;每个页面展示的菜品有页面内文案绑定。直接 `name / text` 绑定可精确比对,复合绑定仍需 QA 核对,不能用包含任意一段文本证明整个条目完整。
- 可选 `--locked-facts` 文件由原始确认资料建立,结构为 `{facts: [{pointer, expected, source}]}`;`pointer` 为绝对 JSON Pointer,`expected` 为精确锁定值。使用边界见本文件开头及菜单 Spec 第六章。

### QA 检查接口

以下编号由菜单 QA 和计划 QA 共同使用,规则依据见菜单 Spec 第六章,本文件保留字段与检查编号。结构检查结果与成品 QA 结果分别记录。

| 检查 ID | 检查目标 | 结构检查范围 | 实际成品 QA |
|---|---|---|---|
| `MENU-STRUCT-001` | 结构可解析,条件字段齐备 | 版本、类型、枚举、条件字段 | 载体与真实需求一致 |
| `MENU-REF-001` | 关系引用有效 | ID 唯一、引用存在、套餐不递归 | 图片和说明在画面上归属正确 |
| `MENU-FACT-001` | 准确内容有来源 | 来源引用、已提供锁定值的比对、未解决项 | 逐项核对名称、标签、说明和译文 |
| `MENU-PRICE-001` | 菜品、规格、价格一致 | 金额格式、计价模式、规格归属、币种和源值 | 不错行、不跨栏误读,单位明确 |
| `MENU-PACK-001` | 套餐规则可理解且有效 | 数量范围、候选数量、加价和组件引用 | 固定项、可选项、加价能被区分 |
| `MENU-COVER-001` | 交付内容没有遗漏 | 范围内菜品覆盖,重复用途记录 | 没有裁掉、遮住或排出画面的内容 |
| `MENU-TEXT-001` | 可见文案可追溯 | text_bindings 与 render_text 对应 | 实际成品未混入规划文案,文字准确 |
| `MENU-IMAGE-001` | 图像身份和用途明确 | 资产引用、菜品关联、示意记录 | 菜品特征、数量和图片对应可信 |
| `MENU-READ-001` | 可以完成点单任务 | 仅检查目标是否记录 | 实际尺寸下检索、比较、理解套餐 |
| `MENU-MEDIA-001` | 适配所选载体 | 相应载体规格是否记录 | 折叠、装订、远读、手机显示等检查 |

机器报告采用 `error / warning / manual_check`;人工检查采用 `pass / fail / not_applicable / pending`。待人工检查不能自动变成通过,计划结构通过也不能代替渲染和真实交付检查。

## 附录 B:可选检查记录示例

以下模板用于复杂任务或需要追踪多版本的项目;简单任务可在 Brief/HTML 实现 中保留同等证据,不要求额外交付报告。占位内容须替换为实际记录,模板本身不代表通过。

```json
{
  "report_version": "menu-qa-v1",
  "project_id": "menu-demo-01",
  "plan_sha256": "填写机器报告中的实际输入摘要",
  "automatic_report": "menu-validation.json",
  "reviewed_artifacts": [{"path": "menu.png", "version": "填写实际版本或文件摘要"}],
  "review_mode": "reviewer_walkthrough",
  "checks": [
    {
      "check_id": "MENU-PRICE-001",
      "object_ref": "page-01/item-latte",
      "status": "pending",
      "evidence": [],
      "observation": "尚未检查实际渲染",
      "repair": "取得目标尺寸成品后核对中杯与大杯价格",
      "blocks_final": true
    }
  ],
  "warning_dispositions": [],
  "delivery_decision": "pending_evidence"
}
```

## 附录 C:图文方向字段与机器检查边界

`visual_strategy` 为图文计划对象:`image_mode` 使用 `image-led / illustrated / mixed / text-led`;`reference_templates` 是模板 ID 或 custom 字符串数组;`selection_reason` 说明所选图文关系;`featured_item_ids` 为重点菜品;`image_assignments[]` 为 `{item_id, visual_role, image_id}`,visual_role 使用 `hero / category / item / package`。text-led 另有 `text_led_reason`,不强制图片数量。

`images[].unit_ids` 指向实际展示单元。图片关联菜品、计划重点菜、显示单元应一致。菜品图分配只能引用 dish_photo、dish_illustration 或 generated_dish_demo,atmosphere 与 decoration 不代替菜品图。

既有 menu-plan-v1 的记录约定:缺少 visual_strategy 时提示 warning 与人工判断,不拒绝既有合法无图计划。新增图文任务应记录该对象。已选择图文方向却没有菜品图或遗漏重点菜,草稿提示 warning,final 输出 error;引用不存在、归属错误始终 error。明确 text-led 原因时允许无图通过。

计划中的 asset_plan 不证明资产已生成。是否真实就绪、视觉比例、图文吸引力及参考风格还原由本文件的实际成品 QA 核对。新检查统一使用 `MENU-IMAGE-001`,不把风格编号、图片数量或背景层数改为审美硬指标。
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall