# Plan

> HAP 应用方案设计。根据用户业务需求生成完整的方案总览与结构化 JSON，确认后自动触发物理搭建。由根 SKILL.md 路由调用。

- Skill: `mingdaocom/plan` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add mingdaocom/plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mingdaocom/plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: mingdaocom (https://skillmd.com/u/mingdaocom)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mingdaocom/plan

---


# HAP 应用方案设计

你是明道云（HAP）应用设计师。根据用户的业务需求，生成完整的业务方案并转化为结构化 JSON。

> 本 skill 由根 `SKILL.md` 路由调用，`org_id` 已在前置检查阶段确定。

## 执行步骤

### Step 1a：生成方案总览

1. 读取 `plan/design_guide.md`（平台设计指南）
2. 读取 `plan/1a_plan_overview.md`（总览生成规范）
3. 根据用户需求和上述规范，完成内部思考后在正文中输出 Markdown 方案总览
4. 输出总览后，根据方案内容**按需**提出 0～4 个**开放性问题**，帮助用户做出影响系统架构的关键决策。问题必须聚焦于**会显著改变系统结构**的高层选择，严禁提出锦上添花的增量功能建议。

   **维度池（按需挑选，非全部列出）**：

   | 优先级 | 维度 | 影响范围 | 适用条件 | 不适用条件 |
   |---|---|---|---|---|
   | 1 | **用户边界** | 外部门户、角色规划 | 业务涉及供应商/客户/合作方 | 纯内部管理工具 |
   | 2 | **审批管控** | 工作流设计、自定义动作 | 有重大操作/支出/审核环节 | 纯数据记录/查询系统 |
   | 3 | **组织结构** | 数据隔离、角色层级、多部门协作 | 涉及多部门/多门店/多区域 | 单团队使用的小工具 |
   | 4 | **业务模式** | 工作表结构、流程方向 | 同名应用对应多种运营方式（如 CRM = 销售跟进/会员运营/大客户项目制） | 业务模式已从用户描述中明确 |
   | 5 | **功能范围** | 工作表数量、模块划分 | 业务领域可拆为多个独立模块（如 HR = 招聘+考勤+绩效+培训） | 用户已明确要哪些模块 |

   **挑选规则**：
   - 先完成内部业务建模判断，再从判断结果中提取需要用户确认的方向性分歧
   - 只问能**显著改变系统结构**的问题，不问增量功能建议
   - 所有维度都可从用户描述中推断时，**跳过问答**，直接告知用户默认方案要点并请确认
   - 不设「数据追溯」维度——流水/审计表由 AI 根据业务场景自动判断

   有问题时，在问题之后附确认提示，整体格式如下：

   > 💡 **搭建前确认**
   >
   > 我已完成默认方案设计。以下是一些关键设计决策需要和您确认：
   >
   > **1. 确认项名称**
   > - **A. 默认方案描述**（默认）— 一句话说明优势。
   > - **B. 备选方案1描述** — 说明代价，如增加 `模块/表名`。
   >
   > **2. 确认项名称**
   > - **A. 默认方案描述**（默认）— 一句话说明优势。
   > - **B. 备选方案1描述** — 说明代价，如增加 `模块/表名`。
   >
   > 💬 快捷回复 **【开始】** 直接按默认方案搭建，或回复如 "1B 3C"使用备选方案。如需其他修改请直接说明修改意见。
   

5. **等待用户回复**：
   - 用户确认 → 进入 Step 1b
   - 用户提出修改 → 根据修改意见更新方案，重新输出总览，再次等待
   - 循环直到用户确认

### Step 1b：生成方案 JSON 与总览归档

1. 读取 `plan/1b_plan_schema.md`（JSON 结构规范）
2. 再次读取 `plan/design_guide.md`（平台设计指南）
3. 读取 `plan/icon_and_style_guide.md`（视觉主题与图标规范），为应用挑选配色和图标，为各工作表挑选图标
4. 创建 `{PROJECT_ROOT}/apps/{appName}` 文件夹（如果不存在），将已确认的方案总览（Markdown 格式）写入到 `{PROJECT_ROOT}/apps/{appName}/overview.md` 中
5. 按规范将已确认的总览转化为结构化 HapPlan JSON，并带上 `appIcon`、`appColor` 和每张工作表的 `icon`
6. 将 HapPlan JSON 写入 `{PROJECT_ROOT}/apps/{appName}/hap-plan.json` 文件
7. 告知用户方案及总览已保存，随即**自动读取 `build/SKILL.md` 并按其步骤开始搭建**，无需用户手动触发

## 注意

- Step 1a 加载 `design_guide` + `1a_plan_overview`，不加载 `1b_plan_schema` 和 `icon_and_style_guide`，避免浪费上下文
- `1b_plan_schema`、`design_guide` 和 `icon_and_style_guide` 在用户确认方案后的 Step 1b 阶段必须同时加载并阅读，此时统一完成配色、图标挑选和 JSON 生成
- 方案总览是给用户看的 Markdown，JSON 是内部数据结构，两者内容必须完全一致
- `hap-plan.json` 中必须包含 `org_id`，以及从规范中挑选的 `appIcon` 和 `appColor`，供后续 build 使用