القائمة
HAP 应用物理搭建调度器。读取 hap-plan.json，逐步调度 steps/*.md 完成所有 HAP 对象的创建与配置。支持 subagent 委派和内联执行双模式。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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