modular-architecture

daishiman 的头像作者 daishiman

专注于模块化架构和组件分割设计的技能。基于高内聚低耦合原则进行系统设计、依赖关系管理和可伸缩架构模式的实现。

📖 中文导读:专注于模块化架构和组件分割设计的技能。基于高内聚低耦合原则进行系统设计、依赖关系管理和可伸缩架构模式的实现。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: modular-architecture description: | モジュラーアーキテクチャとコンポーネント分割の設計スキル。 高凝集・低結合の原則に基づいたシステム設計、依存関係管理、 スケーラブルなアーキテクチャパターンの実装を支援する。

Anchors: • Clean Architecture (Robert C. Martin) / 適用: レイヤー分離 / 目的: ビジネスロジックとインフラの分離 • Domain-Driven Design (Eric Evans) / 適用: 境界づけられたコンテキスト / 目的: ドメインモデルの凝集性 • SOLID Principles / 適用: モジュール設計原則 / 目的: 保守性と拡張性の向上

Trigger: Use when designing modular architecture, splitting system into components, managing dependencies, or applying high cohesion low coupling principles. modular, architecture, component, module, cohesion, coupling, dependency, layer, separation allowed-tools: - Read - Write - Edit - Bash - Glob - Grep - Task

Modular Architecture

概要

モジュラーアーキテクチャとコンポーネント分割の設計スキル。高凝集・低結合の原則に基づいたシステム設計、依存関係管理、スケーラブルなアーキテクチャパターンの実装を支援する。

ワークフロー

Phase 1: アーキテクチャ分析

目的: システム要件を理解し、適切なモジュール分割を決定する

アクション:

  1. システム要件とドメイン境界を明確化
  2. 機能的凝集性と技術的凝集性を分析
  3. モジュール境界の候補を特定
  4. 既存コードベースの依存関係を把握

Task: agents/analyze-architecture.md を参照

Phase 2: モジュール設計

目的: モジュールの責務と依存関係を定義する

アクション:

  1. 各モジュールの責務と境界を定義
  2. モジュール間インターフェースを設計
  3. 依存関係の方向性を決定(依存性逆転)
  4. レイヤー構造を設計

Task: agents/design-modules.md を参照

Phase 3: 実装と検証

目的: 設計に基づいてモジュールを実装し、品質を確認する

アクション:

  1. モジュール構造を実装
  2. 循環依存をチェック
  3. scripts/validate-dependencies.mjs で検証
  4. テストを作成

Task: agents/implement-validate.md を参照

Task仕様ナビ

Task 起動タイミング 入力 出力
analyze-architecture Phase 1開始時 システム要件 分析レポート
design-modules Phase 2開始時 分析レポート モジュール設計書
implement-validate Phase 3開始時 モジュール設計書 実装コード、検証結果

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

ベストプラクティス

すべきこと

推奨事項 理由
ビジネスロジックとインフラを分離 変更容易性の確保
各モジュールに単一責任を持たせる 凝集性の向上
依存性逆転の原則を適用 疎結合の実現
インターフェースを明示的に定義 契約の明確化
依存関係を一方向に保つ 循環依存の防止

避けるべきこと

禁止事項 問題点
神クラス・ゴッドオブジェクトの作成 凝集性の低下
複数関心事を1モジュールに混在 責務の曖昧化
具体実装への直接依存 変更時の影響範囲拡大
循環依存の放置 ビルド・テストの困難化
レイヤー飛び越えアクセス アーキテクチャ崩壊

リソース参照

scripts/(決定論的処理)

スクリプト 機能
scripts/validate-dependencies.mjs 依存関係と循環依存の検証
scripts/log_usage.mjs 使用記録の保存

references/(詳細知識)

リソース パス 読込条件
基本概念 references/basics.md 初回利用時
設計パターン references/patterns.md 設計時
レイヤー設計 references/layered-architecture.md 高度な設計時

変更履歴

Version Date Changes
2.0.0 2026-01-02 18-skills.md仕様完全準拠版として再構築
1.0.0 2025-12-31 初版作成