Skip to content

Commit bb10233

Browse files
committed
docs: add HarmonyOS AI development tools
1 parent 6678486 commit bb10233

19 files changed

Lines changed: 672 additions & 7 deletions

File tree

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
### 鸿蒙最大的 AI 编程知识库 · 让 11+ AI 工具真正会写 ArkTS
1010

11-
*4440 行实战知识 · 242 个章节 · 105+ 代码示例 · 生产覆盖 API 24,跟踪 HarmonyOS 7 / API 26 Beta1*
11+
*4450 行实战知识 · 242 个章节 · 105+ 代码示例 · 生产覆盖 API 24,跟踪 HarmonyOS 7 / API 26 Beta1*
1212

1313
[![License](https://img.shields.io/badge/License-MIT-yellow)](./LICENSE)
1414
[![HarmonyOS](https://img.shields.io/badge/HarmonyOS-6.1%20%2F%206.1.1-black)](https://developer.huawei.com/consumer/cn/)
@@ -28,7 +28,7 @@
2828
**问 Copilot `@ObjectLink` 怎么用,它说"这 API 不存在"?**
2929

3030
通用大模型从来没系统学过鸿蒙——它们的训练数据里几乎没有 ArkTS、Stage 模型、HarmonyOS Kit。
31-
所以我把华为官方文档、最佳实践、API 参考浓缩成一份**4440 行、可直接喂进 LLM 上下文**的知识包,从 ArkTS 严格语法到 60+ Kit、从液态玻璃到 AI super frame、从应用接续到 PersistenceV2,全都覆盖。
31+
所以我把华为官方文档、最佳实践、API 参考浓缩成一份**4450 行、可直接喂进 LLM 上下文**的知识包,从 ArkTS 严格语法到 60+ Kit、从液态玻璃到 AI super frame、从应用接续到 PersistenceV2,全都覆盖。
3232

3333
**一份 Markdown 源文件,自动产出 11+ AI 工具的配置。** 装上之后,AI 会像读过华为文档的工程师一样,给你符合鸿蒙规范的代码——而不是把 `@State` 写成 `useState`
3434

@@ -117,7 +117,7 @@ Skill 是一段领域知识(Markdown 格式),AI 编程工具会在对话
117117
<img src="./assets/knowledge-map.svg" alt="知识架构图" width="100%"/>
118118
</div>
119119

120-
这份知识包教会 AI 读写、审查和调试 HarmonyOS NEXT 原生应用所需的一切(**4440 行密集、可操作的知识,242 个章节,105+ 代码示例**):
120+
这份知识包教会 AI 读写、审查和调试 HarmonyOS NEXT 原生应用所需的一切(**4450 行密集、可操作的知识,242 个章节,105+ 代码示例**):
121121

122122
- **语言与框架** — ArkTS 严格模式规则、命名规范、13 条高性能编码规则(const、TypedArray、HashMap、lazy import 等)、编码风格指南
123123
- **应用架构** — Stage 模型:UIAbility、ExtensionAbility、AbilityStage、WindowStage 生命周期;module.json5 / app.json5 配置

README_EN.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
### The largest HarmonyOS knowledge pack for AI coding — make 11+ AI tools actually write ArkTS
1010

11-
*4,440 lines of battle-tested knowledge · 242 sections · 105+ code examples · production baseline API 24, tracking HarmonyOS 7 / API 26 Beta1*
11+
*4,450 lines of battle-tested knowledge · 242 sections · 105+ code examples · production baseline API 24, tracking HarmonyOS 7 / API 26 Beta1*
1212

1313
[![License](https://img.shields.io/badge/License-MIT-yellow)](./LICENSE)
1414
[![HarmonyOS](https://img.shields.io/badge/HarmonyOS-6.1%20%2F%206.1.1-black)](https://developer.huawei.com/consumer/cn/)
@@ -117,7 +117,7 @@ A skill is a chunk of domain knowledge (in Markdown) that an AI coding tool load
117117
<img src="./assets/en/knowledge-map.svg" alt="Knowledge architecture" width="100%"/>
118118
</div>
119119

120-
The skill teaches the AI everything needed to read, write, review, and debug HarmonyOS NEXT native apps (**4,440 lines of dense, actionable knowledge, 242 sections, 105+ code examples**):
120+
The skill teaches the AI everything needed to read, write, review, and debug HarmonyOS NEXT native apps (**4,450 lines of dense, actionable knowledge, 242 sections, 105+ code examples**):
121121

122122
- **Language & framework** — ArkTS strictness rules, naming conventions, 13 high-performance coding rules (const, TypedArrays, HashMap, lazy import, etc.), coding style guide
123123
- **App architecture** — Stage model: UIAbility, ExtensionAbility, AbilityStage, WindowStage lifecycles; module.json5 / app.json5 configuration

dist/agents-md/AGENTS.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,15 @@ Covers HarmonyOS 6.1 (API 23, stable) / 6.1.1 (API 24, Release) / HarmonyOS 7 de
144144
- UX testing supports multi-device layout comparison across straight-screen and foldable devices.
145145
- Test-service matrix includes local app listing precheck, performance baseline/monitoring, stability baseline, memory-leak testing, UX baseline and multi-device layout comparison, security baseline, power baseline, functional-experience baseline, exploratory testing, regression testing, device projection, UIViewer, app graph management, performance report auto-analysis, and report comparison.
146146

147+
**HarmonyOS AI development tools and capability highlights (officially surfaced 2026/06):**
148+
- **DevEco Code** — a HarmonyOS-focused AI coding Agent for planning, code generation, build/run, device logs, UI verification, ArkTS checking, knowledge lookup, debugging, and iterative repair. It complements DevEco Studio rather than replacing the SDK/toolchain.
149+
- **DevEco CLI** — Agent-friendly command-line access to project creation, syntax checks, build, device run/debug, and other HarmonyOS engineering actions; use it for third-party coding Agents, automation, and CI/CD integration.
150+
- **Agent Framework Kit** — launches a combination of system Agents from an app through UI controls. Keep it distinct from Intents Kit (declaring app intents), ArkTS script-based app Skills (exposing app capabilities), and device-side A2A (Agent-to-Agent communication).
151+
- **HarmonyOS 7 experience areas** — spatial-audio processing nodes, app/game quick start, cold-start network preconnection, QUIC and weak-network live-stream optimization, and LTPO variable frame rate are highlighted platform capabilities; confirm the installed API 26 SDK and device support before presenting them as generally available APIs.
152+
- **API 26 cloud debugging** — AGC remote-device cloud debugging can filter devices by API 26 or system version `7.0.0.23` for early compatibility validation.
153+
154+
For tool selection, capability boundaries, and answer rules, read `references/ai-development-tools.md`.
155+
147156
### Official documentation updates (2026/06/12)
148157

149158
Huawei's release docs did not add a newer SDK after 26.0.0 Beta1, but the documentation change log added several developer-facing guides worth surfacing in answers:
@@ -4448,6 +4457,7 @@ The root `SKILL.md` remains the discovery entry. These files are loaded only whe
44484457
| User intent | Read first | Then read |
44494458
|---|---|---|
44504459
| Version, SDK, DevEco Studio, API baseline | `platform-baseline.md` | `api26-preview.md` only for preview requests |
4460+
| DevEco Code/CLI, Agent Framework, app Skill, Intents, A2A | `ai-development-tools.md` | `api26-preview.md` for HarmonyOS 7 preview details |
44514461
| ArkTS syntax or TypeScript migration | `arkts-rules.md` | `../examples/*.ets` |
44524462
| ArkUI layout, components, rendering | `arkui-components.md` | `state-management.md` |
44534463
| Stage model lifecycle | `stage-model.md` | `../recipes/debug-build-error.md` |
@@ -4463,6 +4473,52 @@ Use API 24 Release as the production default unless the user explicitly targets
44634473

44644474
---
44654475

4476+
## harmonyos-development/references/ai-development-tools.md
4477+
4478+
# HarmonyOS AI Development Tools
4479+
4480+
Use this reference for DevEco Code, DevEco CLI, Agent Framework Kit, app Skills, Intents Kit, A2A, and HarmonyOS 7 AI-assisted development questions.
4481+
4482+
## Tool selection
4483+
4484+
| Need | Prefer |
4485+
|---|---|
4486+
| Full IDE editing, preview, profiling, signing, emulator, and graphical debugging | DevEco Studio |
4487+
| Agent-led HarmonyOS implementation and iterative build/run/verify/fix workflows | DevEco Code |
4488+
| Scriptable project, build, check, device, and debugging actions for Agents or CI/CD | DevEco CLI |
4489+
| General-purpose third-party coding Agent | Its native workflow plus DevEco CLI/Hvigor/HDC and this skill |
4490+
4491+
DevEco Code is a HarmonyOS-focused coding Agent, while DevEco CLI is the execution layer designed for command-line automation and Agent invocation. Neither changes the production SDK baseline: use API 24 Release by default and API 26 Beta1 only for preview/adaptation work.
4492+
4493+
## Agent capability boundaries
4494+
4495+
| Capability | Purpose |
4496+
|---|---|
4497+
| Agent Framework Kit | Let an app actively launch system Agent combinations through UI controls |
4498+
| Intents Kit | Declare app or atomic-service functions as system-recognizable intents |
4499+
| ArkTS script-based app Skill | Expose app business capabilities to system intelligent entry points through a declared contract |
4500+
| Device-side A2A | Connect an app-side Agent with system Agents using registered components, authenticated bidirectional communication, and interactive UI |
4501+
| AgentCard | Present Agent-related content or interaction through supported card capabilities |
4502+
4503+
Do not use these names interchangeably. First identify whether the user needs UI-triggered Agent invocation, intent exposure, an app Skill, Agent-to-Agent communication, or card presentation.
4504+
4505+
## HarmonyOS 7 capability notes
4506+
4507+
- Skill Vibe Coding assists app Skill development, debugging, review, and publishing.
4508+
- Visual AI, 3DGS, spatial-audio nodes, app/game quick start, cold-start network preconnection, QUIC, weak-network live-stream optimization, and LTPO variable frame rate are highlighted HarmonyOS 7 capability areas.
4509+
- Treat marketing-level capability descriptions as discovery signals, not stable API signatures. Verify the API 26 SDK reference, device category, permissions, and feature availability before generating production code.
4510+
- For AGC cloud debugging, filter remote devices by API 26 or system version `7.0.0.23` when validating HarmonyOS 7 compatibility.
4511+
4512+
## Answer rules
4513+
4514+
1. State whether the request is about DevEco Studio, DevEco Code, DevEco CLI, or a third-party Agent.
4515+
2. Keep API 24 production guidance separate from API 26 Beta preview guidance.
4516+
3. Name the exact Agent capability layer instead of using generic terms such as "HarmonyOS Agent API."
4517+
4. Do not invent DevEco CLI command names. Use installed-tool help or official documentation for exact commands and flags.
4518+
5. For device-dependent capabilities such as LTPO or spatial audio, require SDK and hardware support verification.
4519+
4520+
---
4521+
44664522
## harmonyos-development/references/api26-preview.md
44674523

44684524
# API 26 Preview Boundary

dist/claude-code/harmonyos-development/SKILL.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,8 @@
22
name: harmonyos-development
33
description: >
44
Use when developing, reviewing, debugging, or migrating HarmonyOS NEXT native apps
5-
with ArkTS, ArkUI, DevEco Studio, Stage model, UIAbility, .ets, module.json5,
5+
with ArkTS, ArkUI, DevEco Studio, DevEco Code, DevEco CLI, Agent Framework Kit,
6+
Stage model, UIAbility, .ets, module.json5,
67
oh-package.json5, HAP/HSP/HAR, API 22-24, API 26 Beta1, HarmonyOS 6.1,
78
HarmonyOS 6.1.1 Release, HarmonyOS 7 preview, HarmonyOS 26.0.0 Beta1,
89
state management decorators, Navigation/NavPathStack, ArkTS concurrency,
@@ -156,6 +157,15 @@ Covers HarmonyOS 6.1 (API 23, stable) / 6.1.1 (API 24, Release) / HarmonyOS 7 de
156157
- UX testing supports multi-device layout comparison across straight-screen and foldable devices.
157158
- Test-service matrix includes local app listing precheck, performance baseline/monitoring, stability baseline, memory-leak testing, UX baseline and multi-device layout comparison, security baseline, power baseline, functional-experience baseline, exploratory testing, regression testing, device projection, UIViewer, app graph management, performance report auto-analysis, and report comparison.
158159

160+
**HarmonyOS AI development tools and capability highlights (officially surfaced 2026/06):**
161+
- **DevEco Code** — a HarmonyOS-focused AI coding Agent for planning, code generation, build/run, device logs, UI verification, ArkTS checking, knowledge lookup, debugging, and iterative repair. It complements DevEco Studio rather than replacing the SDK/toolchain.
162+
- **DevEco CLI** — Agent-friendly command-line access to project creation, syntax checks, build, device run/debug, and other HarmonyOS engineering actions; use it for third-party coding Agents, automation, and CI/CD integration.
163+
- **Agent Framework Kit** — launches a combination of system Agents from an app through UI controls. Keep it distinct from Intents Kit (declaring app intents), ArkTS script-based app Skills (exposing app capabilities), and device-side A2A (Agent-to-Agent communication).
164+
- **HarmonyOS 7 experience areas** — spatial-audio processing nodes, app/game quick start, cold-start network preconnection, QUIC and weak-network live-stream optimization, and LTPO variable frame rate are highlighted platform capabilities; confirm the installed API 26 SDK and device support before presenting them as generally available APIs.
165+
- **API 26 cloud debugging** — AGC remote-device cloud debugging can filter devices by API 26 or system version `7.0.0.23` for early compatibility validation.
166+
167+
For tool selection, capability boundaries, and answer rules, read `references/ai-development-tools.md`.
168+
159169
### Official documentation updates (2026/06/12)
160170

161171
Huawei's release docs did not add a newer SDK after 26.0.0 Beta1, but the documentation change log added several developer-facing guides worth surfacing in answers:

dist/claude-code/harmonyos-development/references/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ The root `SKILL.md` remains the discovery entry. These files are loaded only whe
99
| User intent | Read first | Then read |
1010
|---|---|---|
1111
| Version, SDK, DevEco Studio, API baseline | `platform-baseline.md` | `api26-preview.md` only for preview requests |
12+
| DevEco Code/CLI, Agent Framework, app Skill, Intents, A2A | `ai-development-tools.md` | `api26-preview.md` for HarmonyOS 7 preview details |
1213
| ArkTS syntax or TypeScript migration | `arkts-rules.md` | `../examples/*.ets` |
1314
| ArkUI layout, components, rendering | `arkui-components.md` | `state-management.md` |
1415
| Stage model lifecycle | `stage-model.md` | `../recipes/debug-build-error.md` |
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# HarmonyOS AI Development Tools
2+
3+
Use this reference for DevEco Code, DevEco CLI, Agent Framework Kit, app Skills, Intents Kit, A2A, and HarmonyOS 7 AI-assisted development questions.
4+
5+
## Tool selection
6+
7+
| Need | Prefer |
8+
|---|---|
9+
| Full IDE editing, preview, profiling, signing, emulator, and graphical debugging | DevEco Studio |
10+
| Agent-led HarmonyOS implementation and iterative build/run/verify/fix workflows | DevEco Code |
11+
| Scriptable project, build, check, device, and debugging actions for Agents or CI/CD | DevEco CLI |
12+
| General-purpose third-party coding Agent | Its native workflow plus DevEco CLI/Hvigor/HDC and this skill |
13+
14+
DevEco Code is a HarmonyOS-focused coding Agent, while DevEco CLI is the execution layer designed for command-line automation and Agent invocation. Neither changes the production SDK baseline: use API 24 Release by default and API 26 Beta1 only for preview/adaptation work.
15+
16+
## Agent capability boundaries
17+
18+
| Capability | Purpose |
19+
|---|---|
20+
| Agent Framework Kit | Let an app actively launch system Agent combinations through UI controls |
21+
| Intents Kit | Declare app or atomic-service functions as system-recognizable intents |
22+
| ArkTS script-based app Skill | Expose app business capabilities to system intelligent entry points through a declared contract |
23+
| Device-side A2A | Connect an app-side Agent with system Agents using registered components, authenticated bidirectional communication, and interactive UI |
24+
| AgentCard | Present Agent-related content or interaction through supported card capabilities |
25+
26+
Do not use these names interchangeably. First identify whether the user needs UI-triggered Agent invocation, intent exposure, an app Skill, Agent-to-Agent communication, or card presentation.
27+
28+
## HarmonyOS 7 capability notes
29+
30+
- Skill Vibe Coding assists app Skill development, debugging, review, and publishing.
31+
- Visual AI, 3DGS, spatial-audio nodes, app/game quick start, cold-start network preconnection, QUIC, weak-network live-stream optimization, and LTPO variable frame rate are highlighted HarmonyOS 7 capability areas.
32+
- Treat marketing-level capability descriptions as discovery signals, not stable API signatures. Verify the API 26 SDK reference, device category, permissions, and feature availability before generating production code.
33+
- For AGC cloud debugging, filter remote devices by API 26 or system version `7.0.0.23` when validating HarmonyOS 7 compatibility.
34+
35+
## Answer rules
36+
37+
1. State whether the request is about DevEco Studio, DevEco Code, DevEco CLI, or a third-party Agent.
38+
2. Keep API 24 production guidance separate from API 26 Beta preview guidance.
39+
3. Name the exact Agent capability layer instead of using generic terms such as "HarmonyOS Agent API."
40+
4. Do not invent DevEco CLI command names. Use installed-tool help or official documentation for exact commands and flags.
41+
5. For device-dependent capabilities such as LTPO or spatial audio, require SDK and hardware support verification.

0 commit comments

Comments
 (0)