Skip to content
Skills Library
Programming · Building & coding

csharp-ja

/csharp-ja

C# アプリケーション構築指針 by @tsubakimoto Triggers on: **/*.cs

Repository
skill-0 ↗
Licence
MIT
Last repository change
18.07.2026

Assessment and security

96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 18.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

C# アプリケーション構築指針 by @tsubakimoto Triggers on: **/*.cs

Original author description

C# アプリケーション構築指針 by @tsubakimoto Triggers on: **/*.cs

How it works

  1. C の指針
  2. 全般ガイドライン
  3. 命名規則
  4. フォーマット
  5. プロジェクトのセットアップと構成
  6. Nullable 参照型
  7. データ アクセス パターン
  8. 認証と認可
  9. 検証とエラー処理
  10. API のバージョニングとドキュメント
Original SKILL.md headings · 110 lines, 314 words
SKILL.md preview
---

name: csharp-ja
description: C# アプリケーション構築指針 by @tsubakimoto Triggers on: **/*.cs
triggers: "**/*.cs"
globs: "**/*.cs"
---
# C# アプリケーション開発

## C# の指針
- 常に最新の C# を使用します。現在は C# 14 の機能です。
- 各関数に対して明確で簡潔なコメントを書きます。

## 全般ガイドライン
- コード変更のレビューでは、確信度の高い提案のみを行います。
- なぜその設計判断をしたのかという理由を含むコメントなど、保守性の高い実践に沿ってコードを書きます。
- エッジケースに対応し、明確な例外処理を書きます。
- ライブラリや外部依存については、用途と目的をコメントで明記します。

## 命名規則

- コンポーネント名、メソッド名、公開メンバーには PascalCase を使用します。
- プライベートフィールドとローカル変数には camelCase を使用します。
- インターフェイス名は "I" を接頭辞にします(例: IUserService)。

## フォーマット

- `.editorconfig` で定義されたコードフォーマットスタイルを適用します。
- ファイルスコープの namespace 宣言と 1 行の using ディレクティブを推奨します。
- 任意のコード ブロック(if、for、while、foreach、using、try など)の開始波括弧の前に改行を入れます。
- メソッドの最終 return 文は独立した行に配置します。
- 可能な限りパターンマッチングと switch 式を使用します。
- メンバー名参照には文字列リテラルではなく `nameof` を使用します。
- すべての公開 API に XML ドキュメントコメントを作成します。可能であれば `<example>` と `<code>` も含めます。

## プロジェクトのセットアップと構成

- 適切なテンプレートで新規 .NET プロジェクトを作成する手順を案内します。
- 生成される各ファイルとフォルダーの目的を説明し、プロジェクト構造の理解を助けます。
- フィーチャーフォルダーやドメイン駆動設計(DDD)による整理方法を示します。
- モデル、サービス、データ アクセス層による責務分離を示します。
- ASP.NET Core 10 における Program.cs と構成システム、そして環境別設定を説明します。

## Nullable 参照型

- 変数は非 null で宣言し、エントリポイントで `null` を検査します。
- `== null` や `!= null` ではなく、常に `is null` または `is not null` を使用します。
- C# の null 注釈を信頼し、型システムが値の非 null を保証している場合は不要な null チェックを追加しません。

## データ アクセス パターン

- Entity Framework Core を用いたデータアクセス層の実装を案内します。
- 開発および本番における選択肢(SQL Server、SQLite、In-Memory)を説明します。
- リポジトリパターンの実装と、それが有効となる場面を示します。
- データベースマイグレーションとデータシーディングの実装方法を示します。
- 一般的なパフォーマンス問題を避ける効率的なクエリパターンを説明します。

## 認証と認可

- JWT ベアラートークンを用いた認証の実装を案内します。
- ASP.NET Core に関連する OAuth 2.0 および OpenID Connect の概念を説明します。
- ロールベースおよびポリシーベースの認可の実装方法を示します。
- Microsoft Entra ID(旧 Azure AD)との統合を示します。
- コントローラーベース API と Minimal API の双方を一貫して保護する方法を説明します。

