一键在 Manus 中运行任何 Skill

work-with-sof

星标40

分支16

更新时间2026年6月11日 03:46

Work on SQL-on-FHIR, ViewDefinition processing, sof-cli, sof-server, SOF HTTP configuration, output formats, or parquet export. Use for helios-sof changes, ViewDefinitionTrait behavior, transformation tests, and SOF server endpoints.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

HeliosSoftware

HeliosSoftware/hfs

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

SQL-on-FHIR

Use this when working in helios-sof, sof-cli, sof-server, or ViewDefinition transformation code.

Server Environment

Variable	Default	Description
`SOF_SERVER_PORT`	`8080`	Server port
`SOF_SERVER_HOST`	`127.0.0.1`	Host to bind
`SOF_LOG_LEVEL`	`info`	Log level
`SOF_MAX_BODY_SIZE`	`10485760`	Max request body size in bytes, applied after decompression
`SOF_REQUEST_TIMEOUT`	`30`	Request timeout in seconds
`SOF_ENABLE_CORS`	`true`	Enable CORS
`SOF_CORS_ORIGINS`	`*`	Allowed origins
`SOF_TERMINOLOGY_SERVER`	none	Terminology server URL for FHIRPath memberOf and subsumes

API Endpoints

GET /metadata: return CapabilityStatement.
GET /health: health check.
POST /ViewDefinition/$viewdefinition-run: execute ViewDefinition transformation.

$viewdefinition-run accepts these parameters in the request body or query:

_format: csv, ndjson, json, or parquet.
header: CSV header control, true or false.
viewResource: ViewDefinition resource.
resource: FHIR resources to transform.
patient: filter by patient reference.
_limit: limit results, 1 to 10000.
_since: filter by modification time.

Parameter precedence is request body, then query params, then Accept header.

Parquet Export

# CLI
cargo run --bin sof-cli -- --view view.json --bundle data.json --format parquet

# Server
curl -X POST http://localhost:8080/ViewDefinition/\$viewdefinition-run \
  -H "Content-Type: application/json" \
  -d '{"_format": "parquet", "viewResource": {...}, "resource": [...]}'

Parquet type mapping follows Pathling conventions:

SOF type	Parquet type
boolean	BOOLEAN
string, code, uri	UTF8
integer	INT32
decimal	FLOAT64
dateTime, date	UTF8

Arrays map to Arrow List types. All fields are OPTIONAL. Snappy compression is the default.

Testing

Unit tests live in src/ files.
Integration tests live in tests/.
ViewDefinition examples are embedded in test files.
For version-independent logic, use enum wrappers such as SofViewDefinition and traits such as ViewDefinitionTrait, BundleTrait, and ResourceTrait.

同仓库更多 Skills

同仓库

run-hfs-server

HeliosSoftware/hfs

Run, configure, or debug the main HFS FHIR server. Use for hfs binary startup, HFS environment variables, storage backend selection, multi-tenancy routing, HFS REST endpoints, request/response compression, S3 storage, and server behavior flags.

2026-07-1740

work-with-auth

HeliosSoftware/hfs

Work on HFS authentication & authorization. Use for SMART-on-FHIR/OAuth2, JWT bearer validation, JWKS, scopes/permissions, token replay semantics, SMART discovery, and HFS_AUTH_* configuration.

2026-07-1540

work-with-auth

HeliosSoftware/hfs

Work on HFS authentication & authorization. Use for SMART-on-FHIR/OAuth2, JWT bearer validation, JWKS, scopes/permissions, token replay semantics, SMART discovery, and HFS_AUTH_* configuration.

2026-07-1440

work-with-audit

HeliosSoftware/hfs

Work on HFS audit logging. Use for FHIR AuditEvent, IHE BALP profiles, audit sinks (database/file/CloudWatch), path exclusions, and HFS_AUDIT_* configuration.

Work on the HFS Terminology Server. Use for hts runtime configuration, HTS APIs, terminology import, bootstrap sync, CodeSystem, ValueSet, ConceptMap, SNOMED, LOINC, RxNorm, ICD-10-CM, and HFS terminology integration.

2026-06-1240

name	work-with-sof
description	Work on SQL-on-FHIR, ViewDefinition processing, sof-cli, sof-server, SOF HTTP configuration, output formats, or parquet export. Use for helios-sof changes, ViewDefinitionTrait behavior, transformation tests, and SOF server endpoints.

SQL-on-FHIR

Use this when working in helios-sof, sof-cli, sof-server, or ViewDefinition transformation code.

Server Environment

Variable	Default	Description
`SOF_SERVER_PORT`	`8080`	Server port
`SOF_SERVER_HOST`	`127.0.0.1`	Host to bind
`SOF_LOG_LEVEL`	`info`	Log level
`SOF_MAX_BODY_SIZE`	`10485760`	Max request body size in bytes, applied after decompression
`SOF_REQUEST_TIMEOUT`	`30`	Request timeout in seconds
`SOF_ENABLE_CORS`	`true`	Enable CORS
`SOF_CORS_ORIGINS`	`*`	Allowed origins
`SOF_TERMINOLOGY_SERVER`	none	Terminology server URL for FHIRPath memberOf and subsumes

API Endpoints

GET /metadata: return CapabilityStatement.
GET /health: health check.
POST /ViewDefinition/$viewdefinition-run: execute ViewDefinition transformation.

$viewdefinition-run accepts these parameters in the request body or query:

_format: csv, ndjson, json, or parquet.
header: CSV header control, true or false.
viewResource: ViewDefinition resource.
resource: FHIR resources to transform.
patient: filter by patient reference.
_limit: limit results, 1 to 10000.
_since: filter by modification time.

Parameter precedence is request body, then query params, then Accept header.

Parquet Export

# CLI
cargo run --bin sof-cli -- --view view.json --bundle data.json --format parquet

# Server
curl -X POST http://localhost:8080/ViewDefinition/\$viewdefinition-run \
  -H "Content-Type: application/json" \
  -d '{"_format": "parquet", "viewResource": {...}, "resource": [...]}'

Parquet type mapping follows Pathling conventions:

SOF type	Parquet type
boolean	BOOLEAN
string, code, uri	UTF8
integer	INT32
decimal	FLOAT64
dateTime, date	UTF8

Arrays map to Arrow List types. All fields are OPTIONAL. Snappy compression is the default.

Testing

Unit tests live in src/ files.
Integration tests live in tests/.
ViewDefinition examples are embedded in test files.
For version-independent logic, use enum wrappers such as SofViewDefinition and traits such as ViewDefinitionTrait, BundleTrait, and ResourceTrait.