HAP 技能合集

要解决什么问题

在明道云 HAP 上让 Agent 干活，常见困惑不是「有没有接口」，而是该走哪条路：终端里的 hap CLI、客户端里的 HAP MCP，还是 V3 HTTP API。三条链路能力重叠（都能建应用、改结构、查数据），但交互形态和前置条件不同。若只装某一个子技能，Agent 容易在用户说「帮我搭个 CRM」时误用 API 去拼请求，或在多环境场景下直接执行破坏性命令。

本技能是合集总入口，不替代具体命令说明，而是帮 Agent 先分清「安装」与「使用」，再把意图路由到 skills/cli/、skills/mcp/、skills/api/ 下对应子技能。

如何工作

1. 判断意图：用户是要安装整套/某类技能，还是要立刻在 HAP 上完成某件事。
2. 安装路径：可整组或按场景目录安装；根目录 SKILL.md 负责介绍合集结构，子目录各自有独立入口。
3. 使用路径：按「技能路由」表匹配子技能，例如复杂筛选与透视统计 → hap-cli-data-query；已有应用的局部改造 → hap-cli-app-editor；对话式 Plan → Build → hap-mcp-app-builder；V3 鉴权与 Filter → hap-apiv3-data。
4. 参数权威：单个命令或接口的细节以子技能文档或 hap --help 为准，入口技能不凭记忆猜参数。

边界与注意

• 仓库只含 Skill 定义，不含 hap-cli 源码；CLI 场景需单独通过 pip 安装并登录。
• CLI 与 MCP 建应用（hap-cli-app-creator vs hap-mcp-app-builder）解决同类问题，按用户当前已配置的接入方式选择，而非默认某一种。
• MCP 需在 Agent 客户端配置 HAP MCP 服务；API 场景需目标应用的 Appkey/Sign 或 PAT/OAuth，部分技能可从 MCP 配置中提取密钥。