鸿蒙HarmonyOS

common-skill技能索引。当用户提出鸿蒙智家相关问题或是做鸿蒙智家设备控制时，先读此文件确定应加载哪个具体 skill，再按需加载对应 skill 获取数据和分析框架。不要一次性加载所有 skill。

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

查 HarmonyOS API 精确接口定义、参数、返回值、枚举取值、错误码时触发(如 "@ohos.multimedia.audio AudioCapturer 有哪些方法""AVPlayer 的 state 枚举取值""某接口返回的错误码含义""Ability 启动原因 LaunchType 取值")。对应 harmonyos-api-references-mcp 的 search_api_references / get_api_reference / list_api_references_by_topic 工具,检索 4495 篇 API 参考文档。注意:这是查"接口精确定义"(参数/枚举/错误码),若查 API 用法和示例请用 harmonyos-guides,查场景最佳实践和参考代码请用 harmonyos-best-practices,查设计规范用 harmonyos-ui-design-guides。

查 HarmonyOS UI 设计规范、视觉风格(色彩/字体/图标)、控件设计规范(底部页签/标题栏/弹窗等)、交互规范、多设备适配设计时触发(如 "底部页签怎么设计""暗色模式色彩规范""弹窗设计规范""折叠屏适配设计""应用图标规范")。对应 harmonyos-ui-design-guides-mcp 的 search_design_guides / get_design_guide / list_design_guides_by_topic 工具,检索 166 篇 UI 设计指南。注意:这是查"设计怎么做"(视觉/交互/控件设计规范),若查 API 用法请用 harmonyos-guides,查接口定义用 harmonyos-api-references,查场景最佳实践用 harmonyos-best-practices。

检查 HarmonyOS 项目中的废弃 SDK 接口并提供修复建议。当需要清理废弃 API、升级 API 版本、优化代码质量或进行静态语法检查时使用。提供详细的迁移方案、修复优先级分类和代码示例。

检查并修复 HarmonyOS 项目的 ArkTS 语法错误，自动化构建项目。当需要编译项目、修复编译错误、生成 HAP/App 产物时使用。提供静态语法检查、错误自动修复、循环构建直到成功的完整工作流程。支持错误优先级分类（P0/P1/P2）、最大重试机制、构建产物自动定位。

对 HarmonyOS（鸿蒙）项目运行 DevEco Studio CodeLinter 静态代码检查，解读检查结果并提供修复建议。支持 ArkTS、TS、JS 文件，涵盖性能、安全、代码规范、正确性、跨设备适配、API 兼容性等规则集。当用户提到 codelinter、code linting、鸿蒙代码检查、鸿蒙应用质量、HarmonyOS 代码质量检查、静态代码分析、规范扫描、性能检查、安全扫描、代码审查、规则检查、lint 报告时使用。

HarmonyOS模拟器管理助手。**首次使用必须先运行 `python scripts/setup.py --force` 配置路径**，然后才能执行模拟器启动、应用安装调试等操作。包含完整的场景化设备控制命令（旋转、电源、截屏、音量、摇一摇、折叠）。支持Windows/macOS/Linux。触发词：模拟器、emulator、hdc、推包、安装应用、启动模拟器、构建推包。

HarmonyOS日志分析助手，专注于hilog日志查看、崩溃日志分析、日志导出(-logZip)、手动日志分析。包含完整的hilog命令、hidumper堆栈转储、崩溃日志自动解压分析功能。支持Windows/macOS/Linux跨平台。

HarmonyOS应用构建工具助手，专注于使用Hvigor命令行工具构建HarmonyOS应用。包含完整的构建命令、参数说明、清理操作和CI/CD集成指南。

在 HarmonyOS 应用/服务开发中执行模块的 Instrument Test（包括 ArkTS/JS 和 C++ 测试），支持运行、覆盖率统计、ASan 检测等模式，并可指定测试范围（模块、测试套件、单个用例）。

在 HarmonyOS 应用/服务开发中执行模块的 Local Test（ArkTS/JS 单元测试），支持运行、覆盖率统计等模式，并可指定测试范围（模块、测试套件、单个用例）。

覆盖安装 HarmonyOS APP 到真机。触发词 — 安装、装到手机、install、deploy、hdc、真机。永远使用 hdc 全路径覆盖安装（-r），绝不卸载，保护用户数据。

A鑲¤偂绁ㄦ櫤鑳戒氦鏄撳姪鎵嬶紝涓撴湇鍔′腑鍥藉ぇ闄嗚偂绁ㄥ競鍦恒€傚綋鐢ㄦ埛璇㈤棶A鑲¤偂绁ㄨ鎯呫€佷釜鑲″垎鏋愩€佸ぇ鐩樻儏缁€佺儹鐐规澘鍧椼€佷氦鏄撶瓥鐣ャ€佷环鏍奸璀︺€佹定璺屽箙銆佹垚浜ら噺銆佹妧鏈潰鎴栧熀鏈潰鍒嗘瀽鏃惰Е鍙戙€傚彧澶勭悊娌繁A鑲★紙浠ｇ爜浠?/00/30/68寮€澶达級锛岃嚜鍔ㄥ拷鐣ユ腐鑲″拰缇庤偂銆傛墍鏈夋暟鎹疄鏃朵粠涓滄柟璐㈠瘜銆佹柊娴储缁忋€佸悓鑺遍『銆侀洩鐞冩姄鍙栥€俇se when: user asks about Chinese A-share stocks, 鑲＄エ琛屾儏, 涓偂鍒嗘瀽, 澶х洏鍒嗘瀽, 鏉垮潡鐑偣, 涔板崠鐐? 姝㈢泩姝㈡崯, 浠撲綅寤鸿, or any A-share trading-related query.

