<What this skill does>
日本語の概要は準備中です。原文の説明を表示しています。
s977043/river-review42026年10月12日 更新
無料GitHub で公開
Data Flow & State Ownership
Ensure designs define data flow, state ownership, consistency boundaries, and cross-boundary writes to prevent drift and incidents.
含まれるファイル（3）
- SKILL.md4.4 KB
- fixtures/01-dual-write-no-sot-should-detect.md4.2 KB
- fixtures/02-ownership-declared-in-referenced-doc-should-not-detect.md3.2 KB
SKILL.md（原文）
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Pattern declaration
Primary pattern: Reviewer Secondary patterns: Inversion Why: データフローと状態所有の曖昧さをチェックリスト型で評価し、整合性崩れや二重書き込みを事前に検出する
Goal / 目的
- 設計の差分から、データフロー/状態所有の曖昧さによる整合性崩れ・二重書き込み・障害時の復旧困難を減らす。
Non-goals / 扱わないこと
- 分散システムの一般論を長々と語らない（差分に紐づく具体的な曖昧さに限定）。
- 実装レベルの最適化（キュー設定や DB チューニングなど）。
Pre-execution Gate / 実行前ゲート
このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。
- 差分に設計ドキュメント（フロー図/シーケンス図/データフロー設計書）の変更がある
- 差分にデータフロー・状態所有・境界横断の書き込みに関わる記述の追加または変更がある
- inputContextにdiffが含まれている
ゲート不成立時の出力: NO_REVIEW: data-flow-state-ownership — データフロー・状態所有に関わる変更が検出されない
False-positive guards / 抑制条件
- PoC/運用対象外と明記されている場合は、強度を落として “確認事項” に倒す。
Rule / ルール
- 先頭に要約を 1 行出す（追加/変更されたデータフローと所有の要点）。
- 指摘は最大 8 件まで。整合性・二重書き込み・競合・障害復旧に直結するものを優先。
- 可能なら “追記テンプレ” を付ける（文書に貼れる形）。
Checklist / 観点チェックリスト
- 状態所有（Source of Truth）
- 主要エンティティ/状態の SoT（誰が唯一の真実か）が明示されているか。
- 同じ状態を複数の境界で更新しない設計になっているか（必要なら理由とガードがあるか）。
- 境界横断の書き込み
- どの境界からどの境界へ “書く” のか、同期/非同期、順序保証の前提があるか。
- 二重実行/重複配信への対策（冪等性キー、upsert、dedupe）が設計にあるか。
- 整合性と競合
- 強整合/最終整合の選択と、ユーザー体験への影響が説明されているか。
- 競合（同時更新）の扱い（楽観ロック、解決戦略、再試行方針）があるか。
- 監査と追跡
- 重要イベントの監査ログ、相関ID など、追跡可能性の前提があるか。
- リカバリ
- 再処理/リプレイ、DLQ、補償処理などの前提があるか（必要な場合）。
Output / 出力フォーマット
すべて日本語。<file>:<line>: <message> 形式で出力する。
- 先頭に要約を 1 行:
(summary):1: <データフロー/所有/整合性の要点> - 以降は指摘（最大 8 件）:
<message>に[severity=critical|major|minor|info]を含める。- 可能なら “追記テンプレ” を 1 行付ける。
追記テンプレ例:
SoT: <エンティティ>=<所有者境界> / 更新元: <境界> / 反映: <同期/非同期> / 冪等性: <キー>整合性: <強/最終> / 競合: <方針> / 失敗時: <再試行/補償/再処理>
評価指標（Evaluation）
- 合格基準: 差分に紐づく所有/整合性の抜けを優先度付きで指摘し、追記案がある。
- 不合格基準: 根拠のない断定、差分と無関係な一般論、指摘過多。
人間に返す条件（Human Handoff）
- 整合性モデルの選択がプロダクト要件に直結する場合は人間（設計/PM）へ返す。
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
画像・ボタン・フォーム要素に適切なアクセシブルネームがあるか確認する。
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日 更新
敵対的分析手法を統合したレビューの 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日 更新