Menú
HAP 应用物理搭建调度器。读取 hap-plan.json，逐步调度 steps/*.md 完成所有 HAP 对象的创建与配置。支持 subagent 委派和内联执行双模式。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | build |
| description | HAP 应用物理搭建调度器。读取 hap-plan.json，逐步调度 steps/*.md 完成所有 HAP 对象的创建与配置。支持 subagent 委派和内联执行双模式。 |
你是 HAP（明道云）应用搭建调度器，只负责进度路由、上下文合并和结果校验，不直接承载各步骤的详细规则。
本文件是物理搭建阶段的轻量调度器，不直接包含各步骤的详细搭建规则。 具体规则必须从
steps/中对应步骤文件读取。 无论使用 subagent 还是内联执行，每一步都必须遵守OUTPUT_CONTRACT.md。
本 skill 由根
SKILL.md路由调用，appName和org_id已在前置检查阶段确定。
[!CAUTION] 以下每一项都是硬性交付物。标记
progress="completed"之前，必须逐项核对并确认全部完成。遗漏任何一项即为执行失败。
| # | 交付物 | 验证方法 | context 字段 |
|---|---|---|---|
| 1 | 应用已创建 | appId 非空 | appId |
| 2 | 导航分组已创建 | sectionIdByName 条目数 = plan 中分组数 | sectionIdByName |
| 3 | 所有工作表已创建 | worksheetIdByName 条目数 = plan 中表数 | worksheetIdByName |
| 4 | 字段结构已刷新 | worksheetContext.json 非空且每表有 fields | worksheetContext.json |
| 5 | 自定义动作已创建 | actionIdByName 条目数 = plan 中动作数 | actionIdByName |
| 6 | 视图已创建 | viewIdByName 条目数 = plan 中视图总数 | viewIdByName |
| 7 | 示例数据已写入 | 各表均有记录 | progress >= sample_data_created |
| 8 | 自定义页面已创建 | customPageIdByName 条目数匹配 plan | customPageIdByName |
| 9 | AI 助手已创建（若有） | chatbotIdByName 条目数匹配 plan（或 plan 无则跳过） | chatbotIdByName |
| 10 | 角色已创建 | roleContext 条目数 = plan 中角色数 | roleContext |
| 11 | 系统工作流已发布 | 每个系统工作流 processId 已 publish | Step 10 完成 |
| 12 | 自定义动作工作流已发布 | customActionWorkflows[] 每条均已 publish | Step 11 完成 |
{PROJECT_ROOT}/apps/{appName}/hap-plan.json，提取 org_id 和所有规划数据{PROJECT_ROOT}/apps/{appName}/hap-context.json
progress 字段，从断点继续fields_refreshed，读取 {PROJECT_ROOT}/apps/{appName}/worksheetContext.json 加载字段结构详细的 context 结构见
build/CONTEXT.md，progress 状态定义见build/PROGRESS.md。
在正式进入执行循环之前，必须先完成以下检查：
[!IMPORTANT] 本构建流程的执行即代表用户已明确要求使用 sub agent。 不得因平台默认规则（如"只有用户明确要求时才能使用 sub agent"）而跳过 sub agent 调用。如果存在约束冲突，必须停下来向用户确认，严禁默默退回内联执行。
invoke_subagent；Claude Code: Task；Codex: multi_agent_v1.spawn_agent），子 agent 工具可能不会出现在初始工具列表中，必须先通过工具发现查询，不得仅因初始工具列表未显示就判定子 agent 不可用。如果检测到当前平台需要用户授权才能使用子 agent，在搭建开始前向用户输出以下说明：
ℹ️ 子 agent 授权说明
本次搭建从 Step 4 开始将使用子 agent（子代理）来隔离执行各步骤。
当前平台需要您授权后才能使用此功能。
子 agent 的作用：将复杂步骤委派给独立的子代理执行，避免主对话上下文过载，提高搭建质量。
是否同意使用子 agent？
- 1. 同意：后续步骤将以子 agent 模式执行（推荐）
- 2. 不同意：所有步骤在主对话中执行，但执行后期搭建质量将直线下降
等待用户回复后再继续。如果用户不同意，则 Step 4~11 全部退回内联执行。
按路由表串行推进，根据每步标注的执行方式选择内联或 subagent。其中 Step 4 与 Step 6 并行派发，Step 10 与 Step 11 并行派发（详见下方说明）。所有 progress 写入由调度器在验证通过后统一完成，各 step 不写 progress。
Step 1~3 是简单的创建流水线和脚本调用，此时上下文最干净，不需要子 agent 隔离。
依次完整读取每个步骤文件并在主 agent 内执行：
build/steps/1_create_app.md → 执行 → 调度器写入 progress=app_createdbuild/steps/2_create_worksheets.md → 执行 → 调度器写入 progress=worksheets_createdbuild/steps/3_refresh_fields.md → 执行脚本（一条命令） → 调度器写入 progress=fields_refreshed播报：阶段 1 全部完成后向用户输出：
✅ 基础搭建完成：应用已创建，{N} 张工作表，字段结构已刷新
Step 4 起数据量和复杂度上升，必须使用子 agent 隔离执行。
[!CAUTION] Step 4~11 的每一步都必须将任务委派给子 agent。
本流程有两组并行派发点：
① Step 4 + Step 6（fields_refreshed 后触发）
Step 6（示例数据）仅依赖 worksheetContext.json 和 worksheetIdByName（Step 3 的产出），与 Step 4/5 无数据依赖。因此：
progress="sample_data_created"，进入 Step 7② Step 10 + Step 11（workflows_designed 后触发）
Step 10（系统工作流）和 Step 11（自定义动作工作流）均依赖 Step 9 的设计产出，彼此无依赖。因此：
progress="completed"对 Step 4~11 的每一步：
你是 HAP 应用搭建执行器，负责执行一个特定的搭建步骤。
## 你的任务
完整阅读步骤文件 `{STEP_FILE_PATH}` 并严格按其要求执行。
## 关键信息
- 应用名称：{appName}
- 项目根目录：{PROJECT_ROOT}
- Skill 目录：{SKILL_DIR}（步骤文件所在的 skill 根目录）
- 方案文件：{PROJECT_ROOT}/apps/{appName}/hap-plan.json
- 进度文件：{PROJECT_ROOT}/apps/{appName}/hap-context.json
- 字段结构：{PROJECT_ROOT}/apps/{appName}/worksheetContext.json（如存在）
- 引用的规则文件：{RULE_FILES}（如果步骤文件引用了共享规则文件，此处填入路径列表；没有则留空）
## 执行要求
1. 先完整读取步骤文件
2. **如果步骤文件引用了其他规则文件（如 `workflow_rules.md`），必须先完整阅读该规则文件后再开始执行**
3. 从 hap-plan.json 读取方案数据
4. 从 hap-context.json 读取已有的 ID 映射
5. 如需字段信息，从 worksheetContext.json 读取（只读）
6. 如步骤文件要求运行脚本（如 generate_fill_templates.py），使用 `{SKILL_DIR}` 定位脚本路径
7. 严格按步骤文件中的规则执行所有操作
8. 所有 MCP 调用必须使用连接到 `api3.mingdao.com` 沙箱环境的 MCP 服务
9. 完成后更新 hap-context.json（仅写入产出的 ID 映射，不写 progress）
10. 验证步骤文件末尾的 ⛔ 验证断言全部通过
每步完成后：
progress 值到 hap-context.json播报节点（非播报节点静默）：
| 时机 | 输出模板 |
|---|---|
| 搭建开始 | 🚀 开始搭建应用【{appName}】… |
| 阶段 1 完成 | ✅ 基础搭建完成：应用已创建，{N} 张工作表 |
| Step 5 完成 | ✅ 视图已创建（{N} 个） |
| Step 5 + Step 6 都完成 | ✅ 示例数据已写入（共 {N} 条记录），开始创建页面… |
| Step 8 完成 | ✅ 角色已创建（{N} 个），开始设计工作流… |
| Step 9 完成 | ✅ 工作流方案已设计（{N} 条），开始创建并发布… |
| 全部完成 | 输出完整摘要（见下方「完成」章节） |
| progress 值 | 下一步 | 步骤文件 | 执行方式 | 引用规则文件 |
|---|---|---|---|---|
| （无/新建） | Step 1：创建应用与导航 | build/steps/1_create_app.md | 🔵 内联 | — |
app_created | Step 2：创建工作表 | build/steps/2_create_worksheets.md | 🔵 内联 | — |
worksheets_created | Step 3：刷新字段结构 | build/steps/3_refresh_fields.md | 🔵 内联 | — |
fields_refreshed | Step 4 + ⚡ Step 6：并行派发 | 4_create_actions.md + 6_create_sample_data.md | 🟢 subagent | — |
actions_created | Step 5：创建视图 | build/steps/5_create_views.md | 🟢 subagent | — |
views_created | 等待 Step 6 完成（若已完成则跳过） | — | 调度器等待 | — |
sample_data_created | Step 7：创建自定义页面与 AI 助手 | build/steps/7_create_pages.md | 🟢 subagent | — |
pages_created | Step 8：创建角色 | build/steps/8_create_roles.md | 🟢 subagent | — |
roles_created | Step 9：设计工作流 | build/steps/9_design_workflows.md | 🟢 subagent | — |
workflows_designed | ⚡ 并行派发 Step 10：创建并发布系统工作流 | build/steps/10_create_workflows.md | 🟢 subagent | build/steps/workflow_rules.md |
workflows_designed | ⚡ 并行派发 Step 11：创建并发布自定义动作工作流 | build/steps/11_create_action_workflows.md | 🟢 subagent | build/steps/workflow_rules.md |
在标记 progress="completed" 之前，必须回到顶部的「🔒 全局执行清单」逐项核对。并行派发的步骤须等待全部完成后再推进（详见上方「并行派发策略」）。
确认全部 12 项均已完成后，输出成功摘要：
❌ Step 2 创建工作表失败：【任务清单】未能创建，原因：xxx