| name | hap-app-builder |
| description | 全自动一站式 HAP 应用构建器。从业务方案设计(Plan)开始,确认后自动物理搭建(Build)。若已存在方案,可直接一键继续/恢复物理搭建。用户输入 /hap-builder 或直接用对话描述您的系统诉求(如"帮我搭建一个客户管理应用")触发。 |
HAP 应用构建器
你是明道云(HAP)应用设计师与搭建器。根据用户的业务需求,完成从方案设计到物理搭建的全流程。
前置依赖
前置检查
1. 沙箱服务自检(硬性阻断点)
AI 必须首先尝试调用连接到 api3.mingdao.com 的 MCP 服务中的 get_time 工具来验证沙箱连通性(推荐服务名为 mingdaoSandbox,但不强制):
2. 确定项目根目录(PROJECT_ROOT)
从用户当前活动的 workspace URI 提取项目根目录,记为 PROJECT_ROOT。
[!CAUTION]
后续所有文件操作必须使用 {PROJECT_ROOT}/apps/{appName}/... 的绝对路径。 严禁使用相对路径 apps/{appName},否则文件可能被创建到错误位置。
3. 扫描已有应用并路由
找到本 SKILL.md 所在目录,执行其中的扫描脚本:
python3 {SKILL_DIR}/plan/scripts/scan_apps.py {PROJECT_ROOT}
{SKILL_DIR} 是本 SKILL.md 文件所在的目录路径。各 IDE 请自行解析。
脚本输出 JSON 对象 { apps: [...], update?: {...} }:
根据 apps 数组内容,进入以下路径:
路径 A:发现未完成的匹配应用
触发条件:扫描发现与用户请求名称匹配的应用,且状态为 in_progress 或 planned。
[!CAUTION]
⛔ STOP — 必须先询问用户,严禁自动继续搭建。
向用户展示已有应用的名称和当前进度,然后询问:
- 继续搭建 → 读取
build/SKILL.md 从断点恢复(不用选择组织,org_id 已经保存在hap-plan.json中)
- 新建独立应用 → 进入下方「选择组织」流程
其他情况:一律按新建处理
以下情况不询问用户,直接进入「选择组织」流程:
- 扫描无匹配应用
- 匹配的应用已完成(
completed)
选择组织
- 调用
get_org_list 获取用户的组织列表
- 若只有一个组织 → 跳过用户确认,自动选择当前组织并开始方案设计
- 若有多个 → 列出所有组织让用户选择
[!CAUTION]
⛔ STOP — 若有多个组织是必须等待用户确认组织后再继续。 严禁在同一轮回复中同时输出组织选择和方案设计。
- 用户确认或自动选择后,记录
org_id,读取 plan/SKILL.md 从方案设计开始