| name | harmony-card-generation-offline |
| description | 生成、修复、评审或解释 HarmonyOS A2UI Form 服务卡片的离线产物。用于需要同时产出三行 genui JSONL 与 cardspec JSON，并按最终 Form DSL 协议处理 Expression、PathBinding、FunctionCall、列表模板变量、2x2/2x4 尺寸、Form 组件字段、事件能力和 CardSpec 数据契约校验同一张卡片的任务。 |
Harmony 卡片生成（离线 Form DSL 版）
产出同一张 Form 卡片：三行 genui JSONL 加一个 cardspec JSON。输出前按 core-rules.md 检查协议、绑定、布局、内容、颜色、事件和 CardSpec。
执行顺序
- 先读
reference/core-rules.md，把 P0/L0/L1/L2 当硬门槛。
- 再按任务类型读最小必要文件：新卡片读
reference/generation-workflow.md；修复/评审读 reference/protocol/protocol.md、reference/protocol/component-catalog.md、reference/protocol/data-binding.md 中与问题相关的部分；能力边界读 reference/capability/cardspec.md 和命中的能力索引。
- 新卡片先收敛到一个服务对象或主问题，再按角色槽位分配内容：
object、primary、support、metric/tile/status/badge、action、asset。不要把所有事实硬压成固定支撑条数。
- 用户明确指定
2x2 或 2x4 时优先尊重；未指定尺寸时选择能够满足需求的最小尺寸，并默认从 2x2 开始。删除非核心可选信息后，只要核心问题、必须展示的数据和必要动作仍能完整表达，就必须使用 2x2；只有受保护文本、必要热区、必须同屏理解的并列关系、关键媒体或整体布局预算出现可说明的具体失败时才升级 2x4。不得仅因信息较多、横版更舒展、视觉更丰富或存在两个数据能力而选择 2x4。
- 从零生成完成内容分级后，只要候选尺寸可能由模板承载，且入选内容能收敛为一个服务对象/主问题与
object、primary、support、metric/tile/status/badge、action、asset 角色槽位，先读 reference/template-routing.md 和 assets/templates/index.json 做候选判断；最多选一个模板。模板只提供骨架和预算，内容、DataModel、素材、颜色、事件必须重做。
- 需要专项，或对组件字段、绑定、布局、颜色、事件不确定时，按
reference.md 定向补读最小必要文件；没有读到权威文件前不要凭样例或记忆补字段。先解决协议、绑定、尺寸和布局，再处理事件、CardSpec、颜色、素材、主显示组突出度、支撑组归拢和表面层级。
- 需要动态数据时先读
reference/capability/cardspec.md，再读 reference/capability/data-capability/index.md 做能力路由，只加载命中的 1-2 个能力 manifest；不要预读整个 data-capability/ 目录。多个能力必须逐个确认 capabilityId、arguments、writeResultTo、常用 UI 路径和初始化 DataModel；初始化可以使用示例值，但 writeResultTo 对应动态子树中的每个字段、层级、类型、枚举、范围和数组项结构都必须来自该能力的 outputSchema，只有入选字段才进入 DSL 和 CardSpec。
- 写 DSL 前先算 surface/root、内容区、padding/margin/itemMargin、热区、受保护文本、并排宽高和颜色来源；写到任何组件属性前，若
component-catalog.md 未覆盖该字段或枚举，先删减设计或改用已覆盖属性。
- 输出前确认协议、绑定、布局、颜色、事件、尺寸、模板槽位、信息职责、事实等价类和 CardSpec 对齐；若确认项依赖未读专项，先补读再输出。只有用户要求校验既有文件或调试脚本时才运行
scripts/validate_card.py。
模式 1/2 的最终回答只给最终 DSL/CardSpec，不输出解释、校验日志、命令、比较过程或中间文件。
输出形态
只输出两个代码块，顺序固定：
{"version":"v0.9","createSurface":{"surfaceId":"...","catalogId":"..."}}
{"version":"v0.9","updateComponents":{"surfaceId":"...","root":"...","components":[...]}}
{"version":"v0.9","updateDataModel":{...}}
{
"title": "状态卡片",
"description": "状态概览",
"suggestSize": "2x2"
}
静态卡片也输出 cardspec，必须包含静态短 title、静态短 description 和 suggestSize，但不要虚构 dataBindings。动态卡片的 cardspec.dataBindings 必须来自已声明 data capability，且 UI 路径能由 writeResultTo + outputSchema 推导。
一致性约定
- 新卡片默认使用
2x2 = 160vp x 160vp、2x4 = 320vp x 160vp 作为实际布局预算；root styles.width/height 必须写 "matchParent"；createSurface 默认省略 width/height，若声明只能写 "matchParent"。内部组件继续使用可静态推导的数值预算。
- 未指定尺寸时执行“最小充分尺寸”门禁：先删除
shouldKeep 等非核心可选内容并验证 2x2；能够完整满足核心需求就不得升级。选择 2x4 必须能指出 2x2 在受保护文本、必要热区、关键并列关系、关键媒体或整体布局预算上的具体失败点。
- root 仍承载
padding: 12、borderRadius、clip 和背景：无论 2x2 还是 2x4，都固定使用 borderRadius: 18、clip: true。该固定值只约束卡片 root，内部 Row/Column/Text/Image/Button/Progress 等组件的圆角仍按视觉预算设置，并继续使用数值宽高。
- 新卡片默认省略
createSurface.width/height 与 createSurface.styles；表面背景、内容布局、安全区和 root 形状都写在 root.styles 或 root 下的真实背景组件。只有宿主明确要求外层形状/裁切时，createSurface.styles 才可出现且仅限 borderRadius、clip。
- 绑定方式遵循最终 Form DSL：属性值可用静态值、完整
{{ ... }} Expression、{"path":"/..."} PathBinding，或宿主明确注册的 FunctionCall；新生成优先用完整表达式保持可读和可校验。updateDataModel.path、CardSpec writeResultTo、模板 children.path 是协议结构 JSON Pointer，不属于值绑定；列表模板项可用 $item/$index 或 itemVar/indexVar。
- 非模板生成时使用稳定语义 ID：
surface_card、root、header_row、title_text、primary_value、primary_caption、support_row、action_button 等；模板生成时保留模板 ID 体系，但删除不用的可选槽位并同步清理引用。
- 不使用网络图、内联/base64 SVG data URI、emoji、占位媒体、未声明资源路径、未声明事件能力、
Button.action、非 onClick 事件或 Form 子集外组件；允许 reference/design/asset-library.md 声明的本地 SVG/PNG，SVG 可用 Image.styles.fillColor 染色。
- 可点击 UI 必须有真实
onClick EventHandler；如果动作能力不明，删除点击行为，把动作区降级为非误导支撑信息。
- 颜色规则读
reference/design/color-token-system.md；需要具体 hex 时再读 reference/design/color-token-values.md。DSL 输出 hex，不输出 token 名。
- 布局失败时按固定顺序降级：缩短弱文本 -> 删除可选角色槽位或 字段 -> 降低到批准字号阶梯 -> 拆行/改 Column -> 放弃模板 -> 升级 -> 能力边界说明。
专项参考
默认只读 reference/core-rules.md；新卡片再读 reference/generation-workflow.md。路由不清楚、修复已有 DSL、需要模板、动态数据、事件、颜色、素材，或主显示组不突出、支撑组散落、表面层级缺失时，再按 reference.md 读取对应专项文件；进入专项文件后先看顶部决策、阻断或使用规则，不一次性泛读无关参考。
组件属性只以 reference/protocol/component-catalog.md 为权威来源；它按组件维护顶层字段、styles 字段、动态绑定支持和可用枚举。协议消息、root shell、事件和绑定分别查 protocol.md、data-binding.md 与事件能力文件，不要把字段从旧模板、历史 .dat 或包外网页直接搬进 DSL。
新卡片中只要入选内容存在可由素材承担的识别、状态、动作、主媒体或视觉锚点职责，先读 reference/design/asset-library.md 再决定是否使用 Image；用户未提供素材不等于素材不可用。决定省略素材前，必须确认素材库无明确匹配、加入素材会破坏 L1 布局预算，或用户明确要求不用图片/图标。
运行本 skill 时不读取本 skill 包外的 UX 文档、旧样例、截图、网页或链接；需要的生成流程、布局字号、配色和验收规则已经折叠进 reference/ 内部文件。
降级原则
当需求信息不足、组件字段不确定、布局预算复杂、动作/素材/颜色来源不完整，或出现渲染失败迹象时，优先降低自由度：标准短需求先用 reference/template-routing.md 的模板 manifest 槽位模式；若不用模板，则少组件、少层级、少颜色、少动态路径、少 Stack。未指定尺寸时先删除可选槽位并验证 2x2；只有核心需求仍无法在明确布局预算内成立时才改用 2x4，否则进入能力边界说明。
