mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 21:31:15 +08:00
ec9ace9c54
Translate everything-claude-code repository to Japanese including: - 17 root documentation files - 60 agent documentation files - 80 command documentation files - 99 rule files across 18 language directories (common, angular, arkts, cpp, csharp, dart, fsharp, golang, java, kotlin, perl, php, python, ruby, rust, swift, typescript, web) - 199 skill documentation files Total: 455 files translated to Japanese with: - Consistent terminology glossary applied throughout - YAML field names preserved in English (name, description, etc.) - Code blocks and examples untouched (comments translated) - Markdown structure and relative links preserved - Professional translation maintaining technical accuracy This translation expands ECC accessibility to Japanese-speaking developers and teams. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
73 lines
2.5 KiB
Markdown
73 lines
2.5 KiB
Markdown
---
|
|
paths:
|
|
- "**/*.cs"
|
|
- "**/*.csx"
|
|
---
|
|
# C# コーディングスタイル
|
|
|
|
> このファイルは [common/coding-style.md](../common/coding-style.md) を C# 固有のコンテンツで拡張します。
|
|
|
|
## 標準
|
|
|
|
- 現在の .NET の規約に従い、nullable 参照型を有効にする
|
|
- パブリックおよびインターナル API に明示的なアクセス修飾子を優先する
|
|
- ファイルはそこで定義されている主要な型に合わせて構成する
|
|
|
|
## 型とモデル
|
|
|
|
- イミュータブルな値のようなモデルには `record` または `record struct` を優先する
|
|
- ID とライフサイクルを持つエンティティや型には `class` を使用する
|
|
- サービス境界と抽象化には `interface` を使用する
|
|
- アプリケーションコードで `dynamic` を避ける; ジェネリクスや明示的なモデルを優先する
|
|
|
|
```csharp
|
|
public sealed record UserDto(Guid Id, string Email);
|
|
|
|
public interface IUserRepository
|
|
{
|
|
Task<UserDto?> FindByIdAsync(Guid id, CancellationToken cancellationToken);
|
|
}
|
|
```
|
|
|
|
## イミュータビリティ
|
|
|
|
- 共有状態には `init` セッター、コンストラクタパラメータ、イミュータブルコレクションを優先する
|
|
- 更新された状態を生成する際に入力モデルをインプレースでミューテートしない
|
|
|
|
```csharp
|
|
public sealed record UserProfile(string Name, string Email);
|
|
|
|
public static UserProfile Rename(UserProfile profile, string name) =>
|
|
profile with { Name = name };
|
|
```
|
|
|
|
## 非同期とエラーハンドリング
|
|
|
|
- `.Result` や `.Wait()` のようなブロッキング呼び出しよりも `async`/`await` を優先する
|
|
- パブリックな非同期 API を通じて `CancellationToken` を渡す
|
|
- 特定の例外をスローし、構造化されたプロパティでログを記録する
|
|
|
|
```csharp
|
|
public async Task<Order> LoadOrderAsync(
|
|
Guid orderId,
|
|
CancellationToken cancellationToken)
|
|
{
|
|
try
|
|
{
|
|
return await repository.FindAsync(orderId, cancellationToken)
|
|
?? throw new InvalidOperationException($"Order {orderId} was not found.");
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
logger.LogError(ex, "Failed to load order {OrderId}", orderId);
|
|
throw;
|
|
}
|
|
}
|
|
```
|
|
|
|
## フォーマット
|
|
|
|
- フォーマットとアナライザーの修正には `dotnet format` を使用する
|
|
- `using` ディレクティブを整理し、未使用のインポートを削除する
|
|
- 読みやすさを保てる場合のみ式本体メンバーを優先する
|