前言¶
在明道云 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 。
