前言¶
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
