skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
qfeius/make-platform-skills97 installs

make-app-approval

当新建、迭代或检查 Make App 前台审批接入时使用:需求确认后的默认审批导航、BPM/bpmDefinitionKey、审批新建字段、BPM 独立新建与任务页、保存并提交、未提交记录发起、撤回、退回后继续提交、流程状态与标题 Tag,以及 @qfei-design/make-app-approval 我的审批包、待处理/已完成/已发起、任务及实例详情和审批历史。不负责流程设计器、Console 审批管理、后端审批引擎或未经确认的终态重新发起。

How do I install this agent skill?

npx skills add https://github.com/qfeius/make-platform-skills --skill make-app-approval
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a professional framework for integrating approval workflows into applications. It demonstrates high security maturity, emphasizing server-side validation, credential protection, and strict boundary enforcement between the UI, service layers, and the backend engine. While it includes verification scripts that execute code, these are intended for development-time integration testing.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Make App 前台审批完整接入

把已确认的功能方案转为应用级审批入口,完成业务记录发起/撤回、我的审批列表与办理、历史和状态同步。每个应用只保留一个“我的审批”;业务对象仍使用自己的记录列表。本文及参考文件为可移植合同,不依赖某个示例项目、私人路径或业务字段。

工作顺序

  1. 从已确认的方案提取业务对象、用户实际写入动作及审批处理能力,读取 默认生成规则。先给出生成或不生成的业务依据,不能只搜“表单”“提交”等词。方案未说明是否存在写入/审批能力时,只确认这一缺失事实,不擅自补功能。
  2. 调研宿主导航、Schema、普通 CRUD、字段渲染器、附件/Lookup、请求与权限层及测试;核对实际安装的审批包版本、公开入口和类型。说明拟改文件、复用点和验证方案,不将示例项目的业务限制推广到平台。
  3. 完整接入时按下表覆盖所有适用落点。含业务新建能力的方案即使当前没有流程绑定,也生成运行时双分支;仅审批处理的方案不新增业务新建页。完整交付不能只放导航占位页。
  4. 使用现有 UI → Service → Make 链路,先同步宿主 API 文档。包拥有的列表/详情状态机直接复用;宿主适配器、字段序列化和请求分层,不复制包实现。桌面/手机共享数据和业务合同,分别按实际组件能力完成 View。
  5. 按 验证场景 为宿主行为先补失败测试,再实现。实际包能力、宿主回归、浏览器验收和真实审批写入联调分别报告;只运行技能检查不能宣称应用已接通。

涉及三方审批独立入口时,按 独立页面合同 先列出当前 App 的能力映射。Console 为统一管理端,各 App 适配自身表单、控件和业务规则;样板目录与代码不作为所有项目的必需结构。

按落点读取

落点参考
是否生成、导航位置、多端复用默认生成规则
审批新建字段、保存与保存并提交发起侧合同
同 key 绑定刷新、迟到保存结果、未知结果与撤回取消边界宿主时序桥接合同、随包行为验证器;必须接入宿主真实控制器
飞书等深链的 BPM 独立新建、待处理/已完成任务页及存量迁移独立页面合同(与 makeui 配合,复用表单及公共任务状态机)
独立页对象定位与逐次附件预上传的边界参考安全边界参考(非 npm API;宿主仍须验证自身真实链路)
未提交发起、失败恢复、发起人撤回、重新发起边界记录生命周期
包版本、公开入口、控件适配、我的审批列表与筛选包与列表
已发起页签、实例只读详情及实例独立链接已发起与实例详情
节点字段、同意/拒绝/退回/继续提交、任务附件及失败恢复任务详情与办理
Service 路由、Workflow Target、DTO、Long ID 与信封接口合同
配置/详情读取、发起、办理及撤回的业务错误提示公共错误文案合同,同时保留本 Skill 的失败恢复规则
节点字段完整枚举、配置保留、成功响应与异常边界节点字段转换合同
Service 可复用纯转换、宿主转换验证及响应样例参考转换器、行为验证器、脱敏夹具
Lookup 节点内关系、目标最小描述与单/多选依赖合同、纯解析器、行为验证
业务详情流程区、任务与实例历史插槽、完整时间线与共用结果审批历史、历史结果适配器
业务列表/详情流程状态、标题 Tag 和普通编辑限制状态展示与禁编合同、旧包兼容适配器
升级后核验 UI/Service 实际安装包的普通记录禁编行为公开入口验证器(参数为宿主包目录,检查 ESM/CJS,不替代入口及保存回归)
核验宿主已安装包的只读策略兼容性包校验脚本
已完成/无动作任务的宿主只读策略参考代码参考适配器(先读任务详情合同)
手机列表、混合编辑详情、时间线、底栏和导航移动端适配、纯布局适配器(同时读取 makeui 手机规范)
接入验收与回归场景验证场景

