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

Event-Driven Semantics & Delivery Guarantees

Ensure event-driven designs specify delivery guarantees, ordering, idempotency, schema evolution, and replay/backfill strategy.

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.2 KB
  • fixtures/01-no-delivery-guarantee-no-idempotency-should-detect.md4.2 KB
  • fixtures/02-guarantees-in-referenced-asyncapi-should-not-detect.md2.9 KB

SKILL.md(原文)

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

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: イベント駆動設計の差分から配信保証・冪等性・スキーマ進化の抜けをレビューし、障害シナリオを逆照射して設計の堅牢性を検証する。

Goal / 目的

  • イベント駆動設計の差分から、配信保証・順序・冪等性・再処理/リプレイの未定義による事故を減らす。

Non-goals / 扱わないこと

  • メッセージ基盤の選定(Kafka/SQS 等)の是非の断定。
  • 実装レベルの consumer コードやライブラリ選定。

Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。

  • 差分にイベント駆動・メッセージング・キュー・ストリーム関連のドキュメントまたはスキーマが含まれている
  • inputContextにdiffが含まれている

ゲート不成立時の出力: NO_REVIEW: event-driven-semantics — イベント駆動設計関連の差分がない

False-positive guards / 抑制条件

  • 契約が別ドキュメントで管理され、参照が明確な場合は重複指摘しない。

Rule / ルール

  • 先頭に要約を 1 行出す(新規/変更イベントと consumer 影響の要点)。
  • 指摘は最大 8 件まで。順序/重複/再処理で壊れる設計を優先。
  • 可能なら “追記テンプレ” を付ける(文書に貼れる形)。

Checklist / 観点チェックリスト

  • 配信保証と重複
    • 配信保証(at-least-once/at-most-once/exactly-once の前提)が明記されているか。
    • 重複配信を前提にした冪等性(idempotency key、dedupe)の設計があるか。
  • 順序とキー
    • 順序保証の前提(partition key、同一キー内のみ順序等)が明示されているか。
    • 乱順/遅延到着の扱い(reorder window、最終状態の決め方)があるか。
  • スキーマ進化
    • 互換性ルール(追加は後方互換、削除は破壊的等)と versioning があるか。
    • deprecated 期間と移行手順(producer/consumer の段階更新)があるか。
  • 再処理/リプレイ
    • リプレイ/backfill の方針(いつ、どこから、どれくらい)があるか。
    • DLQ/poison message の扱いと再処理手順があるか。
  • 観測性
    • eventId/correlationId、consumer lag、失敗率などの監視前提があるか。

Output / 出力フォーマット

すべて日本語。<file>:<line>: <message> 形式で出力する。

  • 先頭に要約を 1 行: (summary):1: <イベント契約/保証/移行の要点>
  • 以降は指摘(最大 8 件):
    • <message> に [severity=critical|major|minor|info] を含める。
    • 可能なら “追記テンプレ” を 1 行付ける。

追記テンプレ例:

  • 保証: at-least-once / 冪等性: key=<>, dedupe=<>, 重複時: <扱い>
  • 順序: key=<>, 保証範囲=<同一キー内のみ> / 乱順: <扱い>
  • 互換性: <後方互換/破壊的> / version=<>, 移行: <両対応期間>

評価指標(Evaluation)

  • 合格基準: 差分に紐づく保証/冪等性/再処理の抜けが指摘され、追記案がある。
  • 不合格基準: 差分と無関係な一般論、根拠のない断定、指摘過多。

人間に返す条件(Human Handoff)

  • 互換性破壊やリプレイ方針が合意できていない場合は人間レビューへ返す。

レビュー

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

同じリポジトリのスキル

概要と使いどころ

<What this skill does>

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

s977043/river-review42026年10月12日 更新

a11y Accessible Name Basics

無料日本語概要

画像・ボタン・フォーム要素に適切なアクセシブルネームがあるか確認する。

s977043/river-review42026年10月12日 更新

Ensure ADRs capture context, decision, alternatives, tradeoffs, and follow-ups in a way that prevents future drift.

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

s977043/river-review42026年10月12日 更新

adversarial-review

無料日本語概要

敵対的分析手法を統合したレビューの entry skill。認知バイアス対策の3手法 (Pre-mortem / War Game / Logic Torturing)と、宣言・主張と実態の乖離を突く claim-vs-actual 検出3パターン(Self-Contradiction / Refactor-Claim Audit / Cross-File Leakage)へルーティングし、通常のレビューでは見えない設計の盲点・ 防御の穴・論理の弱点・宣言と実装のズレを可視化する。

s977043/river-review42026年10月12日 更新

Review changes to the Agent Skills import/export bridge for path safety, round-trip fidelity, and validation correctness.

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

s977043/river-review42026年10月12日 更新

Checks whether AI-assisted work defines review criteria, accessible context, explicit review loop, human judgment boundary, and feedback capture before delegating to an agent.

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

s977043/river-review42026年10月12日 更新

s977043 のスキルをすべて見る

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