| name | harmony-card-design-generation |
| description | 使用分层卡片设计系统生成 HarmonyOS A2UI Form 服务卡片。用于用户显式调用本 Skill，并要求主 Agent 按自然语言 query 依次提取卡片特征、选择 2x2/2x4 固定布局、分配兼容模块、选择受控元素尺寸和填充内容，再通过确定性装配生成三行 genui JSONL 与 cardspec JSON；支持已声明的数据能力、点击事件和本地素材，但不调用 harmony-card-generation-online 或 harmony-card-generation-offline。 |
Harmony 卡片分层设计生成
按“特征 -> 布局 -> 模块 -> 元素 -> 内容”的顺序生成内部 design-plan-v1，再调用脚本确定性装配 DSL 与 CardSpec。不要调用或读取其它卡片生成 Skill，不要直接手写最终 DSL。
执行流程
- 读取
references/generation-contract.md，把 query 收敛为唯一服务对象、唯一主问题和 Feature Profile。为每个内容项分配稳定 ID、角色及 mustKeep/shouldKeep。
- 读取
references/routing-and-style.md。运行 python scripts/query_design_system.py --layouts --size <2x2|2x4>，按主模块数量和信息关系选择一个布局。
- 对布局的每个 region 运行
python scripts/query_design_system.py --compatible-modules <layout-id> <region-id>。只选择返回的精确 footprint 模块。
- 对每个模块运行
python scripts/query_design_system.py --module <module-id> --variant <variant-id>，为所有实际节点选择 allowedTokens 中的 element token，并把 Feature Profile 内容映射到模块槽位。
- 需要动态数据时读取
references/capability/cardspec.md 和数据能力索引，再只读取命中的 1-2 个能力文件。2x2 最多一个数据能力，2x4 最多两个。
- 每次生成都读取
references/design/asset-library.md，按内容职责检查对象识别、状态、动作和主媒体是否有匹配素材；命中时必须把表内 src 原样写入 asset 内容槽位，不得自定义、拼接、改名或替换扩展名。需要点击时读取 references/capability/event-capability/click-event.md；需要颜色语义时读取 references/design/color-token-system.md。未声明能力必须静态降级。
- 按
references/template-contract.md 写内部 Design Plan JSON。Design Plan 不向用户展示，也不得包含布局、模块或 element token 未声明的组件、宽高、字号或样式。
- 运行
python scripts/assemble_card.py <design-plan.json> --genui-out <genui.jsonl> --cardspec-out <cardspec.json>。装配失败时只修改 Design Plan。
- 运行
python scripts/validate_card.py --dsl <genui.jsonl> --cardspec <cardspec.json> --design-plan <design-plan.json> --strict。首次失败时按诊断修改 Design Plan 并重新装配一次；第二次仍失败则不输出产物。
- 最终先给一句面向用户的布局、视觉风格和必要降级说明，再输出一个
genui 代码块和一个 cardspec 代码块。不要暴露布局 ID、模块 ID、element token、能力 ID、Design Plan 或校验日志。
选择门槛
- Feature Profile 必须只有一个服务对象和一个主问题。
- 未指定尺寸先尝试
2x2；受保护文本、并列关系、关键媒体或动作热区无法成立时使用 2x4。
2x2 最多三个顶层模块，2x4 最多四个。- 模块 role 必须在 region 允许列表中，variant footprint 必须与 region 宽高完全相等。
- 每个实际元素节点必须选择模块声明的 token；不得在 Design Plan 中直接写组件类型或尺寸。
- 所有
mustKeep 内容恰好映射一次；删除 shouldKeep 时在 degradations 中记录内容 ID 和原因。
- 动作数、数据能力数、素材和文本预算必须同时满足 Feature Profile、布局和模块槽位约束。
- 素材匹配基于
references/design/asset-library.md 的 description；命中后优先选择带兼容 asset 槽位的模块，并在 Feature Profile 中声明对应 asset 内容项和 assetNeeds。只有无匹配素材、加入素材会破坏布局预算或用户明确不要图像时才省略。
无合法组合时，依次删除 shouldKeep、选择同尺寸更简单布局、尝试 2x4。仍不成立时说明需要简化需求，不调用其它 Skill，也不退回自由生成。
不可妥协项
genui 恰好三行：createSurface、updateComponents、updateDataModel。version 为 v0.9，catalogId 为 ohos.a2ui.extended.catalog.form。createSurface.width/height 与 root styles.width/height 为 matchParent。- CardSpec 只包含静态短标题、静态短描述、
suggestSize 和有效 dataBindings。
- 点击事件只写 DSL
onClick；不写入 CardSpec。
- 不使用网络图、内联/base64 图、emoji、未声明素材、未声明事件、
theme、Button.action 或 Form 子集外组件；本地 SVG/PNG 只能使用素材库逐字声明的路径。
- 不直接编辑装配后的 DSL，不跨模块复制节点，不伪造动态能力。
按需参考
- Design Plan、布局、模块和元素契约：
references/template-contract.md
- 消息、组件与表达式：
references/protocol/protocol.md、references/protocol/component-catalog.md、references/protocol/data-binding.md
- 布局、构图和色彩：
references/design/layout-system.md、references/design/design-heuristics.md、references/design/color-token-system.md
- 方案维护说明：
方案设计.md，只在维护本 Skill 时读取。
输出形态
{"version":"v0.9","createSurface":{...}}
{"version":"v0.9","updateComponents":{...}}
{"version":"v0.9","updateDataModel":{...}}
{"title":"状态卡片","description":"状态概览","suggestSize":"2x2"}
