본문으로 건너뛰기
cccskills
무료GitHub에 공개

clean-architecture

クリーンアーキテクチャを採用しているプロジェクト向けの設計・レビュー支援。4層構造（ドメイン層、 ユースケース層、インターフェースアダプタ層、インフラストラクチャ層）に基づく。特にインフラ層は 横断的関心事（ロギング、設定管理）のみ、永続化やRPCはインターフェースアダプタ層に配置すべき という原則を適用する。

トリガー：「クリーンアーキテクチャで」「クリーンアーキテクチャに従って」 「クリーンアーキテクチャのレビュー」など、クリーンアーキテクチャを明示的に指定した場合のみ起動。一般的な「設計レビュー」「アーキテクチャ相談」では起動しない。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

j5ik2o/okite-ai
설치 방법 보기

포함된 파일(2)

  • SKILL.md4.4 KB
  • references/layer-responsibilities.md2.7 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

クリーンアーキテクチャ

クリーンアーキテクチャを採用しているプロジェクト向けの設計・レビュー支援。

注意: このスキルはプロジェクトがクリーンアーキテクチャを採用している場合にのみ使用する。 他のアーキテクチャ（Hexagonal、Onion、レイヤード等）には適用しない。

層構造の概要

┌─────────────────────────────────────────────────────┐
│  Infrastructure（横断的関心事のみ）                   │
│  ・ログ ・設定 ・メトリクス ・DI設定                  │
├─────────────────────────────────────────────────────┤
│  Interface Adapters（外部との境界）                  │
│  ・Controller ・Repository実装 ・Gateway実装         │
├─────────────────────────────────────────────────────┤
│  Use Cases（アプリケーション固有ルール）             │
│  ・Use Case ・Output Port（Repository Interface等）│
├─────────────────────────────────────────────────────┤
│  Domain（ビジネスルール）                            │
│  ・Entity ・Value Object ・Domain Service           │
└─────────────────────────────────────────────────────┘

重要な原則

永続化・RPCの配置場所

コンポーネント配置層
Repository Interfaceユースケース層（Output Port）
Repository 実装インターフェースアダプタ層
Gateway Interfaceユースケース層（Output Port）
Gateway 実装（RPC等）インターフェースアダプタ層

インフラストラクチャ層の責務

配置するもの（横断的関心事のみ）:

  • ロギング機構
  • 設定管理
  • メトリクス・トレーシング
  • DIコンテナ設定

配置しないもの:

  • Repository実装 → インターフェースアダプタ層へ
  • 外部API Gateway → インターフェースアダプタ層へ

レビュー時のチェックポイント

  1. ドメイン層に外部依存がないか

    • DB接続、HTTPクライアント等の混入を確認

  2. Repository実装の配置が正しいか

    • インターフェースアダプタ層にあるべき

  3. インフラストラクチャ層が肥大化していないか

    • 永続化コードが紛れ込んでいないか確認

  4. 依存方向が内向きか

    • 外側の層から内側への依存のみ許可

詳細リファレンス

各層の詳細な責務と配置すべきコンポーネントの一覧は references/layer-responsibilities.md を参照。

関連スキル（併読推奨）

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

  • repository-placement: クリーンアーキテクチャにおけるリポジトリインターフェースの配置
  • package-design: 各層内のパッケージ設計原則
  • ddd-module-pattern: ドメイン層内のモジュール構成

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

aggregate-design

무료

DDDの集約(Aggregate)設計ルールに基づくコードレビュー・設計支援・リファクタリングを行う。 Evans Rules、Vernon's 4 Rules、Design by Contractに基づき、集約の境界定義、不変条件の検証、 不変(Immutable)設計、ID参照、結果整合性、ドメインイベント連携を包括的にガイドする。 以下のいずれかに該当する場合は必ずこのスキルを使用すること： - 集約(Aggregate)の新規設計・実装・リファクタリング（どの言語でも） - 既存の集約やエンティティクラスのDDD観点でのコードレビュー - 集約の境界決定（「AとBは同じ集約にすべきか？」「この集約は大きすぎるか？」） - 集約内の不変条件・整合性境界の設計 - 集約間の連携方式の判断（ドメインイベント、結果整合性、Sagaパターン） - 可変(Mutable)な集約コードを不変(Immutable)設計にリファクタリングする - publicフィールド、直接参照、push/appendなどカプセル化違反の検出・修正 キーワード例：集約、Aggregate、aggregate boundary、集約ルート、AggregateRoot、 エンティティ設計、DDD実装、Vernon Rules、Evans Rules、集約の分割、真の不変条件

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

j5ik2o/okite-ai802026년 4월 25일 업데이트

