HarmonyOS NEXT Dev Skill

面向 code agent 的 HarmonyOS NEXT ArkTS 应用开发 skill。包含 8700+ 篇官方 API 文档、开发参考文件、跨平台工具脚本。

安装

将 harmonyos-dev/ 下载到 code agent 的 skills 目录。

Claude Code：

~/.claude/skills/harmonyos-dev/

Codex：

~/.agents/skills/harmonyos-dev/

其他遵循 Agent Skills 规范的助手，放到对应的 skills 配置路径。

目录结构

harmonyos-dev/
├── SKILL.md             # AI 指令：知识来源优先级、文档查找流程、SDK 定位、版本映射
├── README.md            # 本文件
├── LICENSE              # 许可证
├── references/          # 参考文件
│   ├── doc-index.md     # 8733 篇文档索引（带描述、快速导航指南、搜索技巧）
│   ├── arkts-grammar.md # ArkTS 语法约束、装饰器速查、编译错误对照、常见陷阱
│   ├── api-index.md     # 47 个 Kit API 索引
│   ├── samples-index.md # HarmonyOS Samples（467 仓库）+ OpenHarmony 官方示例
│   ├── tools-reference.md # hvigorw/ohpm/codelinter/hstack/Emulator/DevEco Studio 命令
│   └── community.md     # 官方社区资源链接
├── scripts/             # 跨平台工具脚本
│   ├── ask-huawei-ai.sh / .ps1  # 开发者 AI 问答（认证/匿名）
│   ├── update-docs.sh / .ps1    # 更新文档
│   └── rebuild-index.sh / .ps1  # 重建文档索引
└── docs/zh-cn/          # 8733 篇 OpenHarmony 官方文档（中文）

依赖

macOS / Linux：curl、awk、sed（系统自带，无需安装）。

Windows：PowerShell（系统自带）或 Git Bash。

scripts 用法

脚本提供基础功能实现，覆盖了主要路径，但边缘场景的处理不一定完备。可根据实际需要读取、修改或重写脚本。

更新文档

# macOS / Linux / Git Bash
bash scripts/update-docs.sh

# Windows PowerShell
.\scripts\update-docs.ps1

通过 gitee.com 镜像 clone 最新 OpenHarmony 文档。然后自动重建文档索引。

重建索引

bash scripts/rebuild-index.sh   # 或 .\scripts\rebuild-index.ps1

从文档文件树全量提取标题，重新生成带描述的索引。update-docs 执行后自动调用，一般无需手动运行。

智能客服问答

bash scripts/ask-huawei-ai.sh "ArkTS 中如何实现 SSE 流式请求"
bash scripts/ask-huawei-ai.sh "如何配置路由导航" --out-file answer.md
bash scripts/ask-huawei-ai.sh "..." --raw   # 原始 SSE 输出

认证模式：将 auth.json 放到 scripts/auth.json，包含 raw_cookie 字段。无此文件时自动使用匿名模式。

许可证

本项目除 docs/zh-cn/ 外的所有文件（scripts/、references/、SKILL.md 等）适用 MIT 许可证。

docs/zh-cn/ 目录下的文件来源于 OpenHarmony/docs，适用 CC-BY-4.0 许可证。