К основному содержанию
скилл CX Codex

dbos-golang — скилл для Claude Code: что делает и как установить

Скилл dbos-golang для Claude Code помогает писать Go-приложения с DBOS: проектировать workflow и шаги, подключать очереди и настраивать запуск. Описывает настройку приложений, которые должны переживать сбои.

MIT 314 установок ★ 20 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dbos-inc/agent-skills --skill dbos-golang -a claude-code
Открыть на GitHub

Что делает dbos-golang

Скилл описывает работу с DBOS Go SDK: создание контекста, регистрацию workflow и источников данных, запуск приложения, очереди и взаимодействие с workflow. Он также объясняет, как вызывать внешние операции через dbos.RunAsStep, а записи, которые должны выполняться ровно один раз, — через транзакцию dbos.RunAsTransaction.

В руководстве разобраны ограничения: workflow должны быть детерминированными, а запускать их из шагов нельзя. Все workflow и источники данных нужно зарегистрировать до Launch(). Для подключения к DBOS Conductor и автоматического обновления workflow требуется DBOS Enterprise для Go; без него инициализация соответствующих функций завершится ошибкой. Сам модуль DBOS устанавливается командой go get github.com/dbos-inc/dbos-transact-golang/dbos@latest.

Какие задачи решает

  • настроить запуск приложения DBOS на Go
  • разнести внешние вызовы по шагам workflow
  • сохранять записи базы данных в транзакциях
  • ограничить параллельность workflow через очереди
  • разобраться с детерминированностью и повторным запуском workflow

Примеры запросов агенту

  • Настрой запуск Go-приложения с DBOS и зарегистрируй workflow до Launch().
  • Проверь, какие внешние вызовы в этом workflow нужно вынести в dbos.RunAsStep.
  • Покажи, как выполнить запись ровно один раз через dbos.RunAsTransaction.

Как установить dbos-golang

1Через Skills CLI (Vercel)

npx skills add dbos-inc/agent-skills --skill dbos-golang -a claude-code

2Вручную: положить файлы

~/.claude/skills/dbos-golang/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/dbos-golang/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о dbos-golang

Как установить dbos-golang в Claude Code?

Выполните npx skills add dbos-inc/agent-skills --skill dbos-golang -a claude-code. Файл скилла появится по пути ~/.claude/skills/dbos-golang/SKILL.md.

Что делает dbos-golang?

Скилл помогает использовать DBOS Go SDK для workflow, шагов, очередей и управления запуском приложения. В нём также разобраны ограничения исполнения и транзакции.

Что нужно для подключения к DBOS Conductor?

Нужен DBOS Enterprise для Go той же минорной версии, что и основной модуль, и пустой импорт go.dbos.dev/dbos-enterprise-go. Без этого dbos.NewContext завершается ошибкой инициализации.

Исходный текст

SKILL.md · MIT
---
name: dbos-golang
description: DBOS Go SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing Go code with DBOS, creating workflows and steps, using queues, using the DBOS Client from external applications, or building Go applications that need to be resilient to failures.
license: MIT
metadata:
  author: dbos
  version: "2.3.0"
  organization: DBOS
  date: October 2026
  abstract: Comprehensive guide for building fault-tolerant Go applications with DBOS. Covers workflows, steps, queues, communication patterns, and best practices for durable execution.
---

# DBOS Go Best Practices

Guide for building reliable, fault-tolerant Go applications with DBOS durable workflows.

## When to Apply

Reference these guidelines when:
- Adding DBOS to existing Go code
- Creating workflows and steps
- Running database transactions durably through datasources
- Using queues for concurrency control
- Implementing workflow communication (events, messages, streams)
- Configuring and launching DBOS applications
- Using the DBOS Client 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

Install the DBOS Go module (v1):

```bash
go get github.com/dbos-inc/dbos-transact-golang/dbos@latest
```

Connecting to DBOS Conductor (setting `ConductorAPIKey`, or running in DBOS Cloud) and auto-upgrading workflows (`AutoUpgrade` in `dbos.Config`, or `dbos.WithAutoUpgrade(true)` at registration) require DBOS Enterprise for Go, at the same minor version as the core module (`go get go.dbos.dev/[email protected]`), with a blank import anywhere in the program; otherwise `dbos.NewContext` (or `dbos.Launch`, for a workflow enrolled with `WithAutoUpgrade`) fails with an initialization error:

```go
import _ "go.dbos.dev/dbos-enterprise-go"
```

### DBOS Configuration and Launch

A DBOS application MUST create a context, register workflows, and launch before running any workflows:

```go
package main

import (
	"context"
	"log"
	"os"
	"time"

	"github.com/dbos-inc/dbos-transact-golang/dbos"
)

func main() {
	ctx, err := dbos.NewContext(context.Background(), dbos.Config{
		AppName:            "my-app",
		ApplicationVersion: "0.1.0",
		DatabaseURL:        os.Getenv("DBOS_SYSTEM_DATABASE_URL"),
	})
	if err != nil {
		log.Fatal(err)
	}
	defer dbos.Shutdown(ctx, 30*time.Second)

	dbos.RegisterWorkflow(ctx, myWorkflow)

	if err := dbos.Launch(ctx); err != nil {
		log.Fatal(err)
	}
}
```

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

