qfeius/make-platform-skills

makedsl

Use when designing or generating Make platform DSL YAML — defining apps, entities, fields, relations, views, or record schemas.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/qfeius/make-platform-skills --skill makedsl

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

makedsl usage

Use this skill when you need to design or generate dsl for make platform or make 开发平台. make platform 从 kubernetes 和 ansible 中借鉴了设计思路, 业务的模型通过 DSL 建模定义, 然后通过 DataAPI 来对数据进行 CRUD-LS. 生成的 DSL(yaml) 文件应该通过 makecli 提交到 make platform (make 开发者平台)

Use canvas-table-integration for CanvasTable display, columns, renderers, or cell editing. makedsl only owns schema modeling semantics.

Runtime Boundary

确认方案后生成应用的完整前台审批(入口、发起/撤回、我的审批包、节点办理和历史),使用 make-app-approval。bpmDefinitionKey 由运行时 Meta 返回;qfei_process_instance_status 和 qfei_is_locked 为平台系统字段,不在 DSL 新建同名业务字段,不为“已保存”新增审批状态。业务已有生命周期字段继续保留。

  • DSL YAML is a design and deployment input, not a required runtime file for a published App Service.
  • Do not generate Service startup logic that hard-codes container paths such as /dsl/00-app.yaml.
  • Published Service should load schema from Make remote schema APIs or environment-provided config. Local DSL files are acceptable for development, fixtures, tests, and makecli apply, but must not be the only source required for k8s startup.
  • If a Service needs a fallback local schema for offline development, make it explicit and test both the remote-schema path and the fallback path.
  • When frontend build or published App runtime needs remote schema, use Meta Service APIs from @references/MetaAPIDesign.md instead of reading local DSL files.

Reference map

TopicRead
Make Meta API schema accessreferences/MetaAPIDesign.md
Make Data API and relation payloadsreferences/DataAPIDesign.md
Single-Entity aggregate API, dimensions, metrics, Lookup and NULL聚合统计; App integration belongs to make-app-service
Relation declarationsreferences/RelationDesign.md
Base field DSL and lookup fieldsreferences/FieldDesign.md
User field designreferences/UserFieldDesign.md
Department field designreferences/DepartmentFieldDesign.md
File field designreferences/FileFieldDesign.md
Entity data filter usagereferences/EntityDataFilterUsage.md

DSL定义

APP

逻辑概念上对应数据库的一个 database

APP DSL

yaml
key: <KEY> # 创建后不可更新, 只允许英文字符、数字、下划线, 长度 2-20
name: String # 必填, 用户可见的展示名称, 允许中英文数字下划线, 长度 2-20
type: Make.App
meta:
  version: SemanticVersion
properties:
  timezone: String? # 可选,如 "Asia/Shanghai"、"UTC";若未指定,使用系统默认"Asia/Shanghai"
  description: String?

约束条件

  • 所有 App 的 key 创建后不可更新, 在一个 org 下面唯一。
  • 所有 App 的 key 不能以下划线 (_) 开头,下划线开头是预留关键字。
  • 所有 App 的 name 是用户可见的展示名称。

App 例子

yaml
key: MatrixProject
name: 烽火项目管理
type: Make.App
meta:
  version: 1.0.0
properties:
  description: 烽火项目管理演示项目

Entity

逻辑概念上对应数据库 table 的一个 Table, 在底层实现是 ${App}.${Entity} 作为一个 TiDB 的 Table

Entity DSL

yaml
key: <KEY> # 仅英文字符、数字、下划线, 长度 2-20, 创建后不可更新
name: String # 必填, 用户可见的展示名称, 允许中英文数字下划线, 长度 2-20
type: Make.Entity
appKey: <Make.App>
meta:
  version: SemanticVersion
properties:
  fields:
    - Make.Field
    - Make.Field
    - ...

约束条件

  • 所有 Entity 的 key 创建后不可更新, 在一个 App 下面唯一。
  • 所有 Entity 的 key 不能以下划线 (_) 开头,下划线开头是预留关键字。
  • 所有 Entity 的 name 是用户可见的展示名称。

Entity 例子

项目 Entity

