microsoft-guide について
microsoft-guideは、Microsoftの「.NET Microservices Architecture」第7版のテキストを収録したスキルです。開発者が公式の推奨事項や設計パターン、eShopOnContainersを含む実装例を調べる際に役立ちます。
主な機能
- 01Microsoft .NETマイクロサービスガイド本文
- 02アーキテクチャパターンと推奨事項
- 03DDDとCQRSの解説
- 04DockerとKubernetesのトピック
- 05コード例とeShopOnContainersの詳細
活用シーン
- 01サービス境界とデータ所有権の指針の確認
- 02HTTP通信とメッセージングの比較
- 03回復性パターンの実装方法の調査
- 04コンテナーのデプロイ方法の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ josiahsiegel/ claude-plugin-marketplace --skill microsoft-guideインストール後、Claude Code で/microsoft-guideを入力して読み込まれたか確認します。
詳細
Microsoft .NET マイクロサービスアーキテクチャガイド(v7.0)
このスキルでは、Microsoft の公式ガイド「.NET Microservices Architecture for Containerized .NET Applications」(第7版、ASP.NET Core 7.0 に更新)の全内容を参照できます。
このスキルを使用するタイミング
次のような場合に、このスキルを呼び出してください。
- Microsoft の公式ガイドに基づく詳細な技術情報が必要な場合
- 特定の実装パターンやコード例が必要な場合
- 要約された知識を超える詳細な解説が必要な場合
- マイクロサービスアーキテクチャに関するMicrosoft の公式推奨事項が必要な場合
- eShopOnContainersの実装詳細を参照する場合
- 特定のトピック(DDD、CQRS、Docker、Kubernetes など)を包括的に理解する場合
このスキルの内容
350ページにわたる Microsoft のガイドの全内容(テキストのみ)が含まれています。
- コンテナーの基礎と Docker の概念
- .NET と .NET Framework の選択
- マイクロサービスアーキテクチャの原則
- API ゲートウェイのパターン
- イベント駆動型アーキテクチャ
- ドメイン駆動設計(DDD)の戦術的および戦略的パターン
- CQRS(コマンドクエリ責務分離)
- マイクロサービスにおけるデータ管理
- 回復性のパターン(サーキットブレーカー、リトライ、バルクヘッド)
- セキュリティのベストプラクティス
- Kubernetes とオーケストレーション
- eShopOnContainers のリファレンスアプリケーションの詳細
- 完全なコード例と実装ガイダンス
- すべてのアーキテクチャ概念をテキストで解説(サイズ最適化のため図は削除)
使用方法
ユーザーから次のような質問があった場合:
- 確認が必要な特定の技術的詳細
- コードの実装例
- eShopOnContainers のアーキテクチャの詳細
- Microsoft の公式推奨事項
- 詳細な説明を要する複雑なパターン
このスキルを呼び出し、以下の手順に従ってください。
基本手順
- アーキテクチャ上の判断や実装に関する質問を、境界、サービス、データの所有権、デプロイ先、障害モードといった具体的な観点から言い換えます。
- 記憶だけに頼らず、ガイド内を検索して関連するパターンを確認します。
- Microsoft のガイドによる推奨事項と、プロジェクト固有の制約や新しいプラットフォームのガイダンスを区別します。
- 同期呼び出しと非同期呼び出し、ゲートウェイの配置、データの所有権、デプロイのトポロジーについて、画一的な回答ではなく判断マトリクスを優先します。
- コードや YAML を提示する場合は、特定のパターンに絞った抜粋であることを明記し、実装エージェントにユーザーのランタイム/バージョンに合わせて調整するよう依頼します。
- 自律性と一貫性、レイテンシーと回復性、運用の簡潔さとスケーラビリティのトレードオフを示します。
パターン早見表
| ユーザーの意図 | 確認するガイドの領域 |
|---|---|
| サービス境界を定義する | DDD、境界づけられたコンテキスト、データの所有権 |
| HTTP とメッセージングを選択する | マイクロサービスにおける通信、統合イベント |
| API ゲートウェイを追加する | API ゲートウェイのパターン、Ocelot/YARP に関する考慮事項 |
| 回復性を高める | リトライ、サーキットブレーカー、タイムアウト、ヘルスチェック、Polly |
| データベースを分割する | データ主権、結果整合性、CQRS |
| コンテナーをデプロイする | Docker、Kubernetes、オーケストレーター、環境構成 |
Microsoft ガイドの全内容
ガイドの全内容は、このスキルのディレクトリにあります。
NET-Microservices-Architecture.md
このスキルを呼び出すと、技術的な詳細、コード例、アーキテクチャパターン、実装ガイダンスをすべて含む、Microsoft ガイドの全350ページを収録したこのファイルを参照できます。
使用上の注意
このスキルが呼び出された場合:
- このディレクトリにある NET-Microservices-Architecture.md ファイルを読みます
- Grep を使用して、ユーザーが質問しているトピックを検索します
- Microsoft の公式ガイドの内容に基づいて、詳細かつ正確に回答します
- ガイド内の具体的なセクションやコード例を参照します
- 情報源としてガイドを引用します
注:このガイドには、すべての概念、パターン、実装について包括的なテキスト解説が含まれています。プラグインのサイズを最適化するため、画像への参照は削除されています(18MB から約800KBに縮小)。
コメント
Markdown 対応