事情是这样的:华为的 DevEco Code(一个基于 OpenCode 二次开发的 AI 编程助手)里面藏了一整套鸿蒙开发工具链------ArkTS 语法检查、hdc 设备管理、崩溃日志分析、知识库搜索,甚至还有 UI 验证和项目模板。问题是,你得装一整个 IDE 插件才能用上这些能力,换个编辑器就没了,放在别的 AI Agent 里完全是睁眼瞎。
于是就有了 harmonyos-dev-skill------一个独立的 Agent Skill 项目,把 DevEco Code 里那些好用的鸿蒙开发工具全都拆出来,打包成干净独立的脚本集合,丢到任何支持 Skill 机制的 AI 编程工具里就能跑。简单说,就是把一整套鸿蒙开发工作流浓缩成一个文件夹,装上即用。
它到底是什么
本质上是一堆脚本 + 参考文档 + 一个 Agent 入口文件(SKILL.md),按规范组织后,能被 AI Agent 读取并作为"技能"加载。加载之后,你的 AI 编程助手就突然懂鸿蒙了------知道怎么查 ArkTS 语法、怎么调 hdc 命令、怎么分析崩溃堆栈、怎么创建项目模板,甚至能直接帮你搜华为官方知识库。
听起来像魔法,其实做的是 "搬运 + 解耦" 的脏活。
从 DevEco Code 拆了什么出来
DevEco Code 仓库很大,核心的鸿蒙相关代码藏在 packages/opencode/src/tool/ 和 packages/opencode/resources/skills/ 下面。拆出来的东西可以分几类:
工具脚本(核心) :
oh_knowledge.py:独立实现的鸿蒙知识库搜索,带完整的 OAuth 登录流程。不用开 DevEco Studio 就能直接搜华为文档,token 本地加密存储,登录一次管很久arkts-check.cjs:调 DevEco Studio 自带的ets_checker.js做语法快速检查,写完代码秒出结果deveco-build.cjs\start-app.cjs:hvigor 构建和 hdc 启动的封装,一条命令搞定编译到运行jscrash-report.cjs+runtime-fix/*.mjs:崩溃日志的结构化解析和故障取证流程,faultlogger 探测、faultlog 拉取、hilog 快照一条龙
参考资料(知识库) :
- ArkTS 语法规则、TypeScript 迁移差异、常见错误修复(每个错误都有对应的
.ets示例) - ArkUI 组件 cookbook、API guardrail、常见坑、质量检查清单
- DevEco Code 原始 agent prompt 备份
模板:完整的 ArkTS 项目模板,一键创建新工程。
解决了什么痛点
做过鸿蒙开发的人都懂------DevEco Studio 是必需品,但有时候你只是想快速查个 API、跑个语法检查、或者让 AI 帮你改两行 ArkTS 代码。为了这点事打开那个吃内存的 IDE,等它加载、索引、同步......真的够了。
这个 skill 让你在 VSCode、Cursor、Codex、Claude Code 或者任何支持 Skill/Agent 的环境里直接调用鸿蒙工具链,开发体验丝滑了不止一个档次。换电脑?不用重装 IDE 和插件,去 GitHub 把仓库 clone 下来,配个 DEVECO_HOME 就能干活。
怎么用
装到 Codex 就两行 PowerShell:
ruby
$dest = Join-Path $env:USERPROFILE '.codex\skills\harmonyos-dev'
Copy-Item -Recurse -Force @('SKILL.md','agents','scripts','references','templates') -Destination $dest
重启 Codex,然后跟 AI 说:"用 harmonyos-dev skill 帮我检查这个项目的 ArkTS 语法问题",它就知道该调哪个脚本、读哪个参考文档了。
知识库搜索也是开箱即用:python scripts/oh_knowledge.py "ArkTS @State 装饰器用法",首次会自动弹出浏览器登录华为账号,之后走加密存储的 token,完全无感。
局限与边界
诚实地说,不是所有能力都搬过来了。DevEco Code 的 native bridge(napi_bridge.node)是平台相关的二进制文件,没法直接打包进仓库。所以 UI 验证会话、模拟器自动启动这类依赖原生桥的能力,需要额外配置才能用。不过日常开发 90% 的场景------语法检查、构建部署、设备管理、崩溃分析、知识搜索------都已经完整覆盖了。
写在最后
DevEco Code 是一套很强大的鸿蒙开发工具链,但它被束缚在特定的 IDE 生态里。harmonyos-dev-skill 做的事情本质上就是解耦和标准化------把好东西拆出来,让它能在任何地方发挥作用。
项目已开源在 GitHub 上:junerver/harmonyos-dev-skill,MIT 协议。如果你在做鸿蒙开发,又受够了 IDE 的束缚,不妨试试看。