yaml
key: project
name: 项目
type: Make.Entity
appKey: <Make.App>
meta:
  version: 1.0.0
properties:
  fields:
    - key: project_name
      name: 项目名称
      type: Make.Field.Text
      meta:
        version: 1.0.0
      properties: null
    - key: project_description
      name: 项目描述
      type: Make.Field.TextArea
      meta:
        version: 1.0.0
      properties: null

任务 Entity

yaml
key: task
name: 任务
type: Make.Entity
appKey: <Make.App>
meta:
  version: 1.0.0
properties:
  fields:
    - key: task_name
      name: 任务名称
      type: Make.Field.Text
      meta:
        version: 1.0.0
      properties: null
    - key: task_description
      name: 任务描述
      type: Make.Field.TextArea
      meta:
        version: 1.0.0
      properties: null
    - key: task_status
      name: 任务状态
      type: Make.Field.SingleSelect
      meta:
        version: 1.0.0
      properties:
        options:
          - label: "待处理"
            value: "todo"
          - label: "进行中"
            value: "doing"
          - label: "已完成"
            value: "done"

Relation | 关联

  • Relation 是描述 Entity 之间关系的纯结构声明——谁和谁有关系、几对几。不涉及任何展示逻辑。(详见 @references/RelationDesign.md)
  • 关联数据的展示通过 LookupField 实现(详见 @references/FieldDesign.md)。
  • 关联数据写入时,需要在 Data API 的 data.qfei_relation 中显式传递关联对象。(详见: @references/DataAPIDesign.md)

Field | 字段

逻辑概念上对应数据库 table 的一个 column, 一个 Entity 会包含多个 Field 详情请见 @references/FieldDesign.md

Record | 记录

逻辑概念上对应数据库 table 的一个 row, 一个 Entity 会包含多个 Record

DataAPI | 数据 CRUD-LS

对数据的操作可以参考 @references/DataAPIDesign.md

MetaAPI | 元数据与 Schema

前端构建、运行时 schema 加载、实体/字段/关联元数据读取可以参考 @references/MetaAPIDesign.md

같은 저장소의 Skills

더 많은 Skills

모든 Skills
qfeius
커뮤니티

make-app-filter

Use when generating, integrating, reviewing, or debugging Make App record-list keyword search through Service filter.expression or advanced/conditional/table/header filtering with @qfei-design/make-app-filter. Triggered by 列表搜索, 关键词搜索, 筛选, 高级筛选, 条件筛选, 表格/表头/列头/按字段筛选, CEL/DNF, field-type operators, candidate values, and filter Preset save/echo. In search-only mode, use the package compiler without a filter panel or Preset lifecycle. In advanced-filter mode, use the package panel, permission-aware

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 10일
qfeius
커뮤니티

make-app-observability

Use when creating, integrating, reviewing, or debugging a Make App's default Trace ID chain, traceparent and X-Log-Id propagation, safe correlated logs, or @qfei-design/make-app-observability error notices. Every new Make App includes this baseline even when the user does not mention observability. Covers direct-gateway and Service-fronted Apps and AI transports when present. Does not own authentication, Service route design, AI protocol, tracing backend/exporter deployment, runtime packaging, o

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 10일
qfeius
커뮤니티

make-app-runtime

Use when generating, refactoring, reviewing, or debugging Make App project runtime structure, workspace manifests, Service runtime, local/dev scripts, build outputs, Docker/K8s image entrypoints, publish readiness, or packaging errors such as missing apps/service/dist/server.js. Covers apps/ workspace contracts, apps/ui/dist, apps/service port/build/start contracts, runtime config file location, runtime artifact tests, forwarded host/proto header preservation, and publish gates that include auth

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 10일
qfeius
커뮤니티

make-app-service

Use when generating, refactoring, reviewing, or debugging Make App apps/service APIs and UI-Service contracts, including server-side aggregation for dashboards, charts and 统计/汇总. Covers route design, apps/docs/api.md, layered structure, Make adapters, direct Make response passthrough, schema normalization including independent fields/createFields collections, record CRUD, record-write-permission and records/bulk, list filter/sort/groupFilter parsing, record groups, Entity Preset, candidate/looku

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 10일