Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

dbos-typescript

/dbos-typescript

Wspiera pisanie kodu w TypeScript z DBOS SDK: workflowy, kroki, kolejki i DBOSClient w zewnętrznych aplikacjach, dla aplikacji odpornych na awarie.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
15.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
40
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 15.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wspiera pisanie kodu w TypeScript z DBOS SDK: workflowy, kroki, kolejki i DBOSClient w zewnętrznych aplikacjach, dla aplikacji odpornych na awarie.

Oryginalny opis (EN)

DBOS TypeScript SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing TypeScript code with DBOS, creating workflows and steps, using queues, using DBOSClient from external applications, or building applications that need to be resilient to failures.

Jak działa

  1. When to Apply
  2. Rule Categories by Priority
  3. Critical Rules
  4. How to Use
  5. References
Sekcje z nagłówków SKILL.md, w oryginale · 109 linii, 500 słów
Podgląd SKILL.md
---
name: dbos-typescript
description: DBOS TypeScript SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing TypeScript code with DBOS, creating workflows and steps, using queues, using DBOSClient from external applications, or building applications that need to be resilient to failures.
license: MIT
metadata:
  author: dbos
  version: "2.1.0"
  organization: DBOS
  date: October 2026
  abstract: Comprehensive guide for building fault-tolerant TypeScript applications with DBOS. Covers workflows, steps, queues, communication patterns, and best practices for durable execution.
---

# DBOS TypeScript Best Practices

Guide for building reliable, fault-tolerant TypeScript applications with DBOS durable workflows. Targets DBOS TypeScript 5.x (`@dbos-inc/dbos-sdk`). If a project is on 4.x or uses removed APIs (`new WorkflowQueue`, `@DBOS.scheduled`/`DBOS.registerScheduled`, `partitionQueue`, `priorityEnabled`, `@DBOS.requiredRole`, `dbos-config.yaml`-based config), see `references/advanced-upgrading.md`.

## When to Apply

Reference these guidelines when:
- Adding DBOS to existing TypeScript code
- Creating workflows and steps
- Using queues for concurrency control
- Implementing workflow communication (events, messages, streams)
- Configuring and launching DBOS applications
- Using DBOSClient from external applications
- Testing DBOS applications

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Lifecycle | CRITICAL | `lifecycle-` |
| 2 | Workflow | CRITICAL | `workflow-` |
| 3 | Step | HIGH | `step-` |
| 4 | Queue | HIGH | `queue-` |
| 5 | Communication | MEDIUM | `comm-` |
| 6 | Pattern | MEDIUM | `pattern-` |
| 7 | Testing | LOW-MEDIUM | `test-` |
| 8 | Client | MEDIUM | `client-` |
| 9 | Advanced | LOW | `advanced-` |

## Critical Rules

### Installation

Always install the latest version of DBOS:

```bash
npm install @dbos-inc/dbos-sdk@latest
```

### DBOS Configuration and Launch

A DBOS application MUST configure and launch DBOS before running any workflows:

```typescript
import { DBOS } from "@dbos-inc/dbos-sdk";

async function main() {
  DBOS.setConfig({
    name: "my-app",
    applicationVersion: "0.1.0",
    systemDatabaseUrl: process.env.DBOS_SYSTEM_DATABASE_URL,
  });
  await DBOS.launch();
  await myWorkflow();
}

main().catch(console.log);
```

When creating a new application, set `applicationVersion` to `"0.1.0"`. If omitted, DBOS derives an opaque hash from workflow source code. When editing an existing application, leave its configured version alone — changing it is a deployment decision (see `references/advanced-versioning.md`).

### Workflow and Step Structure

Workflows are comprised of steps. Any function performing complex operations or accessing external services must be run as a step using `DBOS.runStep`:

```typescript
import { DBOS } from "@dbos-inc/dbos-sdk";

async function fetchData() {
  return await fetch("https://api.example.com").then(r => r.json());
}

async function myWorkflowFn() {
  const result = await DBOS.runStep(fetchData, { name: "fetchData" });
  return result;
}
const myWorkflow = DBOS.registerWorkflow(myWorkflowFn);
```

### Key Constraints