`DatabaseURL` accepts Postgres/CockroachDB URLs or SQLite URLs (`sqlite:/path/to.db`, `sqlite::memory:`; SQLite requires a blank import of `github.com/dbos-inc/dbos-transact-golang/dbos/driver/sqlite`). See `references/lifecycle-config.md` for all configuration options, including Conductor settings and running schema migrations separately from the application.

`dbos.Context` extends `dbos.Client`: management functions (`Enqueue`, `ListWorkflows`, `CancelWorkflow`, queue and schedule management, ...) take a `dbos.Client` and accept either a `Context` or a standalone client from `dbos.NewClient` (see `references/client-setup.md`).

`AppName` identifies the application and owns everything it creates. Multiple applications (in any language) can share one system database, isolated by application name (v1.2.0+, see `references/advanced-shared-database.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.RunAsStep`:

```go
func fetchData(ctx context.Context) (string, error) {
	resp, err := http.Get("https://api.example.com/data")
	if err != nil {
		return "", err
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	return string(body), nil
}

func myWorkflow(ctx dbos.Context, input string) (string, error) {
	result, err := dbos.RunAsStep(ctx, fetchData, dbos.WithStepName("fetchData"))
	if err != nil {
		return "", err
	}
	return result, nil
}
```

Database writes that must happen exactly once belong in a datasource transaction (`dbos.RunAsTransaction`), not a step (see `references/step-transactions.md`).

### Key Constraints

- Do NOT start or enqueue workflows from within steps
- Do NOT call `dbos.RunAsTransaction`, `handle.GetResult`, or `dbos.CloseStream` from within steps (reads, `dbos.SetEvent`, and `dbos.WriteStream` are allowed)
- Do NOT use uncontrolled goroutines to start workflows - use `dbos.RunWorkflow` with queues or `dbos.Go`/`dbos.Select` for concurrent steps
- Workflows MUST be deterministic - non-deterministic operations go in steps
- Do NOT modify global variables from workflows or steps
- All workflows MUST be registered, and all datasources created with `dbos.NewDataSource`, before calling `Launch()`; queues are registered with `dbos.RegisterQueue` and persisted in the database
- Starting a workflow with an ID already in use returns the existing workflow by default; pass `dbos.WithWorkflowIDReusePolicy(dbos.WorkflowIDReusePolicyReject)` to get `dbos.ErrWorkflowIDInUse` instead (see `references/pattern-idempotency.md`)
- A panic in a workflow does not crash the process: DBOS records it as the workflow's error (`dbos.ErrWorkflowPanic`)
- Do NOT set `EnablePatching` (deprecated in v1.8.0): `dbos.Patch` and `dbos.DeprecatePatch` work without it. To let patched code recover older workflows, pin `ApplicationVersion` or use auto-upgrade (see `references/advanced-patching.md`)

## How to Use

Read individual rule files for detailed explanations and examples:

```
references/lifecycle-config.md
references/workflow-determinism.md
references/step-transactions.md
references/queue-concurrency.md
references/workflow-control.md
```

## References

- https://docs.dbos.dev/
- https://github.com/dbos-inc/dbos-transact-golang

© dbos · MIT · dbos-inc/agent-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
golang-database samber Скилл golang-database для Claude Code задаёт правила работы с реляционными базами данных в Go через database/sql, sqlx и pgx, без ORM. Помогает писать запросы и проверять утечки соединений. CX Codex +1 43 300установок go-database eduardo-sl Скилл go-database для Claude Code помогает писать доступ к базе данных в Go-сервисах. Подключается к задачам с SQL-запросами, транзакциями и миграциями. CX Codex +1 ★ 90звёзд репо golang-database-patterns Claude MPM Team Скилл golang-database-patterns для Claude Code, Codex, Cursor и других платформ с паттернами работы с базами данных на Go: sqlx, pgx, golang-migrate, репозиторный слой, пулинг соединений. CX Codex +1 421установок golang-data-structures samber Скилл golang-data-structures для Claude Code помогает выбирать и использовать структуры данных Go. Он включается при работе со слайсами, картами, контейнерами и указателями. CX Codex +1 42 500установок iii-architecture-patterns iii-hq Скилл iii-architecture-patterns для Claude Code помогает выбирать архитектурный паттерн для backend-задачи и собирать его из примитивов iii. Он охватывает очереди, события, наблюдателей и агентные цепочки. CX Codex +1 4 900установок rivet-workflows rivet-dev Скилл rivet-workflows учит агента создавать устойчивые сценарии Rivet с повторными запусками, фоновыми очередями и обработкой вебхуков. CX Codex +1 1 700установок

Из того же набора3

Спонсоры проекта

Компании, которые помогают держать аналитику открытой