万少 · 万绍业 技术 · 创造 · 价值

鸿蒙开发技巧 鸿蒙官方的这些skill,可能会让你减少重复工作

鸿蒙官方的这些 skill,可能会让你减少重复工作

写鸿蒙应用的人应该都有同感,真正耗时间的从来不是「想清楚要做什么」,而是那些每次都要重来一遍的固定动作:

写鸿蒙应用的人应该都有同感,真正耗时间的从来不是「想清楚要做什么」,而是那些每次都要重来一遍的固定动作

  • 写页面时反复翻 ArkTS 语法和 ArkUI API,不确定某个装饰器在 V2 里还叫不叫这个名字;
  • 老项目要升级,V1 状态管理往 V2 迁,装饰器一个个对,ForEach 换成 Repeat
  • 应用闪退了,对着 faultlog 里的 SIGSEGV 和一堆地址发呆;
  • 折叠屏上布局错位,避让区、悬停、自然方向挨个试;
  • 接一个 Kit,先去翻文档,再把示例代码抄一遍,改改能跑。

这些活儿的共同点是:有标准答案,但你每次都得自己找一遍。

华为其实已经把这类事情打包好了。在 Matrix 技能广场上,官方组织 HarmonyOS 发布了 48 个 Agent Skill,覆盖设计、开发、测试、发布全流程。

技能广场:https://matrix.openharmony.cn/#/skillSquare 原始仓库:https://gitcode.com/HarmonyOS_Skills/harmonyos-agent-skills

Matrix 技能广场的 Skill 页面

技能广场本身是个技能市场,整个平台的技能总量已经接近 4000 个,来自不同组织和个人。但如果你要的是「鸿蒙应用开发」这件事本身,官方这 48 个才是最该先装的一批

48 个技能,一张图看清

官方这批技能不是零散堆上去的,按解决的问题可以分成六组:

HarmonyOS 官方 Agent Skills 能力地图

从图上能看出来,官方把「开发者会重复做的事」拆得相当细,尤其是稳定性分析多设备适配这两块 —— 恰恰是平时最费时间、又最难靠搜索解决的部分。

下载量说明了大家最烦什么

把 48 个技能的下载量排个序,头部效应非常明显:

官方 Skill 下载量 TOP 12

前五名清一色是「写代码 / 语言能力」类,下载量在 1.4 万以上,第六名直接掉到 2500 左右,中间是一道断崖。这个分布很真实 —— 写代码是每天都要做的事,而崩溃分析、多设备适配是偶尔才碰一次的事。

几类真正能省事的技能

下面按场景挑几个说,涉及下载量的数据截至 2026 年 9 月。

一、写代码与查文档:把「翻文档」变成一句话

技能 解决的问题 下载
hmos-arkui-develop-skill 按官方最佳实践生成 / 审查 ArkUI 代码,涵盖状态管理、组件结构、布局选择、性能优化 16712
hmos-arkts-knowledge-retriever 检索 ArkTS 语言指南,给语法、库用法、代码示例,并且带可追溯的文档引用 16157
hmos-arkts-syntax-checker 静态语法检查 + 错误自动修复 + 循环构建直到出包,按 P0/P1/P2 分级重试 14521
hmos-arkts-deprecated-interface-checker 扫出工程里的废弃 SDK 接口,给迁移方案和修复优先级 14090
hmos-arkui-statemgt-migration V1 → V2 状态管理迁移:装饰器对照、ForEach/LazyForEachRepeatanimateTo 兼容、V1/V2 混用 14067

其中 arkts-knowledge-retriever 最值得单独说一句。它不生成代码,只负责给答案和出处,所以拿它来核对「这个 API 到底是不是这么用」比直接问 AI 靠谱得多 —— 引用可查,不用赌它有没有幻觉。

二、崩溃与性能分析:把日志变成结论

这块是官方做得最「重」的一组,围绕故障日志有 8 个技能,每类日志对应一个:

技能 对应故障
hmos-cppcrash-analysis Native 层崩溃(SIGSEGV / SIGABRT / SIGILL / SIGBUS)
hmos-jscrash-analysis ArkTS/JS 层闪退,按 Reason / Error name / Stacktrace 定位
hmos-appfreeze-analysis 冻屏、卡死、ANR(APPFREEZE / INPUT_BLOCK / LIFECYCLE_TIMEOUT)
hmos-jsleak-analysis 基于 rawheap / heapsnapshot 聚类数据找内存泄漏,内置转换与聚类脚本
hmos-native-memleak-analysis Native 内存泄漏:sample 采样、smaps、profiler 火焰图、NMD 数据
hmos-memleak-analysis 静态扫源码找泄漏,覆盖 ArkTS / JS / C++ 与 NAPI 桥接
hmos-fdleak-analysis FD Leak、句柄与文件描述符泄漏,含 FdTrack 申请栈热点
hmos-apifault-analysis 输入错误码 / 错误信息直接定位问题