aggregate-transaction-boundary

무료

集約とトランザクション境界の関係を明確化し、複数集約を単一トランザクションに含めるアンチパターンを 検出・是正する。集約は強い整合性境界であり、ユースケースで複数集約を更新する場合は結果整合性を 使うべきという原則を適用する。コードレビュー、ユースケース設計、リファクタリング時に トランザクション境界の問題を検出する場合に使用。 対象言語: 言語非依存（Java, Kotlin, Scala, TypeScript, Go, Rust, Python等すべて）。 トリガー：「複数集約を同じトランザクションで更新している」「ユースケースに@Transactionalがある」 「集約間の整合性をどう取るか」「Sagaパターンを使うべきか」「トランザクション境界の設計」 「1トランザクション1集約」「結果整合性の実装」「集約をまたぐトランザクション」 といったトランザクション境界関連リクエストで起動。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

j5ik2o/okite-ai802026년 4월 25일 업데이트

backward-compat-governance

무료

後方互換性がゴミコードを量産する構造を検出し、互換性を「契約と撤去計画」として管理する ガバナンスを支援するスキル。公開API境界の明確化、非推奨化サイクル（deprecation cycle）の 制度化、互換層の局所化（Adapter/Strangler Fig）、契約テスト（CDC）による互換性検証、 AI生成コードの互換性ゲート設計を含む。コードレビュー、API設計、リファクタリング、 レガシー移行時に互換性起因の技術的負債を防ぐために使用。 対象言語: 言語非依存（Java, TypeScript, Go, Python, Rust等すべて）。 トリガー：「後方互換性を保ちたい」「非推奨APIをどうする」「互換層が増えてきた」 「レガシー移行の戦略」「API設計レビュー」「互換性のためのコードが多い」 「deprecation policyを作りたい」「破壊的変更の管理」といった互換性管理関連リクエストで起動。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

j5ik2o/okite-ai802026년 4월 25일 업데이트

breach-encapsulation-naming

무료

getterの濫用を防ぐための命名規約スキル。ドメインモデルでgetterが必要な場合（永続化、JSON変換など）に `breachEncapsulationOf` プレフィックスを付与することで、カプセル化を破っていることを明示する。 これにより、Tell Don't Ask原則の違反を未然に防ぎ、getterの意図しない使用を抑制する。 コードレビュー、新規実装、リファクタリング時にgetter設計が必要な場合に使用。 対象言語: Java, Kotlin, Scala, TypeScript, Python, Go, Rust。 トリガー：「getterの命名規約」「カプセル化を破るgetter」「永続化用のgetter」 「breachEncapsulation」「getterを作りたいが濫用を防ぎたい」といったgetter命名関連リクエストで起動。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

j5ik2o/okite-ai802026년 4월 25일 업데이트

cqrs-aggregate-modeling

무료

CQRS/ESが集約の境界定義とモデリングに与える影響を解説する。CQRSを導入すると集約は コマンド実行に必要な最小限の状態のみ保持すればよくなり、読み取り責務はリードモデルに 委譲できる。大きすぎる集約の軽量化、集約境界の再定義、イベントによる状態管理を支援する。 集約設計、CQRS導入時のモデリング見直し、パフォーマンス問題の解決時に使用。 対象言語: 言語非依存。 トリガー：「CQRSで集約が変わる」「集約が大きすぎる」「集約にメッセージ1000件」 「集約の更新が重い」「CQRS導入で集約を見直す」「集約を軽量化したい」 「集約にクエリ用データが混ざっている」「集約の境界を再定義」 といったCQRS/モデリング関連リクエストで起動。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

j5ik2o/okite-ai802026년 4월 25일 업데이트

cqrs-to-event-sourcing

무료

CQRSの実装においてイベントソーシングが必然的に必要となる理由を論理的に説明する。 C側からQ側へのデータ同期問題（計算された値の同期不可、トリガーの限界、ポーリングの スケーラビリティ問題、ダブルコミット問題）を段階的に分析し、イベントを真のデータソースに する設計への到達過程を示す。CQRS導入検討、アーキテクチャ設計時に使用。 対象言語: 言語非依存。 トリガー：「CQRSにイベントソーシングは必要か」「C側とQ側の同期方法」 「CQRSでモデルを分ける必要はないのか」「リードモデルの更新方法」 「なぜイベントソーシングが必要か」「ダブルコミット問題」「CQRSの同期問題」 「CQRSはESなしでも動くか」といったCQRS/ES必然性関連リクエストで起動。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

j5ik2o/okite-ai802026년 4월 25일 업데이트

j5ik2o의 스킬 모두 보기

이 스킬의 문제 신고