Token导航 LogoToken导航TokenDH.com
待分类权限需确认github未标认证来源可访问许可证需确认审计通过

cqrs-to-event-sourcingcqrs 到事件溯源

Agent Skill

cqrs-to-event-sourcing 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

494

周安装

20

GitHub Stars

75

下载量

155
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:cqrs-to-event-sourcing(cqrs 到事件溯源)
来源仓库:https://github.com/j5ik2o/okite-ai
仓库路径:skills/cqrs-to-event-sourcing
安装命令:
npx skills add https://github.com/j5ik2o/okite-ai --skill cqrs-to-event-sourcing
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/j5ik2o/okite-ai --skill cqrs-to-event-sourcing

简介

cqrs-to-event-sourcing 解释为何实施 CQRS 后自然导向事件溯源架构。

  • 适用于理解命令侧与查询侧数据差异、同步问题及最终一致性挑战。
  • 提供购物车系统等案例,展示写模型最小数据与读模型丰富展示的分离设计。
  • 内容以日文编写,需人工复核架构演进逻辑与术语翻译准确性。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

SKILL.md

CQRSはなぜEvent Sourcingになるのか

CQRSを実装すると、C側からQ側への同期問題に直面し、イベントソーシングに至る。これはオプションではなく、実装上の必然である。

よくある誤解: 「CQRSはモデルを分ける必要がない」

この解釈は危険な誤読である。

正しい意味は「システムのうち、CQRS領域と非CQRS領域に分けることができ、CQRSを部分導入できる」ということ。モデルを分けなくてよいのは非CQRS領域であり、CQRS領域内ではコマンドモデルとクエリモデルの分割は必須。

システム全体
├── CQRS領域     → モデル分割は必須
└── 非CQRS領域   → 分割不要(従来のCRUDで十分)

「CQRSはモデルを分割しなくてもいい」という解釈は、もはやCQRSではない。

C側とQ側のデータの違い

CQRSにおいて、C側(コマンド)とQ側(クエリ)のデータは根本的に異なる。

具体例: カートシステム

C側テーブル(ドメインモデルの永続化に必要な最小データ):

カートテーブルカートアイテムテーブル
カートID (PK)カートアイテムID (PK)
顧客アカウントIDカートID (FK)
上限予算金額商品ID
作成日時数量
作成日時

Q側テーブル(表示・検索に必要なデータ):

カートテーブルカートアイテムテーブル
カートID (PK)カートアイテムID (PK)
顧客アカウントID商品ID
顧客アカウント名 ★商品名 ★
上限予算金額数量
合計金額単価
価格

★の値はC側のデータベースに存在しない。ドメインオブジェクトの振る舞いによって計算される派生値である。

case class Cart(id: CartId, items: CartItems, ...) {
  // 合計金額はドメインオブジェクトの計算結果であり、DBに保存されない
  def totalPrice(priceResolver: ItemId => Price): Price =
    items.fold(Price.zero){ (t, item) => t + item.price(priceResolver) }
}

case class CartItem(id: CartItemId, itemId: ItemId, quantity: Quantity, ...) {
  // 単価は外部から提供され、価格は計算される
  def price(priceResolver: ItemId => Price): Price =
    priceResolver(itemId) * quantity
}

同期方法の段階的検討と限界

方法1: トリガーによる同期

C側のテーブル更新時にSQLでQ側を書き込む。

限界:

  • 静的データ(顧客名等)の転送には有効
  • 計算された値(★)は同期できない - ドメインロジックの計算結果はDBに存在しない
  • 同じ計算ロジックのSQLを書くのは困難であり、ビジネスロジックの重複を生む
  • 苦肉の策として計算結果もC側に保存すると、リポジトリのインターフェースが歪む
// ❌ リポジトリに計算ロジックの責務が漏れる
trait CartRepository {
  def store(cart: Cart, priceResolver: ItemId => Price): Unit
  // priceResolverはリポジトリの責務ではない
}

方法2: ポーリングによる同期

プログラムでC側テーブルを読み込み、ドメインオブジェクトで計算後、Q側に書き込む。

限界:

  • 計算結果のQ側転送は可能
  • 「いつ変更されたか」を検知できない - 変更トリガーがない
  • 全集約をポーリングする必要があり、スケーラビリティがない
  • 大量の集約が存在する場合、実用的ではない

結論: 最新状態を手に入れるにしても、更新イベントが必要

方法3: イベント通知キューの導入

変更時にイベントをキューに発行し、Q側更新プログラムがイベントを受信して同期する。

C側リポジトリ → RDB(テーブルA) + メッセージキュー(更新イベント)
                                         ↓
                            リードモデル更新プロセス
                                         ↓
                            C側テーブルから集約再現 → Q側テーブル書き込み

限界: ダブルコミット問題が発生する。

  • RDBとメッセージキューは異なるストレージ
  • 同一トランザクションに統合できない
  • RDBへの書き込み成功 + キューへの書き込み失敗(またはその逆)が起こりうる
  • 高いコストを払う可能性がある

必然的な到達点: イベントソーシング

ダブルコミット問題を回避するには、イベントを真のデータソースにする

設計の転換

従来:
  C側DB(状態を保存) + メッセージキュー(通知用)
  → 2つのストレージへの書き込み = ダブルコミット問題

イベントソーシング:
  イベントストア(イベントが真のデータソース)
  → 1つのストレージへの書き込みのみ
  → C側の状態はイベントから導出
  → Q側の状態もイベントから導出

結果

  • C側のDBはRDBである必要がなくなる(イベントの追記とIDごとの読み込みが可能なシステムであれば何でもよい)
  • NoSQL(KVS)が適している場合が多い
  • DynamoDB Streamsなどでスケーラブルにイベント読み込みが可能
  • これがEvent Sourcing
イベントストア(真のデータソース)
    │
    ├──→ C側: イベントからドメイン状態を再構築
    │
    └──→ Q側: イベントからリードモデルを構築
              (計算された値も含めて自由に構築可能)

CQRSシステムのほとんどがEvent Sourcingを採用する理由

Lightbend社の調査によると、CQRSシステムのほとんどがEvent Sourcingを採用している。

段階方法問題
1トリガー計算された値を同期できない
2ポーリング変更検知できない、スケールしない
3イベントキューダブルコミット問題
4Event Sourcing上記すべてを解決

Event Sourcingはオプションではなく、CQRSを真剣に実装すると必然的に到達する設計パターンである。

判断フロー

CQRSの導入を検討している
    ↓
C側とQ側のデータは同一か?
    ├─ YES → CQRSは不要。従来のCRUDで十分
    └─ NO(Q側に計算値・結合データがある) ↓
        C→Qの同期をどうするか?
        ├─ トリガー → 計算値は同期できない
        ├─ ポーリング → 変更検知・スケーラビリティの問題
        ├─ イベントキュー → ダブルコミット問題
        └─ Event Sourcing → すべて解決

関連スキルとの関係

スキル関係
cqrs-tradeoffsCQRSの一貫性・可用性・スケーラビリティ。本スキルはESが必要な理由
aggregate-transaction-boundaryトランザクション境界。本スキルはC→Q同期の問題
cross-aggregate-constraints集約間制約。本スキルとは別次元の問題

レビューチェックリスト

CQRS設計

  • CQRS領域と非CQRS領域を明確に分離しているか
  • CQRS領域内でコマンドモデルとクエリモデルを分割しているか
  • 「CQRSだがモデルは分けない」という矛盾した設計になっていないか

C→Q同期

  • Q側に必要なデータの中に、C側DBに存在しない計算値があるか確認したか
  • 計算値がある場合、トリガーでは解決できないことを理解しているか
  • C→Q同期の仕組み(イベント駆動)が設計されているか
  • ダブルコミット問題を認識し、対処しているか

Event Sourcing

  • イベントを真のデータソースとする設計か
  • C側の状態がイベントから導出可能か
  • Q側のリードモデルがイベントから構築可能か

関連スキル(併読推奨)

このスキルを使用する際は、以下のスキルも併せて参照すること:

  • cqrs-tradeoffs: CQRS採用判断のトレードオフ分析
  • cqrs-aggregate-modeling: イベントソーシング下での集約モデリング
  • aggregate-transaction-boundary: イベントストアによるダブルコミット問題の解消

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

36.08%
按下载量换算56

Claude

28.93%
按下载量换算45

Cursor

20.05%
按下载量换算31

Gemini CLI

8.54%
按下载量换算13

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

权限需确认

当前来源未能明确判断权限范围,默认进入异常复核队列。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills