HarmonyOS NEXT Agent Skills

给 Gemini CLI、Claude Code、Codex 和其他 AI 编程助手使用的 HarmonyOS NEXT 离线技能包。

!docs !api

API 12–26 的本地 HarmonyOS 参考、ArkTS/ArkUI、NDK、DevEco Studio、模拟器自动化和发布调试工作流。

让 Agent 自动安装

把这段话发给你的 Agent：

请安装并启用 linhay/harmony-next.skills 的 harmony-next skill。
先识别当前 Agent：
Gemini CLI：gemini skills install https://github.com/linhay/harmony-next.skills --path harmony-next --scope user
Claude Code：npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy
Codex：npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy
其他支持 skills CLI 的 Agent：npx skills add linhay/harmony-next.skills --skill harmony-next
安装后读取 harmony-next/SKILL.md，确认 skill 名称和版本，并报告实际安装路径；命令不可用时给出手动安装路径，不要假设成功。

快速开始

npx skills add linhay/harmony-next.skills --skill harmony-next

安装后直接提出 HarmonyOS 开发问题。Agent 会按 SKILL.md → KITS.md / TASK_MAP.md → INDEX.md 查找本地资料。

能力总览

| 能力 | 适用场景 | 入口 | | --- | --- | --- | | API 参考 | ArkTS、ArkUI、系统模块、API 版本确认 | JsEtsAPIReference/INDEX.md | | Kit / 任务导航 | 按 Kit 或任务定位文档 | KITS.md · TASK_MAP.md | | API 26 快照 | API 26.0.0 声明、类型和签名 | api26/ | | DevEco / Emulator | HVD、hdc、uitest、抓包和诊断 | DevEco模拟器私有接口与AI自动化.md | | 最小工程 | Empty Ability、构建和 smoke 测试 | empty-ability-app | | 自动化脚本 | 设备证据、UI/UX、Trace、命令行工具 | scripts/ |

关键词入口：抓包诊断、DevEco 模拟器自动化、filesystem skill、Codex plugin。

推荐检索路径

SKILL.md → KITS.md / TASK_MAP.md → INDEX.md → 目标文档

安装方式

• Gemini CLI：gemini skills install https://github.com/linhay/harmony-next.skills --path harmony-next --scope user
• Claude Code：npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy
• Codex：npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy
• DSH：dsh plugin --profile demo add github:linhay/harmony-next.skills

empty-ability-app smoke fixture：references/templates/empty-ability-app。

私有接口工作流必须先阅读对应的私有接口文档，并明确产物目录、脱敏边界和非交互模式。

python3 harmony-next/scripts/sync_api26_snapshot.py \
  --deveco-app /path/to/DevEco-Studio.app
python3 harmony-next/scripts/reference_compat.py generate

python3 harmony-next/scripts/check_packaging_docs.py
python3 harmony-next/scripts/reference_compat.py check
python3 -m unittest discover -s harmony-next/tests -p 'test_*.py' -v

版本

| 当前发布 | 说明 | | --- | --- | | v1.3.37 | API 26.0.0 Release 声明快照 已纳入；官网 guide、示例和差异说明持续补充 |

许可证

MIT。文档来源为华为 HarmonyOS 官方资料，版权归原作者所有。