スキル software-architecture
🏗️

software-architecture

安全

スケーラブルなソフトウェアアーキテクチャを構築

こちらからも入手できます: Doyajin174,Chemiseblanc

カスタムユーティリティやヘルパー関数を再発明するのをやめましょう。このスキルでは、保守性が高くスケーラブルなコードを書くためのクリーンアーキテクチャとドメイン駆動設計の原則を教你します。

対応: Claude Codex Code(CC)
📊 71 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「software-architecture」を使用しています。 このUserServiceクラスをアーキテクチャの問題についてレビューしてください:[ データベースクエリ、API呼び出し、UIレンダリングがすべて混在したUserServiceクラス ]

期待される結果:

検出されたアーキテクチャ問題:1) 混合された関心事 - データベースクエリはリポジトリレイヤーに属する、2) UIレンダリングは別のビューコンポーネントにあるべき、3) API呼び出しは専用サービスにあるべき。推奨リファクタリング:UserRepository(データ)、UserService(ビジネスロジック)、UserView(プレゼンテーション)に分割。

「software-architecture」を使用しています。 決済処理を実装する必要があります。自行uildするか、ライブラリを使用しますか?

期待される結果:

推奨:StripeまたはPaddleを使用し、カスタム決済処理を構築しないでください。これらのサービスはPCIコンプライアンス、請求定期処理、Webhook、月単位で構築する必要があるエッジケースを処理します。既存のソリューションが満たすことができない非常に独特な要件がある場合のみ、カスタム実装を検討してください。

「software-architecture」を使用しています。 Eコマースアプリの注文処理モジュールを設計してください

期待される結果:

推奨アーキテクチャ(DDD):1) エンティティ(ドメイン):Order、OrderItem、OrderStatus。2) リポジトリ:OrderRepository、InventoryRepository。3) サービス:OrderService(placeOrder、cancelOrder)、PaymentService(processPayment)、InventoryService(reserveItems)。4) 避けるべきアンチパターン:ビジネスロジックを行うOrderController、コントローラーでのデータベースクエリ、一般的なOrderUtilsクラス。

セキュリティ監査

安全
v1 • 2/25/2026

All static analysis findings are false positives. Detected 'backtick execution' patterns are markdown code emphasis formatting for library names and file examples. 'Weak cryptographic algorithm' detections are references to 'Clean Architecture' design pattern, not cryptography. 'System reconnaissance' patterns match legitimate software development guidance. This skill contains no executable code and provides educational architecture guidance only.

1
スキャンされたファイル
81
解析された行数
0
検出結果
1
総監査数
セキュリティ問題は見つかりませんでした
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
24
コミュニティ
100
セキュリティ
100
仕様準拠

作れるもの

新規プロジェクトのアーキテクチャ

新しいプロジェクトを開始し、最初の日から堅実なアーキテクチャ基盤を確立する必要がある

レガシーコードのリファクタリング

クリーンアーキテクチャの原則を適用して、既存コードベースのコード品質を向上させる

コードレビュー基準

チームコードレビューとプルリクエストのための一貫したアーキテクチャガイドラインを確立する

これらのプロンプトを試す

コード構造のレビュー
このコードコンポーネントをアーキテクチャの問題についてレビューしてください。確認項目:一般的な命名(utils/ヘルパー)、UIと混合されたビジネスロジック、200行を超えるファイル、50行を超える関数。クリーンアーキテクチャの原則に従って改善案を提案してください。
モジュールアーキテクチャの設計
[feature]モジュールを構築する必要があります。DDDの原則に従ってアーキテクチャを設計してください。エンティティ、サービス、リポジトリのドメイン固有の名前を提案してください。明確な境界と関心の分離を定義してください。
より良いライブラリソリューションを探す
[feature]機能を実装する必要があります。この問題を解決する既存のライブラリやサービスを検索してください。以下の基準に基づいてオプションを評価してください:メンテナンス状況、コミュニティの採用、ドキュメントの品質、要件への適合性。
リファクタリングアンチパターン
このコードベースのアーキテクチャアンチパターンを分析してください:NIH症候群(ライブラリの代わりにカスタム実装)、一般的なファイル名、関心の分離の欠如、深いネスト。具体的なリファクタリング推奨事項を例とともに提供してください。

ベストプラクティス

  • カスタムコードの保守負担を軽減するために、カスタムコードを書く前に既存のライブラリやサービスを検索する
  • 一般的なutilsやヘルパーではなく、OrderCalculatorやUserAuthenticatorなどのドメイン固有の名前を使用する
  • ビジネスロジックをフレームワークから独立させ、UIコンポーネントから分離する
  • アーリーリターンパターンを適用してネストを減らし、コード可読性を向上させる

回避

  • 無関係な関数を持つutils.jsやhelpers.tsファイルを作成し、ドメイン固有のモジュールの代わりにしない
  • ビジネスロジックをUIコンポーネントと混合したり、データベースクエリをコントローラー直接書いたりしない
  • 確立されたライブラリが存在する場合に、カスタム認証、状態管理、フォーム検証を構築する
  • ファイルやモジュールを一般的な名前(common、shared、misc)で、ドメインの目的を明確にせず命名する

よくある質問

クリーンアーキテクチャとは何ですか?
クリーンアーキテクチャは、関心を明確なレイヤーに分離するソフトウェア設計パターンです:ドメインエンティティ(ビジネスルール)、ユースケース(アプリケーションルール)、インターフェースアダプター(コントローラー、プレゼンテーション)、フレームワーク(UI、データベース)。この独立性により、コードはテスト可能で柔軟になります。
utilsやヘルパーのファイルを避けるべき理由は?
一般的なutilsやヘルパーは無関係なコードの垃圾桶になります。これらは明確な目的がなく、保守が困難になります。OrderCalculatorやEmailValidatorなどのドメイン固有の名前は意図を伝え、ビジネスコンテキストに基づいてコードを整理します。
ライブラリを使用する代わりにいつカスタムコードを書くべきですか?
カスタムコードを書くべき 경우는、独特のビジネスロジック、特異なニーズを持つパフォーマンスクリティカルパス、完全な制御が必要なセキュリティ敏感的コード、または徹底的な評価の結果、既存のソリューションが本当に要件を満たしていない場合だけです。
推奨されるファイルサイズ制限は?
可能であれば、関数は50行以下、ファイルは200行以下を維持してください。より長いコンポーネントを小さく焦点を当てた部分に分解してください。コードが他の場所で再利用できない場合は、分割が保守のために必要になるまで同じファイルに保管してください。
このスキルは一般的なコーディングアシスタントとどのように異なりますか?
このスキルは構文や実装の詳細ではなく、アーキテクチャの決定とコードの整理に特に焦点を当てています。特定のアルゴリズムを書いたり、バグを修正したりするのではなく、高レベルの構造デザインパターン、保守性をガイドします。
任意のプログラミング言語にこのスキルを使用できますか?
はい。アーキテクチャの原則(クリーンアーキテクチャ、DDD、関心の分離)はすべての言語に適用されます。ただし、実装の詳細言語とフレームワークによって異なるため、推奨事項を採用してください。

開発者の詳細

ファイル構成

📄 SKILL.md