- Do NOT call, start, or enqueue workflows from within steps
- Do NOT use threads or uncontrolled concurrency to start workflows - use `DBOS.startWorkflow` or queues
- Workflows MUST be deterministic - non-deterministic operations go in steps
- Do NOT modify global variables from workflows or steps
- Register queues (`DBOS.registerQueue`) and create schedules (`DBOS.applySchedules`/`DBOS.createSchedule`) AFTER `DBOS.launch()` - they are stored in the system database
- Steps are only durable when called from a workflow; outside a workflow they run as plain function calls
- Connecting to DBOS Conductor (`conductorKey`, or deploying to DBOS Cloud) requires installing `@dbos-inc/dbos-enterprise` at the same minor version as `@dbos-inc/dbos-sdk`

## How to Use

Read individual rule files for detailed explanations and examples:

```
references/lifecycle-config.md
references/workflow-determinism.md
references/queue-concurrency.md
references/advanced-upgrading.md
references/advanced-shared-database.md
```

If multiple applications share one system database, always set `applicationName` on `DBOSClient` and see `references/advanced-shared-database.md`.

## References

- https://docs.dbos.dev/
- https://github.com/dbos-inc/dbos-transact-ts
Pliki w paczce (40)
  • AGENTS.md 3 KB
  • CLAUDE.md 1 KB
  • SKILL.md 4 KB
  • references/_sections.md 2 KB
  • references/advanced-patching.md 3 KB
  • references/advanced-serialization.md 5 KB
  • references/advanced-shared-database.md 6 KB
  • references/advanced-upgrading.md 6 KB
  • references/advanced-versioning.md 3 KB
  • references/client-enqueue.md 6 KB
  • references/client-setup.md 5 KB
  • references/comm-events.md 3 KB
  • references/comm-messages.md 3 KB
  • references/comm-streaming.md 4 KB
  • references/lifecycle-config.md 8 KB
  • references/lifecycle-express.md 2 KB
  • references/pattern-classes.md 3 KB
  • references/pattern-debouncing.md 2 KB
  • references/pattern-idempotency.md 4 KB
  • references/pattern-scheduled.md 7 KB
  • references/pattern-sleep.md 2 KB
  • references/queue-basics.md 4 KB
  • references/queue-concurrency.md 2 KB
  • references/queue-deduplication.md 3 KB
  • references/queue-delay.md 2 KB
  • references/queue-listening.md 2 KB
  • references/queue-management.md 4 KB
  • references/queue-partitioning.md 3 KB
  • references/queue-rate-limiting.md 1 KB
  • references/step-basics.md 2 KB
  • references/step-retries.md 4 KB
  • references/step-timeouts.md 3 KB
  • references/step-transactions.md 4 KB
  • references/test-setup.md 4 KB
  • references/workflow-background.md 3 KB
  • references/workflow-constraints.md 2 KB
  • references/workflow-control.md 5 KB
  • references/workflow-determinism.md 2 KB
  • references/workflow-introspection.md 8 KB
  • references/workflow-timeout.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · dbos-inc/agent-skills100MIT
FrancoStino/opencode-skills-collection100MIT
rootcastleco/rei-skills100MIT
sickn33/agentic-awesome-skills100MIT

Migawka bazy z 13.11.2026 · wersja paczki fb60e65a885f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100dbos-python
    Wspiera pisanie kodu w Pythonie z DBOS SDK: workflowy, kroki, kolejki i DBOSClient w zewnętrznych aplikacjach, dla aplikacji odpornych na awarie.
  • 100dbos-golang
    Wspiera pisanie kodu w Go z DBOS SDK: workflowy, kroki, kolejki i klient DBOS w zewnętrznych aplikacjach, dla odpornych na awarie aplikacji.
  • 100dbos-java
    Wspiera pisanie kodu w Javie i Kotlinie z DBOS SDK: workflowy, kroki, kolejki, integracja ze Spring Boot i DBOSClient w aplikacjach JVM odpornych na awarie.
  • 100dbos-golang
    Wspiera pisanie kodu w Go z DBOS SDK: workflowy, kroki, kolejki i klient DBOS w zewnętrznych aplikacjach, dla odpornych na awarie aplikacji.
  • 100dbos-go
    Wspiera budowę odpornych na awarie aplikacji w Go z frameworkiem DBOS: trwałe workflowy, kroki, kolejki i wzorce komunikacji, w tym saga.
  • 100dbos-python
    Wspiera budowę odpornych na awarie aplikacji w Pythonie z frameworkiem DBOS: trwałe workflowy, kroki, transakcje, kolejki i wzorce komunikacji, w tym saga.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.