## 検証とエラー処理

- データ注釈と FluentValidation を用いたモデル検証の実装を案内します。
- 検証パイプラインと、検証応答のカスタマイズ方法を説明します。
- ミドルウェアを用いたグローバル例外処理戦略を示します。
- API 全体で一貫したエラー応答を作成する方法を示します。
- 標準化されたエラー応答のための Problem Details(RFC 7807)の実装を説明します。

## API のバージョニングとドキュメント

- API バージョニング戦略の実装とその解説を案内します。
- 適切なドキュメントを伴う Swagger / OpenAPI の実装を示します。
- エンドポイント、パラメーター、応答、認証の文書化方法を示します。
- コントローラーベース API と Minimal API の双方でのバージョニングを説明します。
- 利用者に役立つ有意義な API ドキュメントの作成を案内します。

## ロギングと監視

- Serilog などを用いた構造化ロギングの実装を案内します。
- ログレベルと、それぞれを使用すべき場面を説明します。
- テレメトリ収集のための Application Insights との統合を示します。
- リクエスト追跡のためのカスタムテレメトリと相関 ID の実装方法を示します。
- API のパフォーマンス、エラー、利用パターンの監視方法を説明します。

## テスト

- アプリケーションの重要な経路には必ずテストケースを含めます。
- 単体テストの作成を案内します。
- "Act"、"Arrange"、"Assert" のコメントは記述しません。
- 近傍ファイルの既存スタイル(テストメソッド名や大文字/小文字)に合わせます。
- API エンドポイントの統合テスト手法を説明します。
- 効率的なテストのために依存関係をモックする方法を示します。
- 認証および認可ロジックのテスト方法を示します。
- API 開発に適用するテスト駆動開発(TDD)の原則を説明します。

## パフォーマンス最適化

- キャッシュ戦略(インメモリ、分散、レスポンスキャッシュ)の実装を案内します。
- 非同期プログラミングパターンと、それが API のパフォーマンスにおいて重要である理由を説明します。
- 大規模データセット向けのページング、フィルタリング、ソートを示します。
- 圧縮などのパフォーマンス最適化の実装方法を示します。
- API パフォーマンスの測定とベンチマーク方法を説明します。

## デプロイと DevOps

- .NET の組み込みコンテナーサポート(`dotnet publish --os linux --arch x64 -p:PublishProfile=DefaultContainer`)を用いた API のコンテナー化を案内します。
- 手動で Dockerfile を作成する方法と、.NET のコンテナー公開機能の違いを説明します。
- .NET アプリケーション向け CI/CD パイプラインを説明します。
- Azure App Service、Azure Container Apps、その他のホスティングオプションへのデプロイを示します。
- ヘルスチェックと Readiness Probe の実装方法を示します。
- 各デプロイ段階における環境固有の構成を説明します。

Versions

The database has no other skills named csharp-ja.

Database snapshot: 13.11.2026 · package version c63c8ed6f876 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96csharp
    Guidelines for building C# applications Triggers on: **/*.cs
  • 81csharp-ko
    C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999 Triggers on: **/*.cs
  • 92write-script-csharp
    MUST use when writing C# scripts.
  • 96csharp-testing
    xUnit、FluentAssertions、モッキング、統合テスト、テスト組織のベストプラクティスを使用したC#と.NETのテストパターン。
  • 100lang-csharp
    Use when writing, reviewing, testing or setting up C# (.NET) backend code in a loops run (the csharp language pack) - toolchain, layout, race policy, coverage, idioms and footguns.
  • 95zlua-lua-call-csharp
    Calls C# from Lua through the CSharp root: assemblies, types, constructors, static and instance members, fields, properties, and events. Use when writing Lua that touches CSharp, constructs a C# object, or reads and writes C# members.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.