qfeius/make-platform-skills

make-app-sort

Use when integrating, generating, refactoring, reviewing, or debugging Make App record-list sorting with @qfei-design/make-app-sort.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/qfeius/make-platform-skills --skill make-app-sort

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

make-app-sort

Treat toolbar sorting, CanvasTable header sorting, Entity Preset persistence, and Service records sort requests as one integrated capability. This Skill owns the consumer contract and sorting semantics; related Skills own their implementation surfaces.

This capability exposes controls only on desktop/tablet. The standard 手机/phone card list does not render a 排序 trigger or CanvasTable 表头/header actions. An already-applied sort may continue to order the shared ordinary-record query so width switching does not reorder data unexpectedly, but phone users cannot edit sort state unless the user explicitly requests a custom mobile sorting experience.

Workflow

  1. Inspect the host package manager, normalized runtime schema, permission gate,

Preset hook/routes, records request lifecycle, CanvasTable header APIs, and tests.

  1. Install @qfei-design/make-app-sort@^0.1.0. Read its package.ai.json and every

package.ai.json.readOrder entry, import only public exports and styles.css, and remove copied UI model, panel, styles, or drag behavior.

  1. Build candidates only from normalized runtime fields with a non-empty key and

capabilities.sortable === true. In the desktop/tablet host component adapter, show the default Make field-type icon before each sorting field option; do not decorate sort direction or other options.

  1. Establish a permission-aware object context. Load schema and Entity Preset,

sanitize saved sort, and only then allow the first records request.

  1. Use one host-owned outer Popover with package RecordSortPanel,

useRecordSortController, the host's public component adapter, and a stable resetKey token that changes whenever entity or access context changes.

  1. Connect CanvasTable asc/desc actions to the same controller through

openWithField(fieldKey, order?); header actions edit draft only.

  1. Let onConfirm persist only { sort }, let synchronous onApplied replace

applied state, and let a separate records lifecycle react to object context plus applied filter/sort. Always provide onApplyError.

  1. In Service, parse raw PATCH and records input with a strict transport parser,

validate fields against current runtime schema, then forward the ordered value to Make Data. Tolerant sanitization is only for saved/upstream reads.

  1. When the writable list uses make-app-actions, hand off the successfully

applied sort generation so actions clear selection and invalidate pending precheck/submit work before the new query is actionable. Draft edits, cancel, and save/apply failure preserve the current action selection.

  1. Add the model, UI, header, Preset, permission, concurrency, Service, stale

request, and conditional action-selection tests listed in the testing reference.

Topic reference map

Task / topicRead
Sort value, sortable capability, validation, sanitization, five-level limitreferences/sort-model.md
Panel UI, dnd-kit, draft lifecycle, openWithField, stylesreferences/ui-and-drag.md
Preset hydration, save-before-apply, records timing, stale requestsreferences/preset-and-data-flow.md
UI-Service routes, Make Preset adapter, records validation and payloadreferences/service-contract.md
TDD, integration checks, regressions and readinessreferences/testing-and-pitfalls.md
Toolbar placement and object-list layoutUse makeui
CanvasTable header menu and suffix mechanicsUse canvas-table-integration
Service route/adapter code and boundary logsUse make-app-service
Object/list access policy and permission gatesUse make-app-permission
Advanced-filter state and Preset filter persistenceUse make-app-filter
Grouping state, Preset group, record-groups, groupFilterUse make-app-group
Writable-list selection actions and applied-query invalidationUse make-app-actions

Non-negotiable invariants

  • Sorting is optional until requested or already present. On desktop/tablet, once in scope, deliver

toolbar sorting, CanvasTable header linkage, Preset persistence, and records sort together.

  • 手机/phone standard lists hide and do not render 排序/sort controls or CanvasTable 表头/header actions. Do not stack the desktop sort button into the phone toolbar.
  • Use only { fieldKey, order }[]. Reject legacy { field, order }, unknown keys,

invalid directions, duplicates, and more than five entries.

  • Treat array order as priority: index 0 is the highest-priority sort.
  • A field is sortable only when its normalized runtime schema has a non-empty key

and capabilities.sortable === true. Do not use a field-type allowlist, visible table columns, sample rows, or local DSL as the source of truth.

  • Keep applied sort and panel draft separate. Editing, dragging, adding, deleting,

clearing, outside click, and escape must not query records before confirm.

  • Use package useRecordSortController with resetKey, onConfirm, synchronous

onApplied, and required onApplyError. Do not put records requests in onConfirm or onApplied.

  • Save before apply. Preset writes are sparse, clear uses sort: [], and filter,

sort, and group dimensions never overwrite one another. Shared saving and error state must remain correct when filter and sort saves overlap.

  • Schema/Preset hydration and access checks gate the first records request. Object

or permission changes invalidate the old generation, panel, header menu, applied state, and table query context, including A -> B -> A.

  • CanvasTable header asc/desc actions only open or update the shared panel draft

through openWithField; they do not bypass confirm or call records directly.

  • Package helpers own UI model/draft behavior. Service owns strict raw-input parsing;

never use tolerant sanitization to accept an invalid PATCH or records query.

  • Search remains session-only. Do not persist keyword search in Entity Preset.
  • If make-app-actions is present, only a successfully applied sort generation

clears its selection and invalidates pending action work. Draft edits, panel cancel, validation failure, Preset save failure, and failed list queries do not clear or redefine the current action selection.

  • Add safe boundary logs at UI-Service adapters and Service route/adapters for

entry, success, failure, and stale-result branches. Never log cookies, tokens, secrets, Authorization, or full sensitive record data.

Grouping boundary

Grouping is owned by make-app-group and capabilities.groupable; this Skill must not add group UI, record-groups payloads, groupFilter expression composition, or Preset group writes. Sparse sort updates preserve the existing group dimension.

Handoffs

  • With makeui: place the optional sort trigger after filter and before refresh on desktop/tablet; the standard phone View hides it. This Skill owns sort behavior and state.
  • With canvas-table-integration: it owns header/menu mechanics; this Skill owns

the call to the shared sort panel.

  • With make-app-service: this Skill defines the contract; Service owns strict

parsing, routes, Make adapters, schema capability validation, logs, and tests.

  • With make-app-permission: it owns access policy; this Skill treats permission

enable/disable as an object-context transition that invalidates sort requests.

  • With make-app-filter: filter and sort share one Entity Preset lifecycle but

update dimensions independently and may save concurrently.

  • With make-app-group: group and sort share one Entity Preset lifecycle but

update dimensions independently. Sort applies to ordinary records and grouped leaf records, while grouping-mode record-groups requests ignore ordinary sort.

  • With make-app-actions: only for writable lists using the action workflow,

hand off a successfully applied sort generation before the new query becomes actionable so actions clear selection and invalidate pending work. Draft and failure paths preserve selection; this Skill does not manipulate CanvasTable selection APIs directly.

do mesmo repositório

Mais Skills

Todos os Skills
qfeius
Comunidade

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

Instalações / 1h
1
GitHub Stars
0
Atualizado
10 de nov.
qfeius
Comunidade

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

Instalações / 1h
1
GitHub Stars
0
Atualizado
10 de nov.
qfeius
Comunidade

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

Instalações / 1h
1
GitHub Stars
0
Atualizado
10 de nov.
qfeius
Comunidade

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

Instalações / 1h
1
GitHub Stars
0
Atualizado
10 de nov.