메뉴
用 hap 命令行工具（CLI）修改一个已存在的 HAP 应用里的某个具体元素时用本 skill。只要用户说「在某表加个字段」「把这个视图改名」「修改工作流」「给某角色加权限」之类、针对已有应用做单点局部修改，就触发。不触发：增删改业务记录、查询数据、写调 hap 的代码；从零搭整个新应用请改用 hap-mcp-app-builder。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
HAP 应用物理搭建调度器。读取 hap-plan.json，逐步调度 steps/*.md 完成所有 HAP 对象的创建与配置。支持 subagent 委派和内联执行双模式。
全自动一站式 HAP 应用构建器。从业务方案设计（Plan）开始，确认后自动物理搭建（Build）。若已存在方案，可直接一键继续/恢复物理搭建。用户输入 /hap-builder 或直接用对话描述您的系统诉求（如"帮我搭建一个客户管理应用"）触发。
用 hap-cli 命令行工具操作 HAP 企业平台，是 hap-cli skills 的主入口。覆盖通讯录、聊天消息、发动态、管日程，以及应用与数据操作（工作表记录增删改查、工作流、审批待办、自定义页面、角色权限、文件上传等）。只要用户想在 HAP 里查人、发消息、发动态、看/建日程、读写某张表的记录、处理审批，即使没明说工具名也应触发。
HAP 应用方案设计。根据用户业务需求生成完整的方案总览与结构化 JSON，确认后自动触发物理搭建。由根 SKILL.md 路由调用。
用 hap 命令行查询/筛选/统计 HAP 工作表里的业务数据时用本 skill——尤其当筛选条件复杂、需要多条件 AND/OR、嵌套分组，或要做透视表聚合统计（求和/计数/平均/分组维度）。只要用户说「查某张表里满足…条件的记录」「按状态/日期筛选数据」「这个筛选器怎么写」「统计每个月/每个分类的合计」「做个透视/汇总」，即使没明说工具名也应触发。不用于：写入数据（增删改记录用 record 命令）。
**立即触发条件**：用户提到"HAP 搭建网站"、"HAP 前端项目"、"HAP 作为数据库"、"企业官网"、"官网"、"通过 HAP 搭建"、"用 HAP 做网站"、"HAP 网站"、"搭建官网"、"前后端分离"、"内容管理系统"、"HAP 前端"、"HAP 官网"。提供完整的 HAP + 前端项目搭建指南，包括 HAP 后台配置、前端项目结构、API 集成和数据渲染。
| name | hap-cli-app-editor |
| description | 用 hap 命令行工具（CLI）修改一个已存在的 HAP 应用里的某个具体元素时用本 skill。只要用户说「在某表加个字段」「把这个视图改名」「修改工作流」「给某角色加权限」之类、针对已有应用做单点局部修改，就触发。不触发：增删改业务记录、查询数据、写调 hap 的代码；从零搭整个新应用请改用 hap-mcp-app-builder。 |
你对一个已存在的 HAP 应用做精确的局部修改：增、删、改单个元素（工作表 / 字段 / 视图 / 角色权限 / 自定义动作 / 工作流与节点 / 自定义页面与组件 / 应用与分组）。 如果是要增删改业务数据，请遵从 hap-cli 主 Skill 直接调用 hap 命令.
默认入口是裸 hap 命令 —— 绝大多数元素编辑就是一条命令：
hap worksheet view update <ws_id> <view_id> --name "进行中的订单"
hap workflow publish <process_id>
hap app role add-member <role_id> --user-ids <account_id> -a <app_id>
只有三类编辑走 edit-spec（hap app-editor），因为它们的安全写法是「读出整体 → 改一处 → 整体写回」，徒手做容易静默丢数据：
| 编辑对象 | edit-spec op | 为什么不能裸做 |
|---|---|---|
| 已有字段的修改/删除/重排 | field.update / field.delete / field.reorder | 必须整表控件集写回，否则系统反向控件会被静默丢掉 |
| 页面组件增删改 | component.add / component.update / component.delete | 页面布局是一个整体 components 数组，必须读改写 |
| 动作按钮新建/修改 | custom-action.create / custom-action.update | 高层 action_spec 自动翻译成按钮配置并接好关联流程 |
（新增字段 field.add 也在 edit-spec 里，与其它 field op 用同一份写法。）其余一切元素——工作表、视图、角色、工作流、节点、页面本身、应用与分组——直接用命令，各模块的命令与参数字典见下方索引。
hap auth whoami 确认已登录且选好组织；未登录让用户先 hap auth login。hap app list-managed 确认目标 app 在列表里；不在则不要硬试，告知用户需要管理员授权或换账号登录。hap app-editor inspect <appId或应用名> 打印应用的「逻辑名 → id」全结构（工作表、视图、角色、工作流、页面、分组…）。后续命令要的各种 id 都从这里拿；更细的 id 用各模块的 list/info 命令。hap --json worksheet view info <ws_id> <view_id>hap --json workflow node get <process_id> <node_id>hap --json worksheet fields <ws_id> --rawhap --json custom-page info <app_id> <page_id>
字典没覆盖的键，以读到的实际结构为准——照形改写永远是安全的。hap app-editor validate <spec.json>（纯本地）→ plan（dry-run 预演）→ apply。各模块字典表的「值形态」列分三档：
"1"=显示 "2"=隐藏；controlId 的 JSON 数组；| 类型 | 用在哪 |
|---|---|
| FilterCondition | 视图筛选、业务规则、按钮 enableWhen、图表筛选、页面筛选组件 |
| SortItem | 视图多重排序、工作流节点 sorts |
| WireControl | 字段的原始控件对象（读写通用货币） |
| OperateCondition | 工作流节点/分支条件（不是 FilterCondition，字段名是 filedId） |
| WorkflowAccounts | 工作流收件人（type 语义反直觉，必读） |
| WorkflowFieldWrite | 数据节点字段写入（$nodeId-fieldId$ 动态模板） |
一个典型的 HAP 工作表视图页面地址：/app/<app_id>/<section_id>/<worksheet_id>/<view_id>。一个典型的 HAP 工作表行记录页面地址：/app/<app_id>/<worksheet_id>/<view_id>/row/<rowid>。
按要操作的元素只读对应那一份（每份 = 调用范式 + 数据字典）：
多元素联动场景（一个目标要串多条命令）见 references/scenarios/，每个场景一份文档，含命令顺序与 id 传递。三类 edit-spec 的可直接套用样例在 examples/（field / component / custom-action 各一份）。
"confirm": true；裸命令的删除类一律带 --yes/-y 二次确认，不传 -y 时会交互式询问（非交互环境下直接中止）。-y 只是跳过提示，不等于授权——任何删除动手前都先取得用户明确同意。