前言¶

寫鴻蒙原生應用時，檢索成本往往不在編碼本身，而在幾處反覆出現的瑣事上：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