必须保持的边界

  • 导航是方案决策。 业务新增、录入、编辑保存,或明确审批处理需求即可触发;不要求先绑定流程。无任务、全部流程停用或解绑后仍保留已生成入口及历史访问路径。
  • 入口独立位于最外层。 “我的审批”是一级菜单,桌面/平板中紧接所有业务对象/模块分组之后,与其他菜单在同一导航列表中按正常间距排列、共同滚动;不固定到侧栏底部,不单独增加分隔区。它不属于任何对象、模块或可折叠分组,折叠分组不会隐藏它;手机为它保留一个底部 Tab,并按剩余容量展示业务对象和工作台,总数不超过五项。具体布局与复用规则见 默认生成规则。
  • 新建是运行时决策。 按 实体流程绑定 从 Workflow 独立批量查询 bpmDefinitionKey,不再从 Schema 取值或回退;绑定加载/失败时暂停依赖它的创建和首次发起并提供重试,普通浏览、编辑和历史仍按原规则可用。绑定不等于发起授权。
  • 审批新建字段独立授权。 使用 bpm-start-config.fields 的 readable/editable;字段定义直接取同次 bpm-start-config 响应的 data.formMetadata,再交给 UI;不另请求元数据或兼容旧字段对象。不与普通 IAM 字段集合或 createFields 求交。应用、对象、新建操作、关联目标和后台最终授权仍保留。
  • 任务办理另用当前节点授权。 任务详情的 fieldPermission/actions 决定字段和动作;字段基础定义取同次 bpm-task 响应的 data.formMetadata,不从普通 entity 或 Schema 获取。节点字段定义不代表全部可见或可写;不能套普通编辑字段或启动节点字段,也不经普通记录 PATCH 保存任务修改。
  • 区分新建提交和已有记录发起。 仅保存不发起;新建“保存并提交”使用一次 bpm-process-submit,不先普通创建再发起。已有记录仍用原 bpm-process。发起前查询当前登录人的所属部门,多部门时选择 starterDepartmentId;普通保存和任务 SUBMIT 不触发部门选择。错误沿用 code=200 成功、其他 code 显示对应信息的统一处理,不增加“核查流程”按钮;合并提交失败码不等于记录未创建,落库结果未确认时阻止重复创建,详见 保存会话。
  • 已有记录的发起与保存独立。 对象有有效 BPM 绑定、记录明确 UNSUBMITTED 且未锁定时,业务详情保留独立“发起审批”,不要求普通编辑权限且不执行普通保存,也不读取 START 字段或附加普通 CRUD 权限;最终发起资格交 Workflow。具备普通编辑资格时,编辑页另提供“保存”和“保存并提交”,沿用原 IAM、记录权限及原 ID。保存会话内的失败恢复仍只执行尚未完成的发起阶段。
  • 恢复与继续提交分开。 已有记录仅明确 UNSUBMITTED 且未锁定时首次发起;RETURNING 通过当前任务 SUBMIT“继续提交”继续原实例。已撤回/拒绝/通过的记录不生成终态重新发起。
  • 撤回由真实发起人资格决定。 读取最新流程及 starter,确认时重查;使用 appKey/entityKey/recordId 定位,不需要 bpmKey,不以业务申请人或普通编辑权限推断资格。
  • 状态来自记录。 qfei_process_instance_status 是只读系统字段;不新建同名 DSL 业务字段,不用业务状态、任务结果、锁字段或当前绑定推导流程状态。
  • 审批运行态及三种终态禁止普通编辑。 IN_APPROVAL、RETURNING、APPROVED、REJECTED、CANCELLED 或明确锁定的记录隐藏普通编辑按钮/菜单,单元格不得进入编辑或接受迟到提交;已通过、已拒绝、已撤回即使解锁也保持只读。入口、保存及后台写入共同执行 禁编合同。公共包 0.2.13 尚未原生覆盖已拒绝、已撤回,须统一宿主适配;不把普通禁编套到当前节点授权的任务办理,删除资格仍独立判断。

与现有 Skill 配合

落点责任
makeuiShell、导航、Drawer/手机任务页、宿主字段控件与外观;本 skill 定义审批分支、包接线、字段与动作合同
make-app-permission普通 IAM、应用/对象/操作权限;审批新建与任务办理分别消费 Workflow 授权,普通 CRUD 不受放宽
make-app-service请求、登录、配置、缓存、Trace 与透传;本 skill 提供 Workflow 接口映射及节点/附件授权边界
make-app-observability公共业务 msg/message、Trace 与统一错误出口;审批包的操作建议不能覆盖后端原因,文案不决定失败恢复资格
make-app-actions普通记录操作入口、预检及批量能力;消费同一锁判断,不复制审批任务动作
canvas-table-integration桌面列表的只读系统列;手机沿用卡片,不为状态展示新增表格
makedsl业务对象建模;不为流程状态或锁补业务字段,不生成流程定义

交付范围

完整接入包含导航、审批新建与首次发起、未提交记录恢复、撤回、列表/详情状态、任务中心 npm 接入、节点字段编辑与办理、退回继续提交、审批历史、成功后刷新及错误恢复。特定改动只读取相应参考,保留已有完整能力。

不生成流程定义/设计器、Console 管理、跨应用任务中心或后台引擎。手机列表先核对 包与列表 的产物门禁,使用公共包手机模式;手机详情复用公开布局插槽,历史 View 按参考接入并验证,不能复制列表/办理 Controller 或虚构包 API。发现实际安装包能力缺失或后端写入/状态回读不一致时说明具体缺口,不以假数据、静默补写或移除授权检查冒充完整接入。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/qfeius/make-platform-skills/make-app-approval">View make-app-approval on skillZs</a>