用法很直接:把日志丢进去就行。技能内部会按固定流程逐步排除,最后输出唯一根因和修复建议,而不是给你一堆可能性让你自己猜。

三、多设备适配:一次把机型差异讲清楚

共 7 个。入口技能是 hmos-multidevice-scenario-entry,它会先判断你的场景属于哪一类,再路由到下面 6 个具体场景文件:

  • screen-window-size —— 响应式 / 自适应布局,断点、GridRow/GridCol、平行视界 EasyGo、应用内分屏
  • fold-state —— 折叠状态检测、悬停分屏、折痕避让、F/M/G 多折叠形态
  • avoid-areas —— 安全区扩展、状态栏导航栏避让、刘海挖孔、软键盘遮挡
  • natural-orientation —— 屏幕方向、旋转、setPreferredOrientation
  • interaction-methods —— 触摸 / 鼠标 / 键盘 / 手写笔的事件归一
  • hardware-access —— 相机选择与旋转、canIUse/SysCap 检查、硬件降级

四、Kit 能力接入:少抄一遍示例代码

共 10 个,覆盖账号、推送、实况窗、扫码、地图、支付、广告:

  • hmos-account-kit-quicklogin-client —— 华为账号一键登录,含获取匿名手机号
  • hmos-push-kit —— 推送集成大路由:拿 Push Token、配推送、开场景化消息权益
  • hmos-live-view-kit-build-location —— 实况窗创建 / 更新 / 停止,覆盖即时配送、打车、排队、计时、航班、高铁、共享租赁、运动、导航九大场景
  • hmos-scan-kit-defaultscan / customscan —— 默认界面扫码与自定义界面扫码
  • hmos-map-kit-* —— 地图创建、POI 搜索、路径规划
  • hmos-payment-kit-huawei-payment-integrationhmos-ads-kit-access

五、元服务与测试、工具链

  • 元服务 ASCF(4 个)ascf-assistant 工具链开发,ascf-convert-uniapp / ascf-convert-taro 把 uni-app、Taro 项目转成元服务,atomicservice-assistant 负责元服务项目创建改造、隐私托管、可信域名、静默登录、包大小超限与上架审核被拒这些坑
  • 测试(2 个)hmos-local-test 跑 ArkTS/JS 单测,hmos-instrument-test 跑集成测试并支持 ASan 检测
  • DevEco 工具链(8 个)deveco-autobugfix 全流程自动修 Bug,deveco-studio-hilog 日志分析,deveco-studio-codelinter 静态检查,deveco-studio-hvigor 命令行构建,deveco-studio-verify 真机验证,deveco-studio-emulator 模拟器管理,deveco-native-flow 三端一致开发流水线,deveco-requirement-development 端到端需求开发

怎么用起来

装技能这件事,官方做得比想象中轻。打开任意一个技能的详情页,安装命令直接写在页面上:

技能详情页,安装命令在页面上直接给出

二选一:

# 方式一:Matrix CLI
matrix skill install hmos-arkui-develop-skill

# 方式二:npx
npx skills add https://matrix.openharmony.cn/api/registry/skills/hmos-arkui-develop-skill

小提示:方式二里的地址是给 skills 命令行读的接口地址,不是网页。直接粘进浏览器会显示 404,这是正常的 —— 命令本身能正常拉到技能(skills 会去读它的 /.well-known/agent-skills/index.json)。

装完之后不需要背任何命令。每个技能的 SKILL.md 里都写清楚了「什么情况下用我」,所以你要做的只是正常说需求:

Skill 被自动调用的流程

举几个例子:

  • 「帮我用 ArkUI 写一个商品列表页」→ 命中 arkui-develop
  • 「这段 ArkTS 编译报错了」→ 命中 arkts-syntax-checker
  • 「把工程的状态管理从 V1 迁到 V2」→ 命中 arkui-statemgt-migration
  • 「应用启动就闪退,日志在附件」→ 命中 jscrash-analysis
  • 「折叠屏展开后布局错位」→ 命中 multidevice-fold-state
  • 「接入华为账号一键登录」→ 命中 account-kit-quicklogin-client

全部 48 个技能一览

如果懒得一个个点,下面这张长图就是官方组织在技能广场上的完整清单:

HarmonyOS 官方 48 个 Skill 全览

写在最后

这 48 个技能的价值,不在于「AI 又能多写几行代码了」,而在于把那些有标准答案、却要反复查证的环节,变成了一次性的基础设施

装一次,之后每次遇到同类问题,AI 会自动按官方规范走一遍流程。你省下来的不是打字时间,是「翻文档、对版本、试参数」的时间。

建议的入手顺序:先装 hmos-arkui-develop-skillhmos-arkts-knowledge-retriever 这两个,用一周感受一下差别,再按自己的项目类型补崩溃分析或多设备适配那一组。

技能广场:https://matrix.openharmony.cn/#/skillSquare 原始仓库:https://gitcode.com/HarmonyOS_Skills/harmonyos-agent-skills

留言讨论

正在加载评论…