harmony-sdk-skills

# 百度地图 HarmonyOS NEXT Skills

本仓库提供一组面向 **HarmonyOS NEXT 百度地图** 平台的 AI Coding Agent Skills，帮助开发者在智能研发工具（如 Cursor / Claude Code等）中高效完成鸿蒙应用的创建、地图 SDK 集成与 ArkTS 代码开发。

## Skills 概览

本仓库包含以下三个 Skill：

| Skill | 说明 |
| --- | --- |
| [baidu-map-harmonyos-sdk](skills/baidu-map-harmonyos-sdk/) | 百度地图鸿蒙 SDK 开发助手 |
| [harmony-arkts-dev-assistant](skills/harmony-arkts-dev-assistant/) | HarmonyOS ArkTS 开发规范助手 |
| [harmony-empty-project](skills/harmony-empty-project/) | HarmonyOS NEXT 空工程模板生成器 |

---

### baidu-map-harmonyos-sdk

百度地图 HarmonyOS NEXT SDK 的完整开发辅助 Skill，覆盖以下核心能力：

- **地图展示与交互** — 地图组件初始化、手势控件、地图类型切换、个性化地图、室内图、离线地图等
- **覆盖物绘制** — Marker、折线、多边形、圆、气泡信息窗、点聚合、3D 模型、轨迹动画等
- **检索能力** — POI/AOI 检索、地理编码/逆地理编码、建筑物/行政区/天气/公交线路检索、推荐上车点等
- **路线规划** — 驾车、步行、骑行、公交、跨城公交路线规划
- **步骑行导航** — 导航引擎初始化、路线规划、导航控制与状态监听、默认导航 UI、模拟导航、语音播报
- **定位能力** — 前台/后台连续定位、单次定位、经纬度/地址/POI 获取
- **工具类** — 距离/面积计算、坐标转换、空间关系判断、调起百度地图客户端

支持独立包（`@bdmap/base`、`@bdmap/map`、`@bdmap/search`、`@bdmap/util`）和组合包（`@bdmap/map_walkride_search`、`@bdmap/navi_map`），以及定位 SDK（`@bdmap/locsdk`）。

### harmony-arkts-dev-assistant

HarmonyOS ArkTS 综合开发与类型安全最佳实践助手，在生成或重构 ArkTS/ArkUI 代码时提供规范约束，包括：

- 组件装饰器与状态管理（`@State`/`@Prop`/`@Link`/`@Provide`/`@Consume` 等）
- 生命周期规范与资源清理
- 样式布局链式调用顺序
- 类型安全与空值安全（通过 ArkTSCheck）
- 性能优化（对象缓存复用、LazyForEach、状态拆分、异步线程化）
- 错误处理、日志规范与代码审查清单

### harmony-empty-project

HarmonyOS NEXT 空工程模板生成器，可从零创建标准的 Stage 模型 + ArkTS 最小可运行工程，包括：

- 完整的工程目录结构（`AppScope`、`entry` 模块、`hvigor` 配置等）
- 标准配置文件（`oh-package.json5`、`build-profile.json5`、`module.json5` 等）
- 入口能力（`EntryAbility`）与首页（`Index.ets`）
- 资源文件与 SVG 图标占位
- 依赖管理与构建自检流程

---

## 适用环境

- **平台**：HarmonyOS NEXT Developer Preview1 及以上
- **开发工具**：DevEco Studio NEXT Developer Preview1 及以上
- **SDK 版本**：HarmonyOS NEXT Developer Preview1 SDK 及以上
- **设备**：标准系统，华为手机
- **ArkTS 版本**：API 12+

## 目录结构

```
harmony-sdk-skills/
├── CHANGELOG.md              # 变更日志
├── README.md                 # 本文件（中文）
├── README_EN.md              # English README
└── skills/
    ├── baidu-