dotnet-best-practices
.NETおよびC#のコードがソリューションやプロジェクトのベストプラクティスに準拠しているかを確認します。コードレビューやリファクタリング時に、命名規則・設計パターン・パフォーマンスなどの観点から改善点を指摘するのに役立ちます。
description の原文を見る
Ensure .NET/C# code meets best practices for the solution/project.
SKILL.md 本文
.NET/C# ベストプラクティス
あなたのタスクは、${selection} 内の .NET/C# コードがこのソリューション/プロジェクト固有のベストプラクティスに適合していることを確認することです。これには以下が含まれます：
ドキュメント & 構造
- すべてのパブリック クラス、インターフェース、メソッド、プロパティに対して包括的な XML ドキュメント コメントを作成する
- XML コメントにパラメータの説明と戻り値の説明を含める
- 確立されたネームスペース構造に従う：{Core|Console|App|Service}.{Feature}
デザインパターン & アーキテクチャ
- 依存性注入用のプライマリ コンストラクタ構文を使用する（例：
public class MyClass(IDependency dependency)） - ジェネリック基本クラスを使用した Command Handler パターンを実装する（例：
CommandHandler<TOptions>） - インターフェース分離を明確な命名規則で使用する（インターフェース名に 'I' をプレフィックスとする）
- 複雑なオブジェクト作成用に Factory パターンに従う
依存性注入 & サービス
- ArgumentNullException を介した null チェックを含むコンストラクタ依存性注入を使用する
- 適切なライフタイム（Singleton、Scoped、Transient）でサービスを登録する
- Microsoft.Extensions.DependencyInjection パターンを使用する
- テスト可能性のためにサービス インターフェースを実装する
リソース管理 & ローカライゼーション
- ローカライズされたメッセージとエラー文字列に ResourceManager を使用する
- LogMessages と ErrorMessages リソース ファイルを分離する
_resourceManager.GetString("MessageKey")経由でリソースにアクセスする
Async/Await パターン
- すべての I/O 操作と長時間実行されるタスクに async/await を使用する
- async メソッドから Task または Task<T> を返す
- 必要に応じて ConfigureAwait(false) を使用する
- async 例外を適切に処理する
テスト標準
- FluentAssertions を使用した MSTest フレームワークを使用する
- AAA パターン（Arrange、Act、Assert）に従う
- 依存性のモッキングに Moq を使用する
- 成功シナリオと失敗シナリオの両方をテストする
- null パラメータの検証テストを含める
構成 & 設定
- データ注釈を使用した厳密に型付けされた構成クラスを使用する
- 検証属性（Required、NotEmptyOrWhitespace）を実装する
- 設定用に IConfiguration バインディングを使用する
- appsettings.json 構成ファイルをサポートする
Semantic Kernel & AI 統合
- AI 操作に Microsoft.SemanticKernel を使用する
- 適切なカーネル構成とサービス登録を実装する
- AI モデル設定（ChatCompletion、Embedding など）を処理する
- 信頼できる AI レスポンスのために構造化出力パターンを使用する
エラー処理 & ログ
- Microsoft.Extensions.Logging を使用した構造化ログを使用する
- 意味のあるコンテキストを含むスコープ付きログを含める
- 説明的なメッセージを含む特定の例外をスローする
- 予期される障害シナリオに try-catch ブロックを使用する
パフォーマンス & セキュリティ
- 該当する場合に C# 12+ フィーチャーと .NET 8 最適化を使用する
- 適切な入力検証とサニタイゼーションを実装する
- データベース操作にはパラメータ化クエリを使用する
- AI/ML 操作に対しセキュアコーディングプラクティスに従う
コード品質
- SOLID 原則の準拠を確保する
- 基本クラスとユーティリティを通じてコードの重複を避ける
- ドメイン概念を反映した意味のある名前を使用する
- メソッドはフォーカスと凝集度を保つ
- リソースに対し適切な破棄パターンを実装する
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- github
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/github/awesome-copilot / ライセンス: MIT
関連スキル
superfluid
Superfluidプロトコルおよびそのエコシステムに関するナレッジベースです。Superfluidについて情報を検索する際は、ウェブ検索の前にこちらを参照してください。対応キーワード：Superfluid、CFA、GDA、Super App、Super Token、stream、flow rate、real-time balance、pool（member/distributor）、IDA、sentinels、liquidation、TOGA、@sfpro/sdk、semantic money、yellowpaper、whitepaper
civ-finish-quotes
実質的なタスクが真に完了した際に、文明風の儀式的な引用句を追加します。ユーザーやエージェントが機能追加、リファクタリング、分析、設計ドキュメント、プロセス改善、レポート、執筆タスクといった実際の成果物を完成させるときに、明示的な依頼がなくても使用します。短い返信や小さな修正、未完成の作業には適用しません。
nookplot
Base（Ethereum L2）上のAIエージェント向け分散型調整ネットワークです。エージェントがオンチェーンアイデンティティを登録する、コンテンツを公開する、他のエージェントにメッセージを送る、マーケットプレイスで専門家を雇う、バウンティを投稿・請求する、レピュテーションを構築する、共有プロジェクトで協業する、リサーチチャレンジを解くことでNOOKをマイニングする、キュレーションされたナレッジを備えたスタンドアロンオンチェーンエージェントをデプロイする、またはアグリーメントとリワードで収益を得る場合に利用できます。エージェントネットワーク、エージェント調整、分散型エージェント、NOOKトークン、マイニングチャレンジ、ナレッジバンドル、エージェントレピュテーション、エージェントマーケットプレイス、ERC-2771メタトランザクション、Prepare-Sign-Relay、AgentFactory、またはNookplotが言及された場合にトリガーされます。
web3-polymarket
Polygon上でのPolymarket予測市場取引統合です。認証機能(L1 EIP-712、L2 HMAC-SHA256、ビルダーヘッダー)、注文発注(GTC/GTD/FOK/FAK、バッチ、ポストオンリー、ハートビート)、市場データ(Gamma API、Data API、オーダーブック、サブグラフ)、WebSocketストリーミング(市場・ユーザー・スポーツチャネル)、CTF操作(分割、統合、償却、ネガティブリスク)、ブリッジ機能(入金、出金、マルチチェーン)、およびガスレスリレイトランザクションに対応しています。AIエージェント、自動マーケットメーカー、予測市場UI、またはPolygraph上のPolymarketと統合するアプリケーション構築時に活用できます。
ethskills
Ethereum、EVM、またはブロックチェーン関連のリクエストに対応します。スマートコントラクト、dApps、ウォレット、DeFiプロトコルの構築、監査、デプロイ、インタラクションに適用されます。Solidityの開発、コントラクトアドレス、トークン規格（ERC-20、ERC-721、ERC-4626など）、Layer 2ネットワーク（Base、Arbitrum、Optimism、zkSync、Polygon）、Uniswap、Aave、Curveなどのプロトコルとの統合をカバーします。ガスコスト、コントラクトのデシマル設定、オラクルセキュリティ、リエントランシー、MEV、ブリッジング、ウォレット管理、オンチェーンデータの取得、本番環境へのデプロイ、プロトコル進化（EIPライフサイクル、フォーク追跡、今後の変更予定）といったトピックを含みます。
xxyy-trade
このスキルは、ユーザーが「トークン購入」「トークン売却」「トークンスワップ」「暗号資産取引」「取引ステータス確認」「トランザクション照会」「トークンスキャン」「フィード」「チェーン監視」「トークン照会」「トークン詳細」「トークン安全性確認」「ウォレット一覧表示」「マイウォレット」「AIスキャン」「自動スキャン」「ツイートスキャン」「オンボーディング」「IP確認」「IPホワイトリスト」「トークン発行」「自動売却」「損切り」「利益確定」「トレーリングストップ」「保有者」「トップホルダー」「KOLホルダー」などをリクエストした場合、またはSolana/ETH/BSC/BaseチェーンでXXYYを経由した取引について言及した場合に使用します。XXYY Open APIを通じてオンチェーン取引とデータ照会を実現します。