메뉴
ArkUI / ArkTS 页面落地与组件设计规范。Use when 改 entry/src/main/ets/ 下的 .ets 文件、做蓝湖/HTML/截图→ArkUI 转化、写新页面/组件、踩 ArkUI 安全区/响应式/状态管理坑、SDK 升级 ArkTS 兼容性问题。NOT for 改 cpp/napi/audio/video 或 docs。CRITICAL: 仅在确认任务涉及 ets/ 时加载,纯 cpp/native 任务不要触发。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | arkui-design |
| description | ArkUI / ArkTS 页面落地与组件设计规范。Use when 改 entry/src/main/ets/ 下的 .ets 文件、做蓝湖/HTML/截图→ArkUI 转化、写新页面/组件、踩 ArkUI 安全区/响应式/状态管理坑、SDK 升级 ArkTS 兼容性问题。NOT for 改 cpp/napi/audio/video 或 docs。CRITICAL: 仅在确认任务涉及 ets/ 时加载,纯 cpp/native 任务不要触发。 |
| disable-model-invocation | false |
| allowed-tools | Read, Grep, Glob, Edit, Write |
| trigger | Read 或 Edit entry/src/main/ets/**/*.ets / 用户说"做页面 / 还原稿 / 适配 / 重构 UI / 蓝湖 / HTML 转 ArkUI / 安全区 / 响应式 / 键盘避让" |
Column / Row / Stack / List / Grid + layoutWeight + constraintSize,禁止 top/left/marginTop/translate/offset 对截图vp,字体用 fp,不要 沿用 HTML px / lpxpaddingTop/marginTop magic numberList + ListItem(长列表 LazyForEach+ 稳定 key),网格用 Grid,导航用 Navigation/Tabs/SideBarContainerentry/src/main/resources/base/profile/main_pages.json@Prop 传函数;页面状态用 @State,只读父传子用 @Prop,双向用 @LinkPageLifecycleGuard 模板(token + cleanup)FontWeight.SemiBold/Alignment.TopCenter 在当前 SDK 可能不存在)| 触发场景 | 必读 reference |
|---|---|
| 蓝湖稿 / HTML / 截图 → ArkUI 落地 | references/01-core-rules.md + references/03-page-workflow.md + references/06-anti-patterns.md |
| 写新页面 / 重构页面 | references/02-layout-and-units.md + references/04-component-rules.md |
| 调状态管理 / 路由跳转 / 生命周期 | references/05-engineering-constraints.md |
| SDK 升级 / 编译报错 ArkTS 兼容性 | references/05-engineering-constraints.md(SDK 适配段) |
| 蓝湖 750 设计稿换算 | references/05-engineering-constraints.md(蓝湖换算段) |
| 反模式快速识别(代码 review) | references/06-anti-patterns.md |
蓝湖 / HTML / 截图 → ArkUI 任务必须 按此顺序输出,普通修 bug/查代码不强制:
输出后追加:
详见 references/03-page-workflow.md。
rg -n "\.position\(|\.markAnchor\(|\.translate\(|\.offset\(|\.width\('[0-9]+vp'\)|\.height\('[0-9]+vp'\)|\.width\([0-9]{2,}\)|\.height\([0-9]{2,}\)" \
entry/src/main/ets/pages entry/src/main/ets/components \
-g "*.ets" -g "!deprecated/**" -g "!legacy/**"
命中不等于必错——区分"业务热区固定尺寸"(如虚拟手柄按钮)和"截图补丁式布局"。前者说明外层自适应依据,后者必须整改。
references/01-core-rules.md — 核心定位 / 输入材料规则 / 设计稿与状态职责边界 / 2026-04 执行口径references/02-layout-and-units.md — 布局单位 / 安全区 / 响应式 / 容器选型references/03-page-workflow.md — 5 步流程详解 / HTML→ArkUI 转换表 / 设计 token 与自适应边界references/04-component-rules.md — 页面根 / 顶部 / 卡片 / 列表项 / 资源主题规范references/05-engineering-constraints.md — ArkTS 类型/状态管理/生命周期/路由/键盘焦点/列表性能/SDK 适配/蓝湖换算references/06-anti-patterns.md — 危险信号识别 / 工程硬性禁止项 / 设计页落地输出要求Run the full audit → core-review → fix → fix-verify → gate → commit workflow on a harmony stage topic (NAPI / Engine / Audio / Video / NativeBuffer / Resource lifecycle / Input+EventBridge / SaveState+SRAM+Disk). Use when user says "跑闭环 X" / "audit + 修 X" / "完整审一下 X" / "/closed-loop". Drives the 8-step trust chain end-to-end with 4 mandatory human checkpoints.
自动化代码提交 → 推送 → 创建 PR → CI 监控 → 合并 main 的完整工作流。如果 CI 失败，自动分析错误并修复，最多重试 3 次。
四方一致性审查 — git / code / md / memory 四个事实源深度阅读 + 跨维度对比, 抓概念脱节 / 规则滞后 / deprecated 仍推荐 / stale snapshot / 内容矛盾。 Use when 用户说 "/four-way-audit" / "四方一致性" / "四维审查" / "跨维度对齐" / "deprecation drift" / "概念口径" / 季度回顾 / 重大重构前。 NOT for 路径引用扫描(走 /gc)、bug 修复(走 /closed-loop)、PR 合并(走 /auto-commit-cicd)。
Run garbage collection for repository entropy: scan doc-drift + code-drift, append new technical debt items to docs/tech-debt-tracker.md. Use when 用户说 "/gc" / "跑 gc" / "扫熵" / "扫漂移" / 准备发版前 / weekly 回顾. NOT for fixing the drift (人决策何时批量修).