鸿蒙HarmonyOS

鸿蒙(HarmonyOS)开发专家助手。当用户需要进行鸿蒙应用开发、ArkTS/ArkUI、HarmonyOS NEXT、鸿蒙原生应用或跨设备开发时调用。

HarmonyOS application build, clean, package and device installation. Use when building HarmonyOS projects with hvigorw, cleaning build artifacts, managing ohpm dependencies, packaging HAP/HSP/APP bundles, installing to devices via hdc, or troubleshooting installation errors like "version code not same".

当用户编写、调试或审查 HarmonyOS NEXT 应用（ArkTS / ArkUI / Stage 模型 / @ohos.* API / DevEco Studio / hvigor / hdc），需要查阅华为开发者官方文档（版本说明 / 指南 / API 参考 / 最佳实践 / FAQ），或询问 HarmonyOS API 签名、错误码、能力可用性时使用。先在 `references/INDEX.md` 中 grep 关键词定位目标路径，再 Read 命中的 `.md`，不要遍历目录或一次性读多个文件。

采集 HarmonyOS 设备/模拟器上的 UI 截图与控件树，执行交互场景验证，输出差异报告和迭代建议

鸿蒙 HarmonyOS NEXT 应用开发全流程技能。覆盖 ArkTS 语言、ArkUI 声明式开发、Stage 模型、状态管理、分布式能力、性能优化、调试排坑、上架审核等完整链路。特别包含 OpenClaw 鸿蒙版真实踩坑：27个编译错误 + 构建配置错误 + 运行时状态管理错误完整案例。

