前言¶
在明道雲 HAP 上做開發，常見幾條路都不夠順手：想改一個應用結構，要在網頁後臺裏一層一層點；想用 V3 API 查一批數據，鑑權（Appkey/Sign/PAT/OAuth）和 Filter 篩選的坑要自己趟；想讓 AI 幫忙搭個官網，它只會給你貼代碼，不會幫你把 HAP 當後端連起來。hap-skills 就是爲這類問題準備的：把自然語言描述的業務需求，變成真實建好的應用、查出來的數據、搭起來的網站。
這是什麼¶
hap-skills 是一套面向明道雲 HAP 平臺的 AI Agent 技能合集，由社區發佈者 user_175d84c3 維護，當前版本 1.0.1，來源 community，分類 dev-programming。它圍繞三種操作 HAP 的方式組織，共 9 個技能：
- CLI 場景（基於 hap 命令行）：日常協作與應用建設；
- MCP 場景（基於 HAP MCP 服務）：對話式全自動構建應用；
- API 場景（基於 HAP V3 HTTP 接口）：面向開發者的接口調用、建站與插件開發。
SkillHub 頁面顯示評分 100000、下載 1564（以官方頁面實時數據爲準）。標籤 requires_api_key=false，即不需要預先配置 API key。
核心功能¶
整套合集採用「總入口 + 子技能」結構。根目錄的 SKILL.md 是統一入口，負責介紹合集、引導一鍵安裝，並把用戶需求自動路由到最合適的子技能；技能按 cli/mcp/api 分目錄存放，既可整組安裝，也能按需單裝。AI 會根據意圖（建應用、改應用、查數據、搭網站、做接口、開發插件）自動切換技能，用戶不必記憶具體技能名稱。
9 個子技能分工如下：
- hap-cli：總入口，負責安裝登錄、選組織應用，並導航通訊錄、聊天、動態、日程、審批待辦等一級命令；
- hap-cli-app-creator：從一句業務需求一站式建出真實可用、帶示例數據的完整應用；
- hap-cli-app-editor：針對已有應用做精確的局部修改（字段、視圖、角色權限、工作流等）；
- hap-cli-data-query：專攻複雜查數，處理多條件篩選與透視聚合統計；
- hap-cli-environments：多環境多賬號場景下確保操作落在正確的環境，破壞性操作前先確認；
- hap-mcp-app-builder：對話式全自動構建應用——先設計方案，確認後自動物理搭建，支持中斷後續建；
- hap-apiv3-data：講清鑑權（Appkey/Sign/PAT/OAuth）、Filter 篩選與記錄增刪改；
- hap-api-website：指導用 HAP 當後端、前後端分離搭建企業官網或內容管理系統；
- hap-view-plugin：覆蓋自定義視圖插件（mdye）的開發全流程。
安裝與啓用¶
官方資料給出的部署方式是：將整個倉庫上傳到技能庫，即可一次性部署全部能力；也可以按 cli、mcp、api 目錄按需單裝。根目錄 SKILL.md 作爲統一入口，安裝後由 AI 自動路由到對應子技能，無需用戶手動指定。
以通用 SKILL.md 技能庫爲例，典型做法是：
# 獲取倉庫後，將倉庫根目錄放入所用 Agent 的技能庫目錄
# Cursor: ~/.cursor/skills/hap-skills
# Claude Code: ~/.claude/skills/hap-skills
# 也可直接上傳整個倉庫到技能庫，實現整組部署
具體上傳方式以所用 Agent 的官方文檔和 SkillHub 頁面爲準，各環境（Cursor / Codex CLI / Claude Code）的目錄約定可能不同。
典型用法¶
按官方資料，幾個可直接復現的用法：
- 建應用：向 AI 描述一句業務需求（如「建一個進銷存應用」），hap-cli-app-creator 會一站式建出帶示例數據的完整應用；
- 改應用：對已有應用提出局部修改（加字段、調視圖、改角色權限、加工作流），由 hap-cli-app-editor 精確執行；
- 查數據：描述多條件篩選和透視聚合需求，hap-cli-data-query 輸出統計結果；
- 多環境操作：在多環境多賬號場景下，hap-cli-environments 先確認環境再執行，破壞性操作前需確認；
- 對話式建應用：hap-mcp-app-builder 先出設計方案，確認後自動物理搭建，中斷後可續建；
- 接口開發：hap-apiv3-data 覆蓋鑑權與增刪改查，hap-api-website 指導前後端分離建站，hap-view-plugin 覆蓋 mdye 插件開發全流程。
適用場景與注意¶
適合三類人：日常在 HAP 上建應用、改結構的業務人員；需要複雜查數和透視統計的用戶；基於 HAP V3 API 開發網站、接口和自定義視圖插件的開發者。
幾點注意：
- 多環境、多賬號場景務必啓用 hap-cli-environments，破壞性操作前確認環境，避免誤操作；
- V3 API 相關技能要求使用者具備基本的 HTTP 接口和前後端分離基礎；
- 標籤 requires_api_key=false，不強制配置 API key，但 MCP 場景需要可用的 HAP MCP 服務；
- 9 個技能功能有重疊（CLI 與 MCP 都能建應用），按需單裝即可，不必整組安裝。
結尾¶
hap-skills 的價值在於把 HAP 的三種操作方式（命令行、MCP、V3 API）統一封裝成一套可路由的技能，讓 AI 直接完成建應用、改應用、查數據、搭網站、做接口、開發插件這些具體任務。官方地址：https://api.skillhub.cn/user_175d84c3/hap-skills ，SkillHub 頁面：https://www.skillhub.cn/skills/user_175d84c3/hap-skills 。
