前言¶

写鸿蒙原生应用时，检索成本往往不在编码本身，而在几处反复出现的琐事上：ArkTS 严格模式的约束、Stage 模型下 UIAbility/ExtensionAbility/AbilityStage 的分工、module.json5 / app.json5 / oh-package.json5 / build-profile.json5 的配置字段、V1/V2 两套状态管理装饰器的取舍，以及真机部署时的签名、打包、日志排查。查文档、翻 Kit、对命令成了日常。

下面介绍 HarmonyOS NEXT Pro。它把上述内容收进一个通用 SKILL.md 格式的 Skill 里，面向”开发、评审、调试、迁移、构建、部署、自动化”这一整条链路，而不是只覆盖其中一环。

这是什么¶

HarmonyOS NEXT Pro 是一个社区维护的 Skill，坐标 @user_8fb2e41b/harmony-next-pro，版本 1.2.0，发布者 user_8fb2e41b，分类 dev-programming，来源 community，无需 API Key。官方地址：

https://api.skillhub.cn/user_8fb2e41b/harmony-next-pro

SkillHub 页面：

https://www.skillhub.cn/skills/user_8fb2e41b/harmony-next-pro

它解决的问题是：让通用编程 Agent 在处理鸿蒙项目时，有一套覆盖 ArkTS / ArkUI / Stage 模型 / 各 Kit / 调试诊断 / 构建部署的参考清单和路由入口，而不是靠通用知识现猜。按页面数据，发布时评分 100000、下载 1089 次（抓取时间为 2026-11-04，以页面实时数据为准）。

核心功能¶

语言与 UI 框架。 覆盖 ArkTS 严格模式、ArkUI 声明式组件、动画（animateTo、geometryTransition）、列表性能（LazyForEach、@Reusable）、沉浸式窗口与深色模式。

架构与配置。 覆盖 Stage 模型下的 UIAbility / ExtensionAbility / AbilityStage / WindowStage，以及 module.json5、app.json5、oh-package.json5、build-profile.json5 的配置项。

状态管理。 同时给出 V1（@State / @Prop / @Link / @Provide-@Consume / @Observed + @ObjectLink / @Watch）和 V2（@ComponentV2 / @Local / @Param + @Once / @Param + @Event / @ObservedV2 + @Trace / @Monitor）两套装饰器，另有 AppStorageV2、PersistenceV2。

路由与跨端能力。 覆盖 Navigation + NavPathStack 路由、App Linking、跨设备接续（continuation）。

Kits。 覆盖 60 多个 HarmonyOS Kit，包括 CameraKit、Audio、ScanKit、MapKit、PushKit、PaymentKit、ShareKit、Weather、Image、Vision、FormKit、LocationKit、NotificationKit、NetworkKit、RelationalStore、Preferences、FileIo，以及 AVSession / AVPlayer / AVRecorder 等媒体能力。

并发与底层。 覆盖 TaskPool / Worker 并发、@Concurrent / @Sendable 共享堆、NDK / NAPI、Cangjie。

调试与诊断。 覆盖 ArkWeb / WebView CDP 调试、DevEco Studio 侧的 CodeGenie / MCP / ArkUI Inspector / Profiler / Previewer（含 devecostudio:// 链接）、HarmonyOS Emulator / HVD，以及 hdc、uitest、aa、bm、hilog、hidumper 命令行诊断。

构建与部署。 通过 harmony-deploy CLI 覆盖 hvigorw、ohpm、hdc，HAP / HSP / HAR 打包、签名、多模块依赖解析、product 变体、debug / release / test 构建模式、AppGallery 的 APP 打包与设备日志查看。

离线 API 参考路由。 提供 KITS / TASK_MAP / INDEX 三套查找入口，用于在无网络时定位某个 Kit 或任务对应的参考内容。

安装与启用¶

Skill 以通用 SKILL.md 格式提供，按 SkillHub 页面提示的安装方式启用即可；具体命令以官方页面为准，此处不预设。启用后通过触发词调用，例如”鸿蒙开发”“鸿蒙部署”“ArkTS”“module.json5”“hdc”“@ComponentV2”等中英关键词均会命中（完整触发词清单见上文官方地址页面）。

典型用法¶

1、开发阶段用状态管理分节：需要决定 V1 还是 V2 时，直接对照 @State/@Prop/@Link 与 @ComponentV2/@Local/@Param 两组清单，而不是临时查文档。

2、查 Kit 时走离线路由：先用 KITS 定位目标 Kit（如 CameraKit、ScanKit），再按 TASK_MAP / INDEX 找对应任务入口。

3、部署阶段走构建自动化：按 build-profile.json5 配置 product 与 buildMode，用 hvigorw / ohpm 完成 HAP / HSP / HAR 打包与签名，再用 hdc 安装、aa start 拉起，必要时用 hilog / hidumper 看日志；AppGallery 发布走 APP 打包流程。

4、调试阶段：真机或模拟器用 hdc 连接，界面用 ArkUI Inspector，性能用 Profiler，Web 内容走 ArkWeb CDP。

适用场景与注意¶

适合：在通用 Agent（Cursor、Codex CLI、Claude Code 等支持 SKILL.md 的环境）里处理鸿蒙 NEXT / OpenHarmony 原生应用的开发、评审、调试、迁移、构建、部署与自动化任务的人。

注意：Skill 是参考与流程指引，不替代 DevEco Studio 和官方文档；版本字段以仓库实际文件为准（当前 1.2.0）。评分、下载量为 SkillHub 页面实时数据。涉及签名、AppGallery 上架等操作，仍以华为开发者后台的要求为准。

结尾¶

HarmonyOS NEXT Pro 的价值在于把鸿蒙原生开发的散点知识压成一份可路由的清单：从 ArkTS 状态管理到 Kits，从 hdc 诊断到 HAP/APP 打包部署。如果你的工作流里已经有通用编程 Agent，想在鸿蒙项目里直接用起来，可以从官方地址开始：

https://api.skillhub.cn/user_8fb2e41b/harmony-next-pro