@k2works/claude-code-booster 2.7.1 → 3.1.0

package/lib/assets/docs/article/getting-start-tdd/clojure/12-error-handling-and-spec.md

@@ -0,0 +1,161 @@
+# 第 12 章: エラーハンドリングと Spec
+
+## 12.1 はじめに
+
+この章では Clojure のエラーハンドリングと、**clojure.spec** によるデータバリデーションを学びます。
+
+## 12.2 例外処理
+
+### try / catch / finally
+
+Clojure は JVM 上で動作するため、Java の例外機構を利用できます。
+
+```clojure
+(try
+  (type/generate-string (type/->FizzBuzzTypeNotDefined)
+                        (model/create-fizz-buzz-value 1))
+  (catch clojure.lang.ExceptionInfo e
+    (println "エラー:" (ex-message e))
+    (println "データ:" (ex-data e))))
+;; エラー: FizzBuzz タイプが未定義です
+;; データ: {:type :not-defined}
+```
+
+### ex-info による構造化エラー
+
+`ex-info` は例外にデータマップを付与できる Clojure 固有の関数です。
+
+```clojure
+;; 例外の生成
+(throw (ex-info "FizzBuzz タイプが未定義です"
+                {:type :not-defined
+                 :requested-type 99}))
+
+;; 例外データの取得
+(try
+  (cmd/execute (cmd/->FizzBuzzValueCommand 1 99))
+  (catch clojure.lang.ExceptionInfo e
+    {:message (ex-message e)
+     :data (ex-data e)}))
+;=> {:message "FizzBuzz タイプが未定義です"
+;    :data {:type :not-defined}}
+```
+
+### ex-info vs Java 例外
+
+| 特徴 | ex-info | Java 例外 |
+|------|---------|-----------|
+| データ付与 | マップで構造化データ | メッセージ文字列のみ |
+| 型 | `ExceptionInfo` | 任意の例外クラス |
+| 活用 | ビジネスロジック | システムレベル |
+
+## 12.3 条件分岐によるエラー処理
+
+### nil を活用したエラー処理
+
+```clojure
+;; some-> マクロ（nil ならショートサーキット）
+(some-> 15
+        model/create-fizz-buzz-value
+        (->> (type/generate-string (type/->FizzBuzzType01))))
+;=> "FizzBuzz"
+
+(some-> nil
+        model/create-fizz-buzz-value
+        (->> (type/generate-string (type/->FizzBuzzType01))))
+;=> nil
+```
+
+### when-let / if-let
+
+```clojure
+(defn safe-fizzbuzz [n]
+  (when-let [value (and (pos? n) (model/create-fizz-buzz-value n))]
+    (type/generate-string (type/->FizzBuzzType01) value)))
+
+(safe-fizzbuzz 3)   ;=> "Fizz"
+(safe-fizzbuzz -1)  ;=> nil
+```
+
+## 12.4 clojure.spec によるバリデーション
+
+### Spec の定義
+
+`clojure.spec.alpha` を使って、データの仕様を宣言的に定義します。
+
+```clojure
+(require '[clojure.spec.alpha :as s])
+
+;; 基本的な Spec 定義
+(s/def ::number pos-int?)
+(s/def ::type-num #{1 2 3})
+(s/def ::fizzbuzz-string (s/or :number string?
+                               :fizz #(= % "Fizz")
+                               :buzz #(= % "Buzz")
+                               :fizzbuzz #(= % "FizzBuzz")))
+```
+
+### バリデーション
+
+```clojure
+;; 値の検証
+(s/valid? ::number 5)     ;=> true
+(s/valid? ::number -1)    ;=> false
+(s/valid? ::type-num 1)   ;=> true
+(s/valid? ::type-num 99)  ;=> false
+
+;; エラー情報の取得
+(s/explain-data ::number -1)
+;=> {:problems [{:path [], :pred pos-int?, :val -1, :via [::number], :in []}]}
+```
+
+### 関数仕様の定義
+
+```clojure
+(s/fdef fizzbuzz
+  :args (s/cat :n ::number)
+  :ret string?)
+
+;; 仕様に基づくテスト生成
+(require '[clojure.spec.test.alpha :as stest])
+(stest/check `fizzbuzz)
+```
+
+### コマンドの Spec
+
+```clojure
+(s/def ::fizzbuzz-value-command
+  (s/keys :req-un [::number ::type-num]))
+
+(s/valid? ::fizzbuzz-value-command
+          {:number 15 :type-num 1})
+;=> true
+```
+
+## 12.5 テストでの活用
+
+```clojure
+(deftest error-handling-test
+  (testing "未定義タイプでコマンド実行すると例外が発生する"
+    (is (thrown? clojure.lang.ExceptionInfo
+                 (cmd/execute (cmd/->FizzBuzzValueCommand 1 99)))))
+
+  (testing "例外のデータを検証する"
+    (try
+      (cmd/execute (cmd/->FizzBuzzValueCommand 1 99))
+      (catch clojure.lang.ExceptionInfo e
+        (is (= {:type :not-defined} (ex-data e)))))))
+```
+
+## 12.6 まとめ
+
+この章では以下のことを学びました。
+
+- **try / catch / finally** による例外処理
+- **ex-info / ex-data** による構造化エラー情報
+- **some->** や **when-let** による nil 安全なエラー処理
+- **clojure.spec** によるデータバリデーション
+- **s/fdef** による関数仕様の定義
+- テストでの例外検証パターン
+
+第 4 部が完了しました。Clojure の関数型プログラミングの全体像を学びました。高階関数、永続データ構造、パイプライン処理、そして Spec によるデータバリデーションが Clojure プログラミングの強力な基盤となります。

package/lib/assets/docs/article/getting-start-tdd/clojure/index.md

@@ -0,0 +1,65 @@
+# テスト駆動開発から始める Clojure 入門
+
+## 概要
+
+FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、プロトコルとマルチメソッドによるポリモーフィズム、関数型プログラミングの活用まで、Clojure の特徴を活かしながら段階的に学びます。
+
+## 対象読者
+
+- Clojure の基本文法を理解しているプログラミング学習者
+- TDD を体験してみたい開発者
+- LISP 系言語の関数型プログラミングと不変データ構造に興味がある方
+
+## 前提条件
+
+- Clojure 1.11 以降がインストールされていること
+- Leiningen が利用可能であること（Nix 環境推奨: `nix develop .#clojure`）
+
+## Clojure の特徴
+
+| 特徴 | 説明 |
+|------|------|
+| S 式（S-expression） | LISP 系のシンプルで統一された構文 |
+| 不変データ構造 | 永続データ構造による安全な並行処理 |
+| プロトコル | `defprotocol` による型ベースのポリモーフィズム |
+| マルチメソッド | `defmulti`/`defmethod` による値ベースのディスパッチ |
+| 高階関数 | `map`/`filter`/`reduce` を中心としたコレクション処理 |
+| スレッディングマクロ | `->`/`->>` によるパイプライン処理 |
+| JVM 上で動作 | Java ライブラリとの相互運用が可能 |
+
+## 開発ツール
+
+| ツール | 用途 |
+|--------|------|
+| [clojure.test](https://clojure.github.io/clojure/clojure.test-api.html) | 標準テスティングフレームワーク |
+| [Leiningen](https://leiningen.org/) | プロジェクト管理・ビルドツール |
+| [Eastwood](https://github.com/jonase/eastwood) | 静的コード解析（Linter） |
+| [Kibit](https://github.com/clj-commons/kibit) | イディオム検査 |
+| [cljfmt](https://github.com/weavejester/cljfmt) | コードフォーマッター |
+| [Makefile](https://www.gnu.org/software/make/) | タスクランナー |
+
+## 目次
+
+### 第 1 部: TDD の基本サイクル
+
+1. [第 1 章: TODO リストと最初のテスト](01-todo-list-and-first-test.md)
+2. [第 2 章: 仮実装と三角測量](02-fake-it-and-triangulation.md)
+3. [第 3 章: 明白な実装とリファクタリング](03-obvious-implementation-and-refactoring.md)
+
+### 第 2 部: 開発環境と自動化
+
+4. [第 4 章: バージョン管理と Conventional Commits](04-version-control-and-conventional-commits.md)
+5. [第 5 章: パッケージ管理と静的解析](05-package-management-and-static-analysis.md)
+6. [第 6 章: タスクランナーと CI/CD](06-task-runner-and-ci-cd.md)
+
+### 第 3 部: プロトコルとマルチメソッド
+
+7. [第 7 章: プロトコルとレコードによるポリモーフィズム](07-protocols-and-records.md)
+8. [第 8 章: マルチメソッドとデザインパターン](08-multimethods-and-design-patterns.md)
+9. [第 9 章: 名前空間とモジュール設計](09-namespaces-and-module-design.md)
+
+### 第 4 部: 関数型プログラミング
+
+10. [第 10 章: 高階関数と関数合成](10-higher-order-functions-and-composition.md)
+11. [第 11 章: 永続データ構造とパイプライン処理](11-persistent-data-and-pipeline.md)
+12. [第 12 章: エラーハンドリングと Spec](12-error-handling-and-spec.md)

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

@@ -0,0 +1,232 @@
+# 第 1 章: TODO リストと最初のテスト
+
+## 1.1 はじめに
+
+プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して **TODO リスト** を作るところから始めます。
+
+> TODO リスト
+>
+> 何をテストすべきだろうか——着手する前に、必要になりそうなテストをリストに書き出しておこう。
+>
+> — テスト駆動開発
+
+## 1.2 仕様の確認
+
+今回取り組む FizzBuzz 問題の仕様は以下の通りです。
+
+```
+1 から 100 までの数をプリントするプログラムを書け。
+ただし 3 の倍数のときは数の代わりに「Fizz」と、5 の倍数のときは「Buzz」とプリントし、
+3 と 5 両方の倍数の場合には「FizzBuzz」とプリントすること。
+```
+
+この仕様をそのままプログラムに落とし込むには少しサイズが大きいですね。最初の作業は仕様を **TODO リスト** に分解する作業から着手しましょう。
+
+## 1.3 TODO リストの作成
+
+仕様を分解して TODO リストを作成します。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [ ] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+まず「1 を渡したら文字列 "1" を返す」という、最も小さなタスクから取り掛かります。
+
+## 1.4 テスティングフレームワークの導入
+
+### テストファースト
+
+最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
+
+> テストファースト
+>
+> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
+>
+> — テスト駆動開発
+
+今回 C# のテスティングフレームワークには **xUnit.net** を利用します。xUnit はテストメソッドに `[Fact]` 属性を付けて宣言し、`Assert.Equal` でアサーションを行います。
+
+### 開発環境のセットアップ
+
+dotnet CLI でプロジェクトを初期化し、テスト環境をセットアップします。
+
+```bash
+# Nix 環境に入る
+$ nix develop .#dotnet
+
+# プロジェクトの初期化
+$ cd apps/dotnet
+$ dotnet new classlib -n FizzBuzz
+$ dotnet new xunit -n FizzBuzzTest
+$ dotnet add FizzBuzzTest/FizzBuzzTest.csproj reference FizzBuzz/FizzBuzz.csproj
+```
+
+xUnit テストプロジェクトの `.csproj` ファイルは以下のようになります。
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <IsPackable>false</IsPackable>
+    <IsTestProject>true</IsTestProject>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
+    <PackageReference Include="xunit" Version="2.5.3" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.5.3" />
+  </ItemGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\FizzBuzz\FizzBuzz.csproj" />
+  </ItemGroup>
+</Project>
+```
+
+### 環境確認テスト
+
+環境が正しく設定されていることを確認するため、学習用テストを書きます。
+
+```csharp
+// FizzBuzzTest/UnitTest1.cs
+namespace FizzBuzzTest;
+
+public class HelloTest
+{
+    [Fact]
+    public void Test_Greeting()
+    {
+        Assert.Equal("hello world", "hello world");
+    }
+}
+```
+
+テストを実行します。
+
+```bash
+$ dotnet test
+成功!   -失敗:     0、合格:     1、スキップ:     0、合計:     1
+```
+
+テストが通りました。xUnit が正常に動作することが確認できました。`Assert.Equal` は Rust の `assert_eq!` や Java の `assertEquals` に相当する C# のアサーション手段です。
+
+## 1.5 仮実装
+
+テスト環境の準備ができたので、TODO リストの最初の作業に取り掛かりましょう。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - **1 を渡したら文字列 "1" を返す**
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+まずはアサーションを最初に書きましょう。
+
+> アサートファースト
+>
+> いつアサーションを書くべきだろうか——最初に書こう。
+>
+> — テスト駆動開発
+
+### Red: 最初のテスト
+
+FizzBuzz のテストを書きます。
+
+```csharp
+// FizzBuzzTest/FizzBuzzTest.cs
+namespace FizzBuzzTest;
+
+using FizzBuzz;
+
+public class FizzBuzzRunnerTest
+{
+    [Fact]
+    public void 数を文字列にして返す_1を渡したら文字列1を返す()
+    {
+        Assert.Equal("1", FizzBuzzRunner.Generate(1));
+    }
+}
+```
+
+テストを実行します。
+
+```bash
+$ dotnet test
+# コンパイルエラー: FizzBuzzRunner が見つからない
+```
+
+`FizzBuzzRunner` クラスがまだ存在しないため、コンパイルエラーが発生します。
+
+### Green: 仮実装
+
+テストを通すために **仮実装** から始めます。
+
+> 仮実装を経て本実装へ
+>
+> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
+>
+> — テスト駆動開発
+
+`FizzBuzzRunner` クラスを定義して、文字列リテラルを返します。
+
+```csharp
+// FizzBuzz/FizzBuzz.cs
+namespace FizzBuzz;
+
+public static class FizzBuzzRunner
+{
+    public static string Generate(int number)
+    {
+        return "1";
+    }
+}
+```
+
+テストを実行します。
+
+```bash
+$ dotnet test
+成功!   -失敗:     0、合格:     1、スキップ:     0、合計:     1
+```
+
+テストが通りました。C# では `static` メソッドとしてクラスに定義し、`return "1"` で文字列リテラルを返します。Rust の `"1".to_string()` と異なり、C# の文字列リテラルはそのまま `string` 型です。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+ここまでの作業をバージョン管理システムにコミットしておきましょう。
+
+```bash
+$ git add .
+$ git commit -m 'test: 数を文字列にして返す'
+```
+
+## 1.6 まとめ
+
+この章では以下のことを学びました。
+
+- **TODO リスト** で仕様をプログラミング対象に分解する方法
+- **テストファースト** で最初にテストを書く考え方
+- xUnit.net のセットアップ（`[Fact]`、`Assert.Equal`）
+- **仮実装** でベタ書きの値を返してテストを通す手法
+- **アサートファースト** でテストの終わりから書き始めるアプローチ
+- C# の `static` クラスと文字列リテラルの基本
+
+次章では、2 つ目のテストケースを追加して **三角測量** を行い、プログラムを一般化していきます。

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

@@ -0,0 +1,244 @@
+# 第 2 章: 仮実装と三角測量
+
+## 2.1 はじめに
+
+前章では、FizzBuzz の仕様を TODO リストに分解し、最初のテストを仮実装で通しました。この章では、**三角測量** によってプログラムを一般化し、さらに FizzBuzz のコアロジックを実装していきます。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+  - [ ] 2 を渡したら文字列 "2" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.2 三角測量
+
+1 を渡したら文字列 "1" を返すようにできました。では、2 を渡したらどうなるでしょうか？
+
+### Red: 2 つ目のテストを書く
+
+```csharp
+[Fact]
+public void 数を文字列にして返す_2を渡したら文字列2を返す()
+{
+    Assert.Equal("2", FizzBuzzRunner.Generate(2));
+}
+```
+
+テストを実行します。
+
+```bash
+$ dotnet test
+失敗!   Expected: "2", Actual: "1"
+```
+
+テストが失敗しました。文字列 "1" しか返さないプログラムなのですから当然です。
+
+### Green: 一般化する
+
+数値を文字列に変換して返すように修正します。C# では `int` 型の `ToString()` メソッドで整数を文字列に変換できます。
+
+```csharp
+public static string Generate(int number)
+{
+    return number.ToString();
+}
+```
+
+テストを実行します。
+
+```bash
+$ dotnet test
+成功!   -失敗:     0、合格:     2、スキップ:     0、合計:     2
+```
+
+テストが通りました。2 つ目のテストによって `Generate` メソッドの一般化を実現できました。このようなアプローチを **三角測量** と言います。
+
+> 三角測量
+>
+> テストから最も慎重に一般化を引き出すやり方はどのようなものだろうか——2 つ以上の例があるときだけ、一般化を行うようにしよう。
+>
+> — テスト駆動開発
+
+Rust では `number.to_string()` と書くところを、C# でも同じく `number.ToString()` を使います。C# の `ToString()` は `object` 型で定義された仮想メソッドであり、すべての型で利用可能です。
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+  - [x] 2 を渡したら文字列 "2" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.3 3 の倍数 — Fizz
+
+次は「3 の倍数のときは数の代わりに Fizz と返す」に取り掛かります。
+
+### Red: 3 の倍数のテスト
+
+```csharp
+[Fact]
+public void 三の倍数のときはFizzを返す_3を渡したらFizzを返す()
+{
+    Assert.Equal("Fizz", FizzBuzzRunner.Generate(3));
+}
+```
+
+```bash
+$ dotnet test
+失敗!   Expected: "Fizz", Actual: "3"
+```
+
+### Green: 明白な実装
+
+3 の倍数のときは "Fizz" を返すように実装します。C# では `%` 演算子で剰余を求め、`== 0` でゼロかどうかを判定します。
+
+```csharp
+public static string Generate(int number)
+{
+    if (number % 3 == 0)
+    {
+        return "Fizz";
+    }
+    return number.ToString();
+}
+```
+
+```bash
+$ dotnet test
+成功!   -失敗:     0、合格:     3、スキップ:     0、合計:     3
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.4 5 の倍数 — Buzz
+
+### Red: 5 の倍数のテスト
+
+```csharp
+[Fact]
+public void 五の倍数のときはBuzzを返す_5を渡したらBuzzを返す()
+{
+    Assert.Equal("Buzz", FizzBuzzRunner.Generate(5));
+}
+```
+
+```bash
+$ dotnet test
+失敗!   Expected: "Buzz", Actual: "5"
+```
+
+### Green: Buzz の実装
+
+```csharp
+public static string Generate(int number)
+{
+    if (number % 3 == 0)
+    {
+        return "Fizz";
+    }
+    if (number % 5 == 0)
+    {
+        return "Buzz";
+    }
+    return number.ToString();
+}
+```
+
+```bash
+$ dotnet test
+成功!   -失敗:     0、合格:     4、スキップ:     0、合計:     4
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.5 15 の倍数 — FizzBuzz
+
+### Red: 15 の倍数のテスト
+
+```csharp
+[Fact]
+public void 三と五の倍数のときはFizzBuzzを返す_15を渡したらFizzBuzzを返す()
+{
+    Assert.Equal("FizzBuzz", FizzBuzzRunner.Generate(15));
+}
+```
+
+```bash
+$ dotnet test
+失敗!   Expected: "FizzBuzz", Actual: "Fizz"
+```
+
+15 は 3 の倍数でもあるため、"Fizz" が返されてしまいました。3 と 5 の両方の倍数の判定を先に行う必要があります。
+
+### Green: FizzBuzz の実装
+
+`if` 文の順序を整理して、3 と 5 の両方の倍数を最初に判定します。
+
+```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();
+}
+```
+
+```bash
+$ dotnet test
+成功!   -失敗:     0、合格:     5、スキップ:     0、合計:     5
+```
+
+Rust では `match` 式のタプルパターンで条件分岐を行いましたが、C# では `if-else if` チェーンを使います。C# にも `switch` 式がありますが、この段階ではシンプルな `if` 文で十分です。
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.6 まとめ
+
+この章では以下のことを学びました。
+
+- **三角測量** で 2 つ以上の例を使ってプログラムを一般化する手法
+- C# の `ToString()` メソッドによる整数から文字列への変換
+- C# の `%` 演算子による剰余判定
+- `if-else if` チェーンによる条件分岐
+- Red-Green-Refactor サイクルを繰り返してコアロジックを段階的に構築する方法
+
+次章では、残りの TODO（リスト生成とプリント）を実装し、リファクタリングで「動作するきれいなコード」を目指します。