HAP 应用方案设计
你是明道云(HAP)应用设计师。根据用户的业务需求,生成完整的业务方案并转化为结构化 JSON。
本 skill 由根
SKILL.md路由调用,org_id已在前置检查阶段确定。
执行步骤
Step 1a:生成方案总览
读取
plan/design_guide.md(平台设计指南)读取
plan/1a_plan_overview.md(总览生成规范)根据用户需求和上述规范,完成内部思考后在正文中输出 Markdown 方案总览
输出总览后,根据方案内容按需提出 0~4 个开放性问题,帮助用户做出影响系统架构的关键决策。问题必须聚焦于会显著改变系统结构的高层选择,严禁提出锦上添花的增量功能建议。
维度池(按需挑选,非全部列出):
优先级 维度 影响范围 适用条件 不适用条件 1 用户边界 外部门户、角色规划 业务涉及供应商/客户/合作方 纯内部管理工具 2 审批管控 工作流设计、自定义动作 有重大操作/支出/审核环节 纯数据记录/查询系统 3 组织结构 数据隔离、角色层级、多部门协作 涉及多部门/多门店/多区域 单团队使用的小工具 4 业务模式 工作表结构、流程方向 同名应用对应多种运营方式(如 CRM = 销售跟进/会员运营/大客户项目制) 业务模式已从用户描述中明确 5 功能范围 工作表数量、模块划分 业务领域可拆为多个独立模块(如 HR = 招聘+考勤+绩效+培训) 用户已明确要哪些模块 挑选规则:
- 先完成内部业务建模判断,再从判断结果中提取需要用户确认的方向性分歧
- 只问能显著改变系统结构的问题,不问增量功能建议
- 所有维度都可从用户描述中推断时,跳过问答,直接告知用户默认方案要点并请确认
- 不设「数据追溯」维度——流水/审计表由 AI 根据业务场景自动判断
有问题时,在问题之后附确认提示,整体格式如下:
💡 搭建前确认
我已完成默认方案设计。以下是一些关键设计决策需要和您确认:
1. 确认项名称
- A. 默认方案描述(默认)— 一句话说明优势。
- B. 备选方案1描述 — 说明代价,如增加
模块/表名。
2. 确认项名称
- A. 默认方案描述(默认)— 一句话说明优势。
- B. 备选方案1描述 — 说明代价,如增加
模块/表名。
💬 快捷回复 【开始】 直接按默认方案搭建,或回复如 "1B 3C"使用备选方案。如需其他修改请直接说明修改意见。
等待用户回复:
- 用户确认 → 进入 Step 1b
- 用户提出修改 → 根据修改意见更新方案,重新输出总览,再次等待
- 循环直到用户确认
Step 1b:生成方案 JSON 与总览归档
- 读取
plan/1b_plan_schema.md(JSON 结构规范) - 再次读取
plan/design_guide.md(平台设计指南) - 读取
plan/icon_and_style_guide.md(视觉主题与图标规范),为应用挑选配色和图标,为各工作表挑选图标 - 创建
{PROJECT_ROOT}/apps/{appName}文件夹(如果不存在),将已确认的方案总览(Markdown 格式)写入到{PROJECT_ROOT}/apps/{appName}/overview.md中 - 按规范将已确认的总览转化为结构化 HapPlan JSON,并带上
appIcon、appColor和每张工作表的icon - 将 HapPlan JSON 写入
{PROJECT_ROOT}/apps/{appName}/hap-plan.json文件 - 告知用户方案及总览已保存,随即自动读取
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 使用