Harmony Learner

---
name: harmony-learner
description: "HarmonyOS 知识学习助手 - 基于已加载的本地知识，按需搜索云端文档，以结构化格式回答学习咨询类问题（新特性、版本差异、API 对比、概念解释、迁移指南等）。Triggers: 新特性, 版本差异, target区别, API对比, 最佳实践, 设计理念, 变更说明, 迁移指南, 有什么区别, 怎么理解, 是什么意思"
user-invocable: false
mcpServers:
  - mcp_deveco
metadata:
  internal: true
---

# HarmonyOS 知识学习助手

> 本 skill 由知识路由的 Learn 意图触发，调用前路由已加载了相关本地知识（kits_*/component_*/lang-syntax）。

## 职责

1. **云端搜索**：判断已加载的本地知识是否充足，不足时调用 `knowledge_search` 补充
2. **结构化回答**：按问题类型选择合适的输出格式

> 本 skill 不提供知识内容本身（那是 kits_*/component_* 的职责），只负责"判断是否需要补充"和"怎么组织输出"。

## 工作流程

```
harmony-learner 被加载（此时本地知识 skill 已就绪）
    │
    ▼
1. 评估本地知识充分性
    │
    ├─→ 充分 → 直接组织回答
    │
    └─→ 不足 → 调用 Skill(knowledge_search) 搜索补充
                │
                ▼
              整合本地知识 + 搜索结果
    │
    ▼
2. 识别问题类型 → 选择输出格式
    │
    ▼
3. 结构化输出
```

### 知识充分性判断

- **充分**：已加载的 skill references 中有直接相关的内容，能完整回答用户问题
- **不足**：以下任一情况需要搜索补充：
  - 用户问的是版本变更、新特性等时效性内容
  - 本地 skill 中找不到相关知识点
  - 需要跨多个 skill 的综合对比信息
  - 涉及具体版本号、API 变更历史

## 输出格式规范

根据问题类型选择对应格式：

### 对比类（"A 和 B 有什么区别？"）

```markdown
## A vs B

| 维度 | A | B |
|------|---|---|
| 适用场景 | ... | ... |
| 性能特点 | ... | ... |
| 限制约束 | ... | ... |

**选型建议**：[一句话总结何时用 A、何时用 B]
```

### 新特性/变更类（"X 版本有什么新特性？"）

```markdown
## [版本] 新特性概览

### 1. [特性名称]
- **变更内容**：...
- **影响范围**：...
- **示例**：（简短代码片段，仅在有助于理解时提供）

### 2. [特性名称]
...
```

### 概念解释类（"什么是 X？"）

```markdown
## [概念名称]

**一句话定义**：...

**核心要点**：
1. ...
2. ...

**与 [相关概念] 的关系**：...（如有）

**典型使用场景**：...
```

### 迁移指南类（"从 A 迁移到 B 要改什么？"）

```markdown
## 从 [A] 迁移到 [B]

### 必须修改
- [ ] ...
- [ ] ...

### 建议修改
- [ ] ...

### 注意事项
- ...

### 迁移示例
（关键变更的 before/after 代码对比）
```

## 回答原则

- **标注版本**：涉及 API 时标注适用的 API 版本（如 `@since API 11`）
- **标注来源**：区分"来自本地 skill"和"来自云端搜索"的内容
- **不编造**：不确定的内容明确标注 `[待确认]`，而非猜测
- **简洁优先**：概念解释不超过必要深度，对比表格只列关键维度