{"id":47183253,"url":"https://github.com/linhay/harmony-next.skills","last_synced_at":"2026-05-03T21:02:07.638Z","repository":{"id":343997614,"uuid":"1179983747","full_name":"linhay/harmony-next.skills","owner":"linhay","description":"🚀 Expert guidance for HarmonyOS NEXT (API 12+) development. Covers IDE operations, performance tuning, architecture (HAP/HAR/HSP), and automation testing.","archived":false,"fork":false,"pushed_at":"2026-04-30T03:30:36.000Z","size":20217,"stargazers_count":86,"open_issues_count":2,"forks_count":10,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-30T04:25:42.400Z","etag":null,"topics":["arkts","automation-testing","deveco-studio","harmonyos","harmonyos-next","openharmony","performance-tuning"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linhay.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-12T15:24:50.000Z","updated_at":"2026-04-30T03:30:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/linhay/harmony-next.skills","commit_stats":null,"previous_names":["linhay/harmony-next.skills"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/linhay/harmony-next.skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linhay%2Fharmony-next.skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linhay%2Fharmony-next.skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linhay%2Fharmony-next.skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linhay%2Fharmony-next.skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linhay","download_url":"https://codeload.github.com/linhay/harmony-next.skills/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linhay%2Fharmony-next.skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32584651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arkts","automation-testing","deveco-studio","harmonyos","harmonyos-next","openharmony","performance-tuning"],"created_at":"2026-03-13T08:07:44.104Z","updated_at":"2026-05-03T21:02:07.632Z","avatar_url":"https://github.com/linhay.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HarmonyOS NEXT 开发者专家技能包\n\n给 Gemini CLI、Claude Code、Codex 等 AI 编程助手使用的 HarmonyOS NEXT 离线参考技能库。\n\n[![release](https://img.shields.io/badge/release-v1.3.1-1f6feb?style=flat-square)](https://github.com/linhay/harmony-next.skills/releases/tag/v1.3.1)\n[![readme](https://img.shields.io/badge/readme-English-0f766e?style=flat-square)](./README_en.md)\n![docs](https://img.shields.io/badge/docs-3,622%20markdown%20files-7c3aed?style=flat-square)\n![js-ets](https://img.shields.io/badge/JsEtsAPIReference-3,598%20files-b45309?style=flat-square)\n\n\u003e 面向 API 12-23 的本地知识源，覆盖 ArkTS、ArkUI、NDK、工具链、调试、发布与多端适配。\n\n## 它解决什么问题\n\n`harmony-next.skills` 不是普通文档镜像，而是一套给 AI 编程助手使用的 HarmonyOS NEXT 检索层。\n\n它主要解决这几类问题：\n\n- `@ohos.*` 模块到底在哪个文件\n- 某个 ArkUI 组件、接口或 NDK 头文件是否真的存在\n- API 23 新增内容有没有纳入当前知识库\n- 某个旧链接是否已经迁移、是否还能跳转\n\n这个仓库的目标，是把这些问题变成可定位、可跳转、可验证的本地文件查询。\n\n## 核心特性\n\n| 能力 | 说明 |\n| --- | --- |\n| 离线可检索 | 不依赖模型记忆猜 API，先命中文档路径再读取正文 |\n| 面向 Agent 工作流 | 按 `SKILL.md -\u003e KITS/TASK_MAP -\u003e INDEX` 组织，适合渐进式检索 |\n| 不只 API 手册 | 还包含 IDE、签名、调试、发布、性能、多端与 NDK 实战指引 |\n\n## 内容概览\n\n| 模块 | 说明 | 入口 |\n| --- | --- | --- |\n| 技能规则 | 告诉 Agent 如何检索、如何回答、哪些内容要优先信文档 | [`harmony-next/SKILL.md`](./harmony-next/SKILL.md) |\n| Kit 导航 | 按 AbilityKit、ArkUI、ArkData、MediaKit、Security 等缩小检索范围 | [`references/KITS.md`](./harmony-next/references/KITS.md) |\n| 任务导航 | 按 UI、生命周期、网络、媒体、NDK、发布等任务反查关键词 | [`references/TASK_MAP.md`](./harmony-next/references/TASK_MAP.md) |\n| 全库索引 | 收录整个参考库的 Markdown 路径，用于先命中路径再读正文 | [`references/INDEX.md`](./harmony-next/references/INDEX.md) |\n| API 分桶索引 | 聚焦 `JsEtsAPIReference/`，覆盖 modules、topics、types、errors、guides | [`JsEtsAPIReference/INDEX.md`](./harmony-next/references/JsEtsAPIReference/INDEX.md) |\n| 参考正文 | 共 `3,622` 份 Markdown，其中 `3,598` 份在 `JsEtsAPIReference/` | [`harmony-next/references/`](./harmony-next/references/) |\n\n## 推荐检索路径\n\n```text\nSKILL.md\n  -\u003e KITS.md / TASK_MAP.md\n  -\u003e INDEX.md\n  -\u003e 目标 Markdown 正文\n```\n\n为什么这样设计：\n\n1. 先定规则，避免 Agent 一上来就盲读大库。\n2. 再按 Kit 或任务缩小范围，减少误命中。\n3. 用索引命中真实路径，而不是凭名称想当然。\n4. 最后只打开 1-3 个目标文件读 API 细节。\n\n这套结构的核心是：先找路径，再读内容。\n\n## 适用场景\n\n### ArkTS / ArkUI 开发\n\n- 组件、装饰器、状态管理、导航、UIAbility、Want\n- API 版本差异、参数签名、返回值确认\n- 组件示例与文档跳转恢复\n\n### NDK / Node-API / C API\n\n- 头文件对应到真实 `topics/**/\u003cheader\u003e.h.md`\n- 跨语言互调、CMake、原生能力接入\n- 旧路径迁移后的索引与链接校验\n\n### IDE / 工具链 / 调试\n\n- 签名、模拟器、真机、断点调试\n- 独立命令行工具链与 CI/CD 集成\n- 性能分析与发布流程\n\n### Agent 工程化集成\n\n- Gemini CLI、Claude Code、Codex\n- 本地知识库检索层\n- 避免幻觉、提升可追踪性与可复现性\n\n## 快速接入\n\n### Gemini CLI\n\n```bash\ngemini skills install https://github.com/linhay/harmony-next.skills --path harmony-next --scope user\n```\n\n### Claude Code\n\n1. 下载本仓库中的技能目录。\n2. 按需压缩技能文件夹。\n3. 在 Claude.ai 的 `Settings \u003e Capabilities \u003e Skills` 中上传。\n4. 或直接放进你的 Claude Code 技能目录。\n\n如果你只是想把仓库作为项目上下文附加：\n\n```bash\ngit clone https://github.com/linhay/harmony-next.skills.git\nclaude --add-dir /path/to/harmony-next.skills/harmony-next\n```\n\n### Codex\n\n更准确地说，这个仓库对 Codex 来讲是“技能/参考知识源”，不是一条 `npm install` 就完成的插件安装命令。\n\n推荐接入方式：\n\n1. 下载或克隆本仓库：\n\n```bash\ngit clone https://github.com/linhay/harmony-next.skills.git\n```\n\n2. 将 `harmony-next/` 目录放到 Codex 可读取的技能路径下。\n\n常见做法是放到你自己的 Codex 技能目录中，再让 Codex 从该目录加载；如果你已经有项目级技能目录，也可以直接把 `harmony-next/` 放进去。\n\n3. 如果你不是按“技能目录”接入，而是把它当项目内参考库使用，至少应让 Codex 优先读取这两个入口文件：\n\n- [`harmony-next/SKILL.md`](https://github.com/linhay/harmony-next.skills/blob/master/harmony-next/SKILL.md)\n- [`harmony-next/references/INDEX.md`](https://github.com/linhay/harmony-next.skills/blob/master/harmony-next/references/INDEX.md)\n\n一句话说清楚：对 Codex 来说，核心不是“安装一个包”，而是“把这份技能目录放到它会读取的位置”。\n\n## v1.2.0 重点\n\n| 版本 | 重点变化 |\n| --- | --- |\n| `v1.2.0` | API 23 相关内容纳入当前更新；重建 `references/INDEX.md` 与 `JsEtsAPIReference/INDEX.md`；移除旧 `capi/headers/*.md` 页面并改为直链真实目标；新增 `reference_compat.py` 与链接回归审计能力；同步中英文 README 与维护说明 |\n\n## 参考库维护\n\n当 `references/JsEtsAPIReference/` 发生同步、迁移或批量改写后，建议按下面顺序执行：\n\n```bash\npython3 harmony-next/scripts/reference_compat.py generate\npython3 harmony-next/scripts/reference_compat.py check\npython3 harmony-next/scripts/reference_compat.py audit\npython3 -m unittest discover -s harmony-next/tests -p 'test_*.py' -v\n```\n\n命令职责：\n\n- `generate`\n  - 把旧的 `../../capi/headers/*.md` 引用改写到真实 `topics/**/\u003cheader\u003e.h.md`\n  - 重建 `references/INDEX.md` 与 `references/JsEtsAPIReference/INDEX.md`\n- `check`\n  - 校验旧 `capi/headers/` 页面已删除\n  - 校验索引与磁盘一致\n  - 校验正文里没有残留旧路径引用\n- `audit`\n  - 扫描当前未提交改动\n  - 找出“原本有内部 Markdown 链接、现在被改成纯文本”的残留问题\n- `unittest`\n  - 校验迁移脚本与审计逻辑没有回归\n\n## 为什么值得接入\n\n| 价值 | 说明 |\n| --- | --- |\n| 更少幻觉 | 回答基于真实文档路径，而不是模型记忆补全 |\n| 更易追溯 | 每个答案都能落回具体 Markdown 文件 |\n| 更适合自动化 | 有索引、有规则、有校验，适合长期接入 Agent 工作流 |\n\n## 来源与许可\n\n- 数据源：华为 HarmonyOS 官方文档\n- 本仓库：为 AI 辅助开发工作流重新封装这些参考资料\n\n英文说明见 [README_en.md](./README_en.md)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinhay%2Fharmony-next.skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinhay%2Fharmony-next.skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinhay%2Fharmony-next.skills/lists"}