鸿蒙ETS代码规范。编写或修改oh_packages或entry目录下的.ets文件时使用。

鸿蒙ArkUI MVVM实现规范。创建/修改/重构Page、View、ViewModel时使用，包括：新增页面、添加UI组件、调整ViewModel结构、拆分子ViewModel、修改状态管理、处理生命周期等场景。

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

在 Linux 下使用 HarmonyOS Command Line Tools + SDK CLI 进行应用开发、构建、打包、安装、调试与日志排查。内置命令全集、文档刷新流程，以及可重复执行的一键环境安装/校验脚本。

在 Linux 下使用 HarmonyOS Command Line Tools + SDK CLI 进行应用开发、构建、打包、安装、调试与日志排查。内置命令全集、文档刷新流程，以及可重复执行的一键环境安装/校验脚本。

HarmonyOS 鸿蒙元服务游戏生成器。根据指定游戏主题，自动创建 MVVM 架构的鸿蒙游戏项目。 使用场景: - 用户想要创建新的鸿蒙游戏元服务 - 用户提到游戏主题如 "贪吃蛇"、"俄罗斯方块"、"打砖块" 等 - 用户说 "帮我创建一个XX游戏" - 用户想要基于 MVVM 架构开发鸿蒙游戏 触发词: 创建游戏、鸿蒙游戏、元服务游戏、HarmonyOS 游戏、MVVM 游戏

HarmonyOS UI 自动化测试用例管理和执行技能。用于存储、管理和执行 UI 测试用例，验证应用功能是否正常。支持通过组件文本/ID定位元素，自动适配不同屏幕尺寸。使用场景：(1) 执行已保存的测试用例 (2) 保存新的测试用例 (3) 列出所有测试用例 (4) 用户说"运行测试"、"执行测试用例"、"验证XX功能"、"把这个测试流程保存下来"。

HarmonyOS UI 自动化交互技能。通过 hdc dump ArkUI 布局树，理解当前界面状态，根据用户意图找到目标组件位置，并执行点击、长按、滑动、输入等交互操作。适用于 UI 自动化测试、应用操作自动化等场景。

OpenHarmony (鸿蒙) 服务层/框架层代码仓库架构与命名规范领域知识。 适用于识别、导航、分析和创建符合 OpenHarmony 分层架构标准的代码仓库。 当用户需要以下任一场景时使用此 Skill： (1) 分析 OpenHarmony 服务层或框架层代码仓库的目录结构与命名约定， (2) 判断一个仓库是否符合 OpenHarmony foundation 分层架构规范（subsystem/component 路径模式）， (3) 理解 bundle.json 组件描述符与 GN 构建系统的路径映射关系， (4) 在 OpenHarmony 项目内新增组件、服务或接口时遵循正确的命名格式, (5) 理解 frameworks/ vs services/ vs interfaces/ vs common/ 的分层职责边界。

帮助在 HarmonyOS NEXT 上使用百度地图鸿蒙 SDK 进行开发。支持独立包（@bdmap/base、@bdmap/map、@bdmap/search、@bdmap/util）和组合包（@bdmap/map_walkride_search、@bdmap/navi_map），以及定位 SDK（@bdmap/locsdk）。涵盖地图展示与交互、覆盖物绘制、POI/AOI 检索、路线规划、导航、前台/后台定位、地址/POI 获取等场景。适用于提到鸿蒙地图、百度地图 HarmonyNEXT SDK、地图展示、检索、路线规划、导航、定位能力等需求。

HarmonyOS ArkTS 综合开发与类型安全最佳实践助手。用于在生成或重构 ArkTS/ArkUI 代码时统一组件装饰器、生命周期、样式布局、事件处理、类型与空值安全、性能优化与错误处理等规范，帮助通过 ArkTSCheck，提升代码一致性与可维护性。

Create a minimal HarmonyOS NEXT empty application project structure from scratch, including standard directories and configuration files such as oh-package.json5, build-profile.json5, AppScope/app.json5, entry module, and hvigorfile.ts. Use when the user asks to create a new HarmonyOS NEXT 空工程/空项目 从0到1 鸿蒙应用 or a minimal runnable demo project.

检查 HarmonyOS 项目中的废弃 SDK 接口并提供修复建议。当需要清理废弃 API、升级 API 版本、优化代码质量或进行静态语法检查时使用。提供详细的迁移方案、修复优先级分类和代码示例。

检查并修复 HarmonyOS 项目的 ArkTS 语法错误，自动化构建项目。当需要编译项目、修复编译错误、生成 HAP/App 产物时使用。提供静态语法检查、错误自动修复、循环构建直到成功的完整工作流程。支持错误优先级分类（P0/P1/P2）、最大重试机制、构建产物自动定位。

Handle HarmonyOS avoid-area adaptation through a declarative scene and resource index. Use when the task involves safe area expansion, status bar or navigation bar avoidance, notch or cutout handling, immersive full-screen layouts, or soft keyboard overlap handling.

HarmonyOS foldable-device adaptation skill for requirements, development, bug-fix, and verification phases. Activate when the task involves fold status detection, hover-mode split-screen layouts, crease avoidance, fold continuity, multi-fold form-factor mapping (e.g. F/M/G), inner/outer screen ratio differences, or fold-related issue remediation.