前言¶
HarmonyOS 版本迭代快，API 废弃、Kit 边界和编译自检规则往往分散在文档与社区帖子里。你在 Cursor 或 Claude Code 里让模型写 ArkTS / ArkUI 时，容易踩到已废弃接口，或漏掉上架、模块化相关的约束。下面介绍 SkillHub 上的「鸿蒙代码工坊」——一个面向 HarmonyOS 7（API 26）的编码 Skill，把知识库和检查能力装进 Agent 的 Skill 体系，而不是每次从零拼提示词。
这是什么¶
「鸿蒙代码工坊」是 SkillHub 社区来源（community）的 dev-programming 类 Skill，坐标为 @user_8c9419f3/harmonyos-code-workshop，当前版本 6.2.0。官方页面由 Harmony-Lee 发布，标签标明 requires_api_key=false，安装后不需要额外 API Key。
一句话定位：HarmonyOS 7（API 26）全流程编码助手，内置 9700+ 行专家级知识库，侧重 ArkTS + ArkUI 原生鸿蒙代码生成与工程化约束。
- SkillHub 页面：https://www.skillhub.cn/skills/user_8c9419f3/harmonyos-code-workshop
- API 地址：https://api.skillhub.cn/user_8c9419f3/harmonyos-code-workshop
核心功能¶
以下能力均来自 SkillHub 官方简介，按模块归纳，不超出已公开描述。
质量与自检¶
- 废弃 API 自动检测：覆盖 51+ 组废弃 API 对照。
- 编译 5 维度自检：在生成或修改代码后，从多个维度做编译向的自查（具体维度由 Skill 内知识库定义）。
- 自我进化 5 大机制：Skill 侧声明的迭代与纠错机制（细节在 SKILL 正文与知识库中）。
- 50 道自测题：用于校验 Agent 是否按鸿蒙规范作答。
模板与速查¶
- 40 个代码模板：常见页面、能力接入的起步骨架。
- 76 个 Kit 速查：快速对齐 Kit API 与使用边界。
深度实战（Kit 与工程）¶
- 六大 Kit 深度：MediaKit、NetworkKit、SensorKit、NotificationKit、WebView、BackgroundTaskKit。
- 15 个领域实战案例。
- 数据持久化三剑客、HSP 模块化架构、CI/CD 上架全流程、Agent DSL 踩坑指南。
HarmonyOS 7 新能力（知识库覆盖）¶
Agent 架构、3DGS 端侧重建、碰一碰、空间音频、互动卡片、星盾安全等主题在简介中列为「新能力」方向，适合在对应需求下向 Agent 点名这些关键词。
安装与启用¶
安装流程以 SkillHub 官方说明为准：先具备 skillhub CLI，再把 Skill 装进当前 Agent 实际读取的 skills 目录（装错目录 Agent 不会加载）。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用官方一键脚本（完整安装含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
更完整的优先源与目录说明见：https://skillhub.cn/install/skillhub.md
2、安装本 Skill¶
官方页面给出的安装提示为：根据上述安装文档，安装坐标 @user_8c9419f3/harmonyos-code-workshop。
在终端中示例（将 <skills 目录> 换成你当前客户端的路径）：
skillhub install user_8c9419f3/harmonyos-code-workshop --dir <skills 目录>
常见目录（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端要求重启或重新加载 Agent，使 Skill 生效。
3、无 CLI 时的替代方式¶
SkillHub 页面亦支持把下面这句发给支持 Skill 的 AI，让其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_8c9419f3/harmonyos-code-workshop。
典型用法¶
官方未提供单独的「复制即用」业务代码仓库示例，典型用法是在已启用 Skill 的 Agent 会话里，用明确的目标 + API 级别 + Kit 名称发起任务。下面几类表述与 Skill 自述能力对齐，便于复现：
-
新页面 / 组件
说明 HarmonyOS 7、API 26，要求 ArkUI 声明式写法，并点名需要「编译 5 维度自检」与「废弃 API 检测」。 -
Kit 能力接入
例如：「用 NetworkKit 实现带证书校验的 HTTPS 请求，并对照 Skill 里 NetworkKit 深度章节补全错误处理。」 -
工程与上架
例如：「按 HSP 模块化拆分特性模块，并列出 CI/CD 上架流程中需要改动的配置项。」 -
HarmonyOS 7 新特性
例如：「实现互动卡片或空间音频相关能力，约束仅使用 API 26 文档中的接口。」
经过上面的步骤，Agent 会读取 Skill 内 9700+ 行知识库与模板，而不是仅依赖模型的通用鸿蒙记忆。
适用场景与注意¶
适合谁
- 主攻 HarmonyOS 7（API 26）、ArkTS + ArkUI 的原生应用开发者。
- 需要在 AI 辅助编码时，系统性避开废弃 API、对齐 Kit 用法与上架流程的团队。
- 已在 Cursor、Claude Code、Codex 等支持 Skill 目录的客户端中工作，并愿意用 SkillHub 管理 Skill 的开发者。
使用注意
- 版本以 SkillHub 为准（当前 6.2.0）；升级后能力描述可能变化，安装前可在页面核对简介。
skillhub install必须使用--dir指向当前 Agent 的 skills 目录，否则默认落在./skills/且可能不被识别。- 本 Skill 不需要 API Key；生成代码仍须在本地 DevEco Studio / 真机或模拟器上编译验证，Skill 不能替代官方 SDK 与签名环境。
- 社区来源 Skill：关键业务逻辑与安全相关实现，建议对照华为官方文档二次确认。
平台数据（SkillHub 抓取，供选型参考）
- 分类：dev-programming
- 评分：100000；下载：4805（页面统计会更新，以 SkillHub 实时显示为准）
结尾¶
「鸿蒙代码工坊」把 HarmonyOS 7 的知识库、废弃 API 检测、编译向自检、Kit 实战与上架流程收敛进一个 Skill，适合作为 ArkTS 日常开发的固定上下文。若你要在 Agent 里长期做 API 26 原生开发，可从官方页安装 @user_8c9419f3/harmonyos-code-workshop：
https://www.skillhub.cn/skills/user_8c9419f3/harmonyos-code-workshop