Vision-driven HarmonyOS NEXT device automation using Midscene. Operates entirely from screenshots — no DOM or accessibility labels required. Can interact with all visible elements on screen regardless of technology stack. Control HarmonyOS devices with natural language commands via HDC. Perform taps, swipes, text input, app launches, screenshots, and more. Trigger keywords: harmony, harmonyos, 鸿蒙, hdc, huawei device, harmony app, harmony automation, harmony phone, harmony tablet, test harmony app, verify on harmonyos, QA on 鸿蒙, check the app on harmony, test on huawei device, see if the app works on harmony, end-to-end test on harmonyos, visual verification on 鸿蒙 Powered by Midscene.js (https://midscenejs.com)

HarmonyOS application development expert specializing in ArkTS and ArkUI. Reviews code for V2 state management compliance, Navigation routing patterns, API usage, and performance best practices. Use for HarmonyOS/OpenHarmony projects.

在鸿蒙应用（Cangjie）开发中，当需要使用 stdx 拓展库（如 crypto、encoding、net、log、actors 等），或在构建/链接阶段出现 stdx 相关错误时，使用此 Skill 获取/解压 stdx 包，并指导在 entry/cjpm.toml 中正确配置 bin-dependencies.path-option。

当构建成功后需要记录重难点，或构建失败时需要查询已知问题时，使用此 Skill 管理 Evolution.md 文件。此 Skill 负责追踪并分析构建失败日志，将重难点解决方案沉淀至 Evolution.md，打造专属知识库，拒绝重复踩坑。只有在构建成功后才能将新问题添加到 Evolution.md。

当需要构建鸿蒙应用项目时，使用此 Skill 执行构建流程。此 Skill 包含完整的构建命令、构建流程说明、构建失败处理流程。构建脚本会自动执行依赖安装、仓颉预编译、资源生成、编译、打包等步骤。

HarmonyOS PC development environment skill pack. Provides complete platform knowledge (code signing, read-only /tmp, no gcc, ld.bfd wrapper, LD_LIBRARY_PATH ordering) and toolchain adaptation guides (Python, Rust, Go, PyTorch, llama.cpp, OpenSSH, etc.). Use when building, compiling, or configuring any software on HarmonyOS, or when user mentions "鸿蒙", "HarmonyOS", "HongMeng", or any HarmonyOS-specific issue. Read docs/ files for detailed build guides when needed.

当需要快速精准检索鸿蒙应用开发相关的代码片段和概念时，使用此 Skill 进行 L1 RAG 查询。此 Skill 基于向量数据库和 BM25 混合检索，提供最常用的代码片段。注意：这是可选功能，需要配置 API Key 才能启用。

HarmonyOS 5 (NEXT) development guide based on Arcana HarmonyOS enterprise architecture. Provides comprehensive support for Clean Architecture (four-layer), Offline-First design, ArkTS strict mode, ArkUI declarative UI, InversifyJS-style DI, MVVM Input/Output/Effect pattern, HUKS security, and WorkScheduler background sync. Suitable for HarmonyOS project development, architecture design, code review, and debugging.

鸿蒙 HarmonyOS 开发辅助。当用户的任务涉及 HarmonyOS、鸿蒙、ArkTS、ArkUI、DevEco Studio 或任何鸿蒙 Kit（如 Ability Kit、Network Kit、Media Kit 等）相关的开发、调试、API 查询时，必须使用此 skill。即使你认为自己知道答案，也必须先查文档。

Comprehensive assistance with harmonyos

Use when writing HarmonyOS/ArkTS local unit test cases with Hypium framework. Triggers when user asks to write tests, create test cases, add unit tests for HarmonyOS/ArkTS code. Also use when user mentions: 写测试用例, 编写测试, unit test, Hypium, 本地测试代码, test.ets, mock test, 测试覆盖, test coverage, 为...写测试, 给...添加测试, 如何测试, test a function, 测试某个方法, TDD, 测试驱动. Use proactively even if user doesn't explicitly say "test" but wants to verify code correctness, add test files, or improve code quality through testing.

查询 HarmonyOS 官方文档。用户提到鸿蒙开发、ArkTS API、官方文档时启用。通过华为文档 REST API 搜索目录、按章节获取内容、查找相关文档。支持用户直接粘贴官方链接定位到具体文档和章节。

HarmonyOS NEXT（API 12-23）离线文档导航 + 全链条开发流程

Use when running HarmonyOS/ArkTS local unit tests (hvigorw test, hypium), fixing "SDK component missing" or "Task test not found" errors, setting up CI/CD testing, or resolving DEVECO_SDK_HOME/HOS_SDK_HOME issues. Also use when user mentions: 本地测试, 本地单元测试, hvigorw test, hypium test, test_result.txt, .test目录, coverage report.

HarmonyOS 开发文档知识库查阅 Skill。 【自动触发条件——出现以下任一信号时立即加载本 Skill，无需用户显式说明】 意图信号（中文）： - 查鸿蒙文档 / 鸿蒙开发 / HarmonyOS开发 - ArkTS / ArkUI / .ets文件 - DevEco Studio / module.json5 / oh-package.json5 - UIAbility / Stage模型 / 组件生命周期 - @State / @Prop / @Link / @Provide / @Consume - Navigation / Tabs / Swiper / WaterFlow - HTTP请求 / 网络请求 / 数据持久化 Trigger: HarmonyOS, ArkTS, ArkUI, .ets, DevEco Studio, module.json5, oh-package.json5

HarmonyOS官方文档快速查找Skill。在skill内部的references文件夹（包含2860个markdown文件）中高效检索开发文档、API参考、开发指导、常见问题等。使用三步查找法：先文件名匹配缩小范围，再内容搜索精确定位，最后读取目标文件。当用户开发HarmonyOS应用或插件时使用，适合API用法、功能实现、错误排查、Kit介绍、组件使用等任何需要查阅官方文档的情况。触发关键词：HarmonyOS开发、鸿蒙开发、鸿蒙适配、鸿蒙文档、ArkTS开发指导、@ohos API、Kit文档、组件用法、错误码查询、开发指南、如何实现、常见问题等。

Search HarmonyOS API reference Markdown files in api-references to find modules, API signatures, types, permissions, system capabilities, examples, and feature-level implementation guidance. Use when looking up HarmonyOS/OpenHarmony/HMS APIs, ArkTS APIs, Kit documentation, @ohos or @hms modules, system capabilities, permissions, or when adapting code to HarmonyOS. The api-references file names include Kit names, so always search file names first before content.

Use when Codex needs official HarmonyOS/OpenHarmony Test Kit workflows for ArkTS unit tests, UI tests, performance tests, test-runner wiring, or command-line test execution, including deciding the minimum test surface for complete or validation-oriented app samples. Trigger on `@ohos/hypium`, `@kit.TestKit`, `@ohos.UiTest`, `Driver`, `ON`, `aa test`, `ohosTest`, `testRunner`, `OpenHarmonyTestRunner`, unit-test, UI-test, performance-test, test coverage, or when Codex should follow local official docs and samples for HarmonyOS testing.

Use when Codex needs to turn an empty or partial HarmonyOS/OpenHarmony project into a complete working application or demo-ready sample. Covers official Stage-model project setup, directory layout, DevEco configuration, ArkTS UI architecture, state-management choices, test expectations for complete or validation-oriented apps, ability and native integration boundaries, and staged verification. Trigger on requests to build a HarmonyOS app from scratch, scaffold a project, complete an unfinished app, create a sample app, set up DevEco or hvigor structure, add abilities or native integration, or define a project architecture and delivery plan.

纯血鸿蒙 HarmonyOS NEXT (API 12+) ArkTS 应用开发。编写、审查、调试 ArkTS/ArkUI 代码，使用 HarmonyOS SDK API，配置项目结构，处理编译错误。包含 8700+ 篇官方文档、47 个 Kit API 索引、100+ 官方示例链接。当用户提到 ArkTS、鸿蒙、HarmonyOS、OpenHarmony、ets 文件时使用。不涉及 Android 兼容层的旧 API。

Use for HarmonyOS/OpenHarmony ArkTS code work when Codex needs official documentation and samples to answer `.ets` syntax, state management, component semantics, migration, compile-error, API-usage, or legacy ArkUI maintenance questions, including ArkTS compile failures inside `ohosTest` test code. Trigger on `.ets` files, ArkTS decorators, `@kit` or `@ohos` APIs, HarmonyOS/OpenHarmony context, `@ComponentV2`, `@ObservedV2`, `@Trace`, `@Local`, `@Param`, `@Event`, `@LocalBuilder`, `@State`, `@Prop`, `@Link`, `@Provide`, `@Consume`, `@StorageLink`, `@StorageProp`, `@Watch`, or when V1/V2 state-management choices or strict ArkTS typing are relevant inside code.

鸿蒙项目构建、模拟器拉起、应用安装部署。当用户要求编译、启动模拟器、安装 HAP 或在模拟器上运行应用时使用。

鸿蒙官方组件的检索与集成。当用户需要集成地图、图表、表单、导航等鸿蒙组件时，根据需求检索索引并指导安装与使用。

鸿蒙智家家庭技能集合，支持设备查询、消息告警、控制记录、家庭信息、设备控制、路由器管理、门锁和智慧屏等全家智能管家服务。也适用于"家庭简报"、"家里怎么样"、"今天家里有什么状况"、"家里网络状态"等家庭状态查询场景。当用户请求涉及“家”、“家庭”、“家里”、“全屋”、“家中”、“智家”等所有与家相关或与家中设备相关的任何查询、操作或控制时，优先调用本技能。

鸿蒙 HarmonyOS 屏幕方向与旋转相关的需求分析、开发实现、问题修复和功能验证。当任务涉及以下场景时使用：setPreferredOrientation、屏幕旋转(rotation)、屏幕方向(orientation)、自然方向、折叠屏方向、三折叠G态、follow_desktop、视频横竖屏切换、短视频自适应旋转、多设备方向策略、module.json5方向配置、方向监听、旋转检测、分屏旋转、折叠屏展开态方向、窗口方向设置、方向Bug修复。