Token导航 LogoToken导航

Agent Skill · 待分类

cqrs-to-event-sourcing(cqrs 到事件溯源)

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

cqrs-to-event-sourcing 是待分类类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为权限未标注;许可证信息还不明确,第三方扫描已通过,按安装量在待分类类的 11,209 个 Skill 里排第 6,005。

总安装 494周安装 20GitHub Stars 75下载 155核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 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

这个 Skill 是做什么的

这个 Skill 的分类还没最终确定,用法以来源仓库的说明为准。

cqrs-to-event-sourcing 解释为何实施 CQRS 后自然导向事件溯源架构。适用于理解命令侧与查询侧数据差异、同步问题及最终一致性挑战。提供购物车系统等案例,展示写模型最小数据与读模型丰富展示的分离设计。内容以日文编写,需人工复核架构演进逻辑与术语翻译准确性。

适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/cqrs-to-event-sourcing

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/j5ik2o/okite-ai --skill cqrs-to-event-sourcing;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    权限没有明确标注,第一次使用时只给一个无关紧要的任务,观察它到底读了哪些文件和网络。

常见问题

6 条

cqrs-to-event-sourcing 怎么安装?

在终端执行 npx skills add https://github.com/j5ik2o/okite-ai --skill cqrs-to-event-sourcing。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

cqrs-to-event-sourcing 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

cqrs-to-event-sourcing 需要什么权限?

权限级别没有明确标注。第一次使用时建议只给无关紧要的任务,观察它实际读写了哪些内容。

cqrs-to-event-sourcing 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

cqrs-to-event-sourcing 用的人多吗?

公开数据是累计安装 494 次,近一周安装 20 次,下载 155 次,GitHub 75 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

cqrs-to-event-sourcing 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理待分类类任务、又不想每次都手写提示词的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

待分类类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
infsh-cli

infsh CLI · Codex、Claude

4,374,576382权限未标注未明确未收录
ai-video-generation

AI 视频生成 · Codex、Claude

4,313,376382调用外部服务未明确有提醒
lark-openapi-explorer

云雀 OpenAPI 浏览器 · Codex、Claude

2,064,1209,011需要联网未明确有提醒
lark-workflow-standup-report

Lark 工作流程站立报告 · Codex、Claude

2,041,6328,978需要联网未明确通过
use-my-browser

使用我的浏览器 · Codex、Claude

1,848,49140操作浏览器未明确未通过
cqrs-to-event-sourcing

cqrs 到事件溯源 · 本页

49475权限未标注未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

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: イベントストアによるダブルコミット問題の解消

平台分布

Codex

36.08%
按下载量换算56

Claude

28.93%
按下载量换算45

Cursor

20.05%
按下载量换算31

Gemini CLI

8.54%
按下载量换算13

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

权限未标注

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

安装前确认

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

继续浏览同类 Skills