本文へ移動
cccskills
無料GitHub で公開

outbox-pattern

Load for reliable post-commit messaging, domain/integration event delivery, transactional outbox tables, dispatch workers, retries, idempotent consumers, duplicate delivery, or dual-write failure; not for synchronous in-process events with no external side effect.

インストール方法を見る

含まれるファイル(5)

  • SKILL.md2.0 KB
  • resources/database-schema.md1.7 KB
  • resources/dispatcher-patterns.md2.3 KB
  • resources/entity-model.md2.1 KB
  • resources/processor-configuration.md2.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

ABOUTME: Transactional outbox pattern skill for reliable at-least-once event delivery. ABOUTME: Covers OutboxMessage entity, OutboxProcessor, retry/dead-letter, and specialized variants.

Outbox Pattern

Non-Inferable Rules

  1. OutboxMessage uses UUID v7 (Guid in C#, uuidv7() in PostgreSQL) — not auto-increment.
  2. TryMarkAsProcessing uses optimistic concurrency — returns bool, no exceptions on contention.
  3. Retry delay formula: InitialRetryDelaySeconds × 2^retryCount, capped at MaxRetryDelaySeconds.
  4. After MaxRetries exhausted, status transitions to DeadLettered — messages stay in DB indefinitely for monitoring.
  5. LoggingOutboxMessageDispatcher is the default no-op — real dispatchers must be registered to replace it.
  6. Three specialized outbox variants exist: general OutboxMessage, PolicyChangeOutbox (settings), PdsSyncOutbox (AT Protocol federation). Each has its own entity and repository.
  7. OutboxProcessor polls on a PeriodicTimer — not event-driven. Default interval: 5 seconds.
  8. Dispatchers must be idempotent — at-least-once delivery means duplicates are possible.

Resources

  • resources/entity-model.md — OutboxMessage fields, status lifecycle, EF configuration
  • resources/processor-configuration.md — OutboxProcessor settings, retry strategy, dead-letter
  • resources/dispatcher-patterns.md — IOutboxMessageDispatcher, specialized variants
  • resources/database-schema.md — Indexes, queries, database conventions

Related

  • docs/internal/OUTBOX_PATTERN.md
  • docs/internal/ARCHITECTURE.md (Background Services section)
  • .agents/skills/dotnet-efcore-guidelines/SKILL.md
  • .agents/skills/clean-architecture-rules/SKILL.md

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Load for Blazor/MudBlazor UI changes involving forms, dialogs, focus, keyboard navigation, landmarks, ARIA, color contrast, RTL-safe styling, or WCAG 2.2 AA tests; not for backend-only changes.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

Load when a task asks to research, verify, compare, or look up framework/package behavior, release notes, standards, RFCs, CVEs, or unfamiliar APIs; use repository evidence first, then official docs, and not for codebase navigation alone.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

aspire

無料

Load for Aspire AppHost work: start/stop/wait resources, inspect dashboard/logs/traces, add integrations/resources, rebuild a service, run isolated worktrees, or diagnose Aspire orchestration; not for plain dotnet apps, container-only deployments, or cloud deployment.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

Load for authentication or authorization changes involving BFF cookies/tokens, JWT validation, claims/user ID extraction, policies, handler access checks, impersonation, or 401/403 bugs; not for UI affordance gating alone.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

Load for Blazor BFF server work involving YARP proxy routes, cookie sessions, access-token forwarding/refresh, downstream API calls, BFF handlers, or browser-to-API auth failures; not for client component rendering or API JWT validation alone.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

Load when editing Blazor `.razor.css`, scoped selectors, `::deep`, BEM class names, RTL/logical CSS properties, or styling nested MudBlazor components; not for global design tokens or non-Blazor CSS.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

islamu-ngo のスキルをすべて見る

このスキルの問題を報告する