@k2works/claude-code-booster 2.7.1 → 3.1.0

package/lib/assets/docs/article/getting-start-tdd/csharp/chapter06.md

@@ -0,0 +1,195 @@
+# 第 6 章: タスクランナーと CI/CD
+
+## 6.1 はじめに
+
+前章では静的コード解析ツールとコードフォーマッターを導入しました。テストの実行、静的解析、フォーマットチェックと、様々なコマンドを使えるようになりましたが、毎回それぞれのコマンドを覚えて実行するのは面倒です。
+
+この章では **タスクランナー** を使ってこれらのタスクをまとめて実行できるようにし、さらに **CI/CD** パイプラインを構築します。
+
+## 6.2 Cake によるタスク管理
+
+### Cake とは
+
+> Cake (C# Make) は C# の DSL で記述するクロスプラットフォームのビルドオーケストレーションツールです。ビルド、テスト、デプロイなどのタスクを C# のコードで定義できます。
+
+Ruby の Rake、Java の Gradle、Rust の Makefile に相当します。C# 開発者にとっては、使い慣れた C# 構文でタスクを定義できるのが利点です。
+
+### Cake のインストール
+
+```bash
+# グローバルツールとしてインストール
+$ dotnet tool install -g Cake.Tool
+
+# またはローカルツールとして
+$ dotnet new tool-manifest
+$ dotnet tool install Cake.Tool
+```
+
+### build.cake の定義
+
+```csharp
+var target = Argument("target", "Default");
+
+Task("Clean")
+    .Does(() =>
+{
+    DotNetClean(".");
+});
+
+Task("Restore")
+    .Does(() =>
+{
+    DotNetRestore(".");
+});
+
+Task("Build")
+    .IsDependentOn("Restore")
+    .Does(() =>
+{
+    DotNetBuild(".", new DotNetBuildSettings
+    {
+        NoRestore = true
+    });
+});
+
+Task("Test")
+    .IsDependentOn("Build")
+    .Does(() =>
+{
+    DotNetTest(".", new DotNetTestSettings
+    {
+        NoRestore = true,
+        NoBuild = true
+    });
+});
+
+Task("Format-Check")
+    .Does(() =>
+{
+    DotNetTool("dotnet format --verify-no-changes");
+});
+
+Task("Check")
+    .IsDependentOn("Format-Check")
+    .IsDependentOn("Build")
+    .IsDependentOn("Test");
+
+Task("Default")
+    .IsDependentOn("Check");
+
+RunTarget(target);
+```
+
+### 主要なタスク
+
+| タスク | コマンド | 説明 |
+|--------|---------|------|
+| `dotnet cake --target=Test` | Build → Test | テスト実行 |
+| `dotnet cake --target=Format-Check` | dotnet format --verify-no-changes | フォーマットチェック |
+| `dotnet cake --target=Check` | Format-Check → Build → Test | 全チェック実行 |
+| `dotnet cake --target=Clean` | dotnet clean | ビルド成果物の削除 |
+| `dotnet cake` | Default (= Check) | デフォルトタスク |
+
+### 実行例
+
+```bash
+# 全チェック実行
+$ dotnet cake
+========================================
+Format-Check
+========================================
+========================================
+Build
+========================================
+========================================
+Test
+========================================
+成功!   -失敗:     0、合格:     7、スキップ:     0
+```
+
+## 6.3 GitHub Actions による CI/CD
+
+### CI/CD とは
+
+> CI/CD（Continuous Integration / Continuous Delivery）は、コードの変更を自動的にビルド、テスト、デプロイするプラクティスです。
+
+### ワークフローの定義
+
+`.github/workflows/dotnet-ci.yml` にワークフローを定義します。
+
+```yaml
+name: .NET CI
+
+on:
+  push:
+    branches: [main, develop]
+    paths:
+      - "apps/dotnet/**"
+      - ".github/workflows/dotnet-ci.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "apps/dotnet/**"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Restore dependencies
+        run: dotnet restore
+        working-directory: apps/dotnet
+
+      - name: Check formatting
+        run: dotnet format --verify-no-changes
+        working-directory: apps/dotnet
+
+      - name: Build
+        run: dotnet build --no-restore
+        working-directory: apps/dotnet
+
+      - name: Run tests
+        run: dotnet test --no-build
+        working-directory: apps/dotnet
+```
+
+### CI パイプラインの流れ
+
+```
+Push / PR → restore → format --verify-no-changes → build → test → 結果通知
+```
+
+## 6.4 他言語との比較
+
+| 言語 | タスクランナー | CI ツール | テスト | 静的解析 | フォーマット |
+|------|-------------|----------|--------|---------|------------|
+| C# | Cake | GitHub Actions | xUnit | Roslyn Analyzers | dotnet format |
+| Rust | Makefile | GitHub Actions | cargo test | Clippy | rustfmt |
+| Go | Makefile | GitHub Actions | go test | golangci-lint | gofmt |
+| Java | Gradle | GitHub Actions | JUnit | Checkstyle + PMD | Checkstyle |
+| Python | tox | GitHub Actions | pytest | Ruff | Ruff |
+| Node | npm scripts | GitHub Actions | Vitest | ESLint | Prettier |
+
+## 6.5 まとめ
+
+この章では以下を実現しました。
+
+| 項目 | 内容 |
+|------|------|
+| Cake | Build / Test / Format-Check / Check タスクを定義 |
+| `dotnet cake` | フォーマットチェック → ビルド → テストを一括実行 |
+| GitHub Actions | push / PR 時に自動で CI を実行 |
+| .NET SDK 統合 | CI でも `dotnet` コマンドで環境を統一 |
+
+第 2 部を通じて、ソフトウェア開発の三種の神器（バージョン管理、テスティング、自動化）を C# の開発環境に整備しました。次の第 3 部では、オブジェクト指向設計（class、interface、デザインパターン）に進みます。

package/lib/assets/docs/article/getting-start-tdd/csharp/chapter07.md

@@ -0,0 +1,214 @@
+# 第 7 章: カプセル化とポリモーフィズム
+
+## 7.1 はじめに
+
+第 1 部では手続き型の FizzBuzz プログラムを TDD で構築しました。この章からは **オブジェクト指向プログラミング** の要素を C# で実現していきます。まず **カプセル化** と **ポリモーフィズム** を導入し、手続き型コードを構造化された設計に進化させます。
+
+## 7.2 手続き型コードの課題
+
+第 1 部で作成した `Generate` メソッドは手続き型プログラミングの典型例です。
+
+```csharp
+public static string Generate(int number)
+{
+    if (number % 3 == 0 && number % 5 == 0) return "FizzBuzz";
+    if (number % 3 == 0) return "Fizz";
+    if (number % 5 == 0) return "Buzz";
+    return number.ToString();
+}
+```
+
+この設計の課題は、新しい FizzBuzz タイプ（数値のみ返す、FizzBuzz のみ返す等）を追加する場合に、既存のメソッドを直接修正する必要があることです。
+
+## 7.3 カプセル化 — 値オブジェクトの導入
+
+### FizzBuzzValue クラス
+
+数値と FizzBuzz の結果をまとめた値オブジェクトを作成します。
+
+```csharp
+namespace FizzBuzz.Domain.Model;
+
+public class FizzBuzzValue : IEquatable<FizzBuzzValue>
+{
+    public int Number { get; }
+    public string Value { get; }
+
+    public FizzBuzzValue(int number, string value)
+    {
+        Number = number;
+        Value = value;
+    }
+
+    public override string ToString() => $"{Number}:{Value}";
+
+    public bool Equals(FizzBuzzValue? other)
+    {
+        if (other is null) return false;
+        if (ReferenceEquals(this, other)) return true;
+        return Number == other.Number && Value == other.Value;
+    }
+
+    public override bool Equals(object? obj) => Equals(obj as FizzBuzzValue);
+    public override int GetHashCode() => HashCode.Combine(Number, Value);
+}
+```
+
+C# ではプロパティ（`{ get; }` のみの読み取り専用プロパティ）でフィールドをカプセル化します。`IEquatable<T>` インターフェースを実装して値の等価性を保証します。Rust の `#[derive(PartialEq)]` に相当する機能ですが、C# では手動で実装する必要があります。
+
+### テストの作成
+
+```csharp
+public class FizzBuzzValueTest
+{
+    [Fact]
+    public void 値を保持する()
+    {
+        var value = new FizzBuzzValue(1, "1");
+        Assert.Equal(1, value.Number);
+        Assert.Equal("1", value.Value);
+    }
+
+    [Fact]
+    public void 同じ値のオブジェクトは等しい()
+    {
+        var value1 = new FizzBuzzValue(1, "1");
+        var value2 = new FizzBuzzValue(1, "1");
+        Assert.Equal(value1, value2);
+    }
+}
+```
+
+## 7.4 ポリモーフィズム — interface の導入
+
+### IFizzBuzzType インターフェース
+
+FizzBuzz のタイプを抽象化するインターフェースを定義します。
+
+```csharp
+namespace FizzBuzz.Domain.Type;
+
+using FizzBuzz.Domain.Model;
+
+public interface IFizzBuzzType
+{
+    FizzBuzzValue Generate(int number);
+}
+```
+
+C# の `interface` は Rust の `trait` や Java の `interface` に相当します。実装クラスは明示的に `: IFizzBuzzType` と宣言してインターフェースを実装します。
+
+### 3 つの実装
+
+```csharp
+// タイプ 1: 通常の FizzBuzz
+public class FizzBuzzType01 : IFizzBuzzType
+{
+    private const int FizzNumber = 3;
+    private const int BuzzNumber = 5;
+
+    public FizzBuzzValue Generate(int number)
+    {
+        string value;
+        if (IsFizzBuzz(number)) value = "FizzBuzz";
+        else if (IsFizz(number)) value = "Fizz";
+        else if (IsBuzz(number)) value = "Buzz";
+        else value = number.ToString();
+
+        return new FizzBuzzValue(number, value);
+    }
+
+    private static bool IsFizz(int number) => number % FizzNumber == 0;
+    private static bool IsBuzz(int number) => number % BuzzNumber == 0;
+    private static bool IsFizzBuzz(int number) => IsFizz(number) && IsBuzz(number);
+}
+
+// タイプ 2: 数値のみ
+public class FizzBuzzType02 : IFizzBuzzType
+{
+    public FizzBuzzValue Generate(int number)
+    {
+        return new FizzBuzzValue(number, number.ToString());
+    }
+}
+
+// タイプ 3: 15 の倍数のみ FizzBuzz
+public class FizzBuzzType03 : IFizzBuzzType
+{
+    private const int FizzBuzzNumber = 15;
+
+    public FizzBuzzValue Generate(int number)
+    {
+        var value = number % FizzBuzzNumber == 0 ? "FizzBuzz" : number.ToString();
+        return new FizzBuzzValue(number, value);
+    }
+}
+```
+
+### テストの作成
+
+```csharp
+public class FizzBuzzType01Test
+{
+    private readonly IFizzBuzzType _type = new FizzBuzzType01();
+
+    [Fact]
+    public void 数を文字列にして返す()
+    {
+        Assert.Equal("1", _type.Generate(1).Value);
+    }
+
+    [Fact]
+    public void 三の倍数のときはFizzを返す()
+    {
+        Assert.Equal("Fizz", _type.Generate(3).Value);
+    }
+
+    [Fact]
+    public void 五の倍数のときはBuzzを返す()
+    {
+        Assert.Equal("Buzz", _type.Generate(5).Value);
+    }
+
+    [Fact]
+    public void 三と五の倍数のときはFizzBuzzを返す()
+    {
+        Assert.Equal("FizzBuzz", _type.Generate(15).Value);
+    }
+}
+```
+
+## 7.5 ファクトリメソッド
+
+タイプ番号から適切な実装を返すファクトリメソッドを作成します。
+
+```csharp
+public static class FizzBuzzTypeFactory
+{
+    public static IFizzBuzzType Create(int type)
+    {
+        return type switch
+        {
+            1 => new FizzBuzzType01(),
+            2 => new FizzBuzzType02(),
+            3 => new FizzBuzzType03(),
+            _ => throw new ArgumentException($"Invalid FizzBuzz type: {type}")
+        };
+    }
+}
+```
+
+C# の `switch` 式は Rust の `match` 式に近い構文で、値を返す式として使えます。`_` はデフォルトケースで、Rust のワイルドカードパターンと同じです。不正なタイプ番号の場合は `ArgumentException` をスローします。
+
+## 7.6 まとめ
+
+この章では以下を学びました。
+
+| 概念 | C# の実現方法 | 他言語の対応 |
+|------|-------------|-------------|
+| カプセル化 | `class` + 読み取り専用プロパティ | Rust: struct + 非公開フィールド |
+| ポリモーフィズム | `interface` + 明示的実装 | Rust: trait + impl |
+| 値オブジェクト | `IEquatable<T>` + `GetHashCode` | Rust: `#[derive(PartialEq)]` |
+| ファクトリ | `switch` 式 + `ArgumentException` | Rust: `match` + `Result` |
+
+次章では、デザインパターン（Command、First-Class Collection）を適用していきます。

package/lib/assets/docs/article/getting-start-tdd/csharp/chapter08.md

@@ -0,0 +1,249 @@
+# 第 8 章: デザインパターンの適用
+
+## 8.1 はじめに
+
+前章では class と interface を使ってカプセル化とポリモーフィズムを実現しました。この章では **デザインパターン** を適用して、設計をさらに改善します。
+
+## 8.2 Value Object パターン
+
+### FizzBuzzValue の強化
+
+前章で作成した `FizzBuzzValue` は既に Value Object パターンを実現しています。
+
+```csharp
+public class FizzBuzzValue : IEquatable<FizzBuzzValue>
+{
+    public int Number { get; }
+    public string Value { get; }
+
+    public FizzBuzzValue(int number, string value)
+    {
+        Number = number;
+        Value = value;
+    }
+
+    public override string ToString() => $"{Number}:{Value}";
+
+    public bool Equals(FizzBuzzValue? other)
+    {
+        if (other is null) return false;
+        if (ReferenceEquals(this, other)) return true;
+        return Number == other.Number && Value == other.Value;
+    }
+
+    public override bool Equals(object? obj) => Equals(obj as FizzBuzzValue);
+    public override int GetHashCode() => HashCode.Combine(Number, Value);
+}
+```
+
+`IEquatable<T>` の実装により、2 つの `FizzBuzzValue` を値で比較できます。読み取り専用プロパティにより不変性が保証されます。Rust の `#[derive(PartialEq, Clone)]` に対し、C# では `IEquatable<T>` と `GetHashCode` を明示的に実装します。
+
+## 8.3 First-Class Collection パターン
+
+### FizzBuzzList クラス
+
+FizzBuzzValue のコレクションを専用の型でラップします。
+
+```csharp
+namespace FizzBuzz.Domain.Model;
+
+public class FizzBuzzList : IEquatable<FizzBuzzList>
+{
+    private readonly List<FizzBuzzValue> _values;
+
+    public IReadOnlyList<FizzBuzzValue> Values => _values.AsReadOnly();
+
+    public FizzBuzzList()
+    {
+        _values = new List<FizzBuzzValue>();
+    }
+
+    public FizzBuzzList(List<FizzBuzzValue> values)
+    {
+        _values = new List<FizzBuzzValue>(values);
+    }
+
+    public FizzBuzzValue Get(int index) => _values[index];
+    public int Count => _values.Count;
+
+    public FizzBuzzList Add(FizzBuzzValue value)
+    {
+        var newValues = new List<FizzBuzzValue>(_values) { value };
+        return new FizzBuzzList(newValues);
+    }
+
+    public List<string> ToStringValues()
+    {
+        return _values.Select(v => v.Value).ToList();
+    }
+
+    // ...等価性の実装
+}
+```
+
+First-Class Collection パターンにより、コレクション操作の責務を `FizzBuzzList` に集約できます。`Add` メソッドは新しいリストを返すイミュータブルな設計です。`IReadOnlyList<T>` で公開することで外部からの変更を防ぎます。
+
+### テストの作成
+
+```csharp
+public class FizzBuzzListTest
+{
+    [Fact]
+    public void 空のリストを作成できる()
+    {
+        var list = new FizzBuzzList();
+        Assert.Equal(0, list.Count);
+    }
+
+    [Fact]
+    public void 値を追加できる()
+    {
+        var list = new FizzBuzzList();
+        var newList = list.Add(new FizzBuzzValue(1, "1"));
+        Assert.Equal(1, newList.Count);
+        Assert.Equal(0, list.Count); // 元のリストは変更されない
+    }
+
+    [Fact]
+    public void 文字列リストに変換できる()
+    {
+        var list = new FizzBuzzList(new List<FizzBuzzValue>
+        {
+            new FizzBuzzValue(1, "1"),
+            new FizzBuzzValue(3, "Fizz"),
+            new FizzBuzzValue(5, "Buzz")
+        });
+        var strings = list.ToStringValues();
+        Assert.Equal(new List<string> { "1", "Fizz", "Buzz" }, strings);
+    }
+}
+```
+
+## 8.4 Command パターン
+
+### IFizzBuzzCommand インターフェース
+
+FizzBuzz の操作をコマンドとして抽象化します。
+
+```csharp
+namespace FizzBuzz.Application;
+
+using FizzBuzz.Domain.Model;
+
+public interface IFizzBuzzCommand
+{
+    FizzBuzzValue ExecuteValue(int number);
+    FizzBuzzList ExecuteList(int count);
+}
+```
+
+### 単一値コマンド
+
+```csharp
+public class FizzBuzzValueCommand : IFizzBuzzCommand
+{
+    private readonly IFizzBuzzType _type;
+
+    public FizzBuzzValueCommand(IFizzBuzzType type)
+    {
+        _type = type;
+    }
+
+    public FizzBuzzValue ExecuteValue(int number)
+    {
+        return _type.Generate(number);
+    }
+
+    public FizzBuzzList ExecuteList(int count)
+    {
+        throw new NotSupportedException(
+            "FizzBuzzValueCommand does not support list execution.");
+    }
+}
+```
+
+### リストコマンド
+
+```csharp
+public class FizzBuzzListCommand : IFizzBuzzCommand
+{
+    private readonly IFizzBuzzType _type;
+
+    public FizzBuzzListCommand(IFizzBuzzType type)
+    {
+        _type = type;
+    }
+
+    public FizzBuzzValue ExecuteValue(int number)
+    {
+        throw new NotSupportedException(
+            "FizzBuzzListCommand does not support single value execution.");
+    }
+
+    public FizzBuzzList ExecuteList(int count)
+    {
+        var values = Enumerable.Range(1, count)
+            .Select(i => _type.Generate(i))
+            .ToList();
+        return new FizzBuzzList(values);
+    }
+}
+```
+
+コンストラクタインジェクションで `IFizzBuzzType` を受け取ることで、具体的なタイプに依存しない設計を実現しています。
+
+### テストの作成
+
+```csharp
+public class FizzBuzzCommandTest
+{
+    [Fact]
+    public void ValueCommandで単一値を取得できる()
+    {
+        var command = new FizzBuzzValueCommand(
+            FizzBuzzTypeFactory.Create(FizzBuzzTypeName.Standard));
+        var result = command.ExecuteValue(3);
+        Assert.Equal("Fizz", result.Value);
+    }
+
+    [Fact]
+    public void ListCommandでリストを生成できる()
+    {
+        var command = new FizzBuzzListCommand(
+            FizzBuzzTypeFactory.Create(FizzBuzzTypeName.Standard));
+        var result = command.ExecuteList(100);
+        Assert.Equal(100, result.Count);
+    }
+}
+```
+
+## 8.5 Strategy パターン
+
+`IFizzBuzzType` インターフェースと 3 つの実装クラス（`FizzBuzzType01`, `FizzBuzzType02`, `FizzBuzzType03`）は、Strategy パターンを実現しています。コマンドのコンストラクタに異なる `IFizzBuzzType` を渡すことで、同じインターフェースで異なる振る舞いを切り替えられます。
+
+### Factory Method パターン
+
+`FizzBuzzTypeFactory.Create` メソッドは Factory Method パターンです。
+
+```csharp
+public static IFizzBuzzType Create(FizzBuzzTypeName name)
+{
+    return Create((int)name);
+}
+```
+
+`FizzBuzzTypeName` enum を使うことで、型安全なファクトリ呼び出しが可能です。
+
+## 8.6 まとめ
+
+この章では以下のデザインパターンを適用しました。
+
+| パターン | 目的 | C# の実現方法 |
+|---------|------|-------------|
+| Value Object | 値の等価性保証 | `IEquatable<T>` + 読み取り専用プロパティ |
+| First-Class Collection | コレクション操作の集約 | `class` + `List<T>` + `IReadOnlyList<T>` |
+| Command | 操作の抽象化と遅延実行 | `interface` + コンストラクタインジェクション |
+| Strategy | アルゴリズムの交換可能性 | `interface` + 複数の実装クラス |
+| Factory Method | タイプ番号による生成 | `switch` 式 + `static` メソッド |
+
+次章では SOLID 原則の観点から設計を評価し、モジュール分割を行います。