@k2works/claude-code-booster 2.7.1 → 3.1.0

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

@@ -0,0 +1,83 @@
+# テスト駆動開発から始める Go 入門
+
+## 概要
+
+FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、オブジェクト指向設計、関数型プログラミングの活用まで、Go の特徴を活かしながら段階的に学びます。
+
+## 対象読者
+
+- Go の基本文法を理解しているプログラミング学習者
+- TDD を体験してみたい開発者
+- オブジェクト指向設計や関数型プログラミングに興味がある方
+
+## 前提条件
+
+- Go 1.25 以降がインストールされていること
+- golangci-lint が利用可能であること（Nix 環境推奨: `nix develop .#go`）
+
+## Go の特徴
+
+| 特徴 | 説明 |
+|------|------|
+| 静的型付け | コンパイル時に型を検査、安全で高速なバイナリを生成 |
+| シンプルな言語設計 | 25 個のキーワード、少ない構文で高い生産性 |
+| 暗黙的インターフェース | `implements` 宣言不要、メソッドセットで自動的に満たす |
+| 構造体埋め込み | 継承の代わりにコンポジションで型を拡張 |
+| ファーストクラス関数 | 関数を値として扱い、クロージャをサポート |
+| ジェネリクス（Go 1.18+） | 型パラメータによる汎用的なコード |
+
+## 開発ツール
+
+| ツール | 用途 |
+|--------|------|
+| [testing](https://pkg.go.dev/testing) | 標準テスティングパッケージ |
+| [Go Modules](https://go.dev/ref/mod) | パッケージ管理 |
+| [golangci-lint](https://golangci-lint.run/) | リンター（複数ルール統合） |
+| [gofmt](https://pkg.go.dev/cmd/gofmt) | 標準フォーマッター |
+| [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-encapsulation-and-polymorphism.md)
+8. [第 8 章: デザインパターンの適用](08-design-patterns.md)
+9. [第 9 章: SOLID 原則とモジュール設計](09-solid-principles-and-module-design.md)
+
+### 第 4 部: 関数型プログラミングへの展開
+
+10. [第 10 章: 高階関数と関数合成](10-higher-order-functions-and-composition.md)
+11. [第 11 章: 不変データとパイプライン処理](11-immutable-data-and-pipeline.md)
+12. [第 12 章: エラーハンドリングと型安全性](12-error-handling-and-type-safety.md)
+
+## 実装コード
+
+本記事のすべてのコード例は `apps/go/` に実装されています。
+
+```bash
+# 開発環境に入る
+nix develop .#go
+
+# テスト実行
+cd apps/go
+make test
+```
+
+## 参考文献
+
+- Kent Beck 著『テスト駆動開発』
+- Martin Fowler 著『リファクタリング: 既存のコードを安全に改善する』
+- Robert C. Martin 著『Clean Code: アジャイルソフトウェア達人の技』
+- Alan A. A. Donovan, Brian W. Kernighan 著『プログラミング言語 Go』

package/lib/assets/docs/article/getting-start-tdd/haskell/01-todo-list-and-first-test.md

@@ -0,0 +1,279 @@
+# 第 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 テスティングフレームワークの導入
+
+### テストファースト
+
+最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
+
+> テストファースト
+>
+> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
+>
+> — テスト駆動開発
+
+今回 Haskell のテスティングフレームワークには **HSpec** を利用します。HSpec は BDD（振る舞い駆動開発）スタイルのテストフレームワークで、`describe` と `it` を使って自然言語に近い形式でテストを記述できます。
+
+### 開発環境のセットアップ
+
+Stack でプロジェクトを初期化し、テスト環境をセットアップします。
+
+```bash
+# Nix 環境に入る
+$ nix develop .#haskell
+
+# プロジェクトの初期化
+$ cd apps
+$ stack new haskell simple
+$ cd haskell
+```
+
+`package.yaml` にテストの依存関係を設定します。
+
+```yaml
+name:                fizzbuzz
+version:             0.1.0.0
+synopsis:            FizzBuzz TDD implementation in Haskell
+description:         A FizzBuzz implementation using Test-Driven Development
+license:             BSD-3-Clause
+author:              k2works
+
+dependencies:
+  - base >= 4.7 && < 5
+
+library:
+  source-dirs: src
+  exposed-modules:
+    - FizzBuzz
+
+tests:
+  fizzbuzz-test:
+    main: Spec.hs
+    source-dirs: test
+    dependencies:
+      - fizzbuzz
+      - hspec
+    build-tools:
+      - hspec-discover
+```
+
+`hspec-discover` を使うことで、テストファイルを自動的に検出してくれます。テストのエントリポイントとなる `test/Spec.hs` には以下の 1 行だけを記述します。
+
+```haskell
+-- test/Spec.hs
+{-# OPTIONS_GHC -F -pgmF hspec-discover #-}
+```
+
+この GHC プリプロセッサディレクティブにより、`test/` 配下の `*Spec.hs` ファイルが自動的にテストスイートに組み込まれます。
+
+### 環境確認テスト
+
+環境が正しく設定されていることを確認するため、学習用テストを書きます。`test/FizzBuzz/FizzBuzzSpec.hs` を作成します。
+
+```haskell
+-- test/FizzBuzz/FizzBuzzSpec.hs
+module FizzBuzz.FizzBuzzSpec (spec) where
+
+import Test.Hspec
+
+spec :: Spec
+spec = do
+  describe "learning test" $ do
+    it "整数を文字列へ変換できる" $
+      show 42 `shouldBe` "42"
+```
+
+テストを実行します。
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  learning test
+    整数を文字列へ変換できる
+
+Finished in 0.0001 seconds
+1 example, 0 failures
+```
+
+テストが通りました。HSpec が正常に動作することが確認できました。`shouldBe` は HSpec の Matcher で、期待値と実際の値が等しいことを検証します。Haskell の `show` 関数は `Show` 型クラスに属する任意の値を文字列に変換します。これは Rust の `to_string()`（`Display` トレイト）や Python の `str()` に相当します。
+
+## 1.5 仮実装
+
+テスト環境の準備ができたので、TODO リストの最初の作業に取り掛かりましょう。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - **1 を渡したら文字列 "1" を返す**
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+まずはアサーションを最初に書きましょう。
+
+> アサートファースト
+>
+> いつアサーションを書くべきだろうか——最初に書こう。
+>
+> — テスト駆動開発
+
+### Red: 最初のテスト
+
+まずプロダクトコードのモジュールを作成します。`src/FizzBuzz.hs` を作ります。
+
+```haskell
+-- src/FizzBuzz.hs
+module FizzBuzz
+  ( generate
+  ) where
+
+generate :: Int -> String
+generate = undefined
+```
+
+Haskell の `undefined` は「まだ実装されていない」ことを表す値で、評価されると例外を投げます。Rust の `todo!()` マクロに相当します。
+
+テストファイルを更新して、FizzBuzz のテストを書きます。
+
+```haskell
+-- test/FizzBuzz/FizzBuzzSpec.hs
+module FizzBuzz.FizzBuzzSpec (spec) where
+
+import Test.Hspec
+import FizzBuzz
+
+spec :: Spec
+spec = do
+  describe "generate" $ do
+    it "1 を渡すと '1' を返す" $
+      generate 1 `shouldBe` "1"
+```
+
+テストを実行します。
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す FAILED [1]
+
+Failures:
+
+  test/FizzBuzz/FizzBuzzSpec.hs:9:7:
+  1) generate 1 を渡すと '1' を返す
+       evaluate raised an unexpected exception:
+         Prelude.undefined
+
+1 example, 1 failure
+```
+
+`Prelude.undefined` -- まだ実装されていません。`undefined` が評価され、例外が発生しました。
+
+### Green: 仮実装
+
+テストを通すために **仮実装** から始めます。
+
+> 仮実装を経て本実装へ
+>
+> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
+>
+> — テスト駆動開発
+
+`generate` 関数を定義して、文字列リテラルを返します。
+
+```haskell
+-- src/FizzBuzz.hs
+module FizzBuzz
+  ( generate
+  ) where
+
+generate :: Int -> String
+generate _ = "1"
+```
+
+引数のパターンに `_`（ワイルドカード）を使い、どんな値が来ても無視して `"1"` を返します。これは Rust の `"1".to_string()` をベタ書きするのと同じ仮実装です。Haskell では文字列リテラル `"1"` がそのまま `String` 型（`[Char]` の型エイリアス）になるため、Rust のような `to_string()` 変換は不要です。
+
+テストを実行します。
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す
+
+Finished in 0.0001 seconds
+1 example, 0 failures
+```
+
+テストが通りました。
+
+**TODO リスト**:
+
+- [ ] 数を文字列にして返す
+  - [x] 1 を渡したら文字列 "1" を返す
+- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+ここまでの作業をバージョン管理システムにコミットしておきましょう。
+
+```bash
+$ git add .
+$ git commit -m 'test: 数を文字列にして返す'
+```
+
+## 1.6 まとめ
+
+この章では以下のことを学びました。
+
+- **TODO リスト** で仕様をプログラミング対象に分解する方法
+- **テストファースト** で最初にテストを書く考え方
+- HSpec テストフレームワーク（`describe`、`it`、`shouldBe`）のセットアップ
+- `hspec-discover` による自動テスト検出
+- **仮実装** でベタ書きの値を返してテストを通す手法
+- **アサートファースト** でテストの終わりから書き始めるアプローチ
+- Haskell の `undefined`（未実装マーカー）と `show`（文字列変換）
+
+次章では、2 つ目のテストケースを追加して **三角測量** を行い、プログラムを一般化していきます。

package/lib/assets/docs/article/getting-start-tdd/haskell/02-fake-it-and-triangulation.md

@@ -0,0 +1,337 @@
+# 第 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 つ目のテストを書く
+
+```haskell
+    it "2 を渡すと '2' を返す" $
+      generate 2 `shouldBe` "2"
+```
+
+テストを実行します。
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す
+    2 を渡すと '2' を返す FAILED [1]
+
+Failures:
+
+  test/FizzBuzz/FizzBuzzSpec.hs:12:7:
+  1) generate 2 を渡すと '2' を返す
+       expected: "2"
+        but got: "1"
+
+2 examples, 1 failure
+```
+
+テストが失敗しました。文字列 "1" しか返さないプログラムなのですから当然です。
+
+### Green: 一般化する
+
+数値を文字列に変換して返すように修正します。Haskell では `show` 関数で `Show` 型クラスのインスタンスを文字列に変換できます。
+
+```haskell
+generate :: Int -> String
+generate n = show n
+```
+
+テストを実行します。
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す
+    2 を渡すと '2' を返す
+
+Finished in 0.0001 seconds
+2 examples, 0 failures
+```
+
+テストが通りました。2 つ目のテストによって `generate` 関数の一般化を実現できました。このようなアプローチを **三角測量** と言います。
+
+> 三角測量
+>
+> テストから最も慎重に一般化を引き出すやり方はどのようなものだろうか——2 つ以上の例があるときだけ、一般化を行うようにしよう。
+>
+> — テスト駆動開発
+
+Rust では `number.to_string()` と書くところを、Haskell では `show n` を使います。Haskell の `show` は `Show` 型クラスを実装した任意の型で利用でき、Rust の `Display` トレイトと同様の役割を果たします。
+
+**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 の倍数のテスト
+
+```haskell
+    it "3 の倍数を渡すと 'Fizz' を返す" $
+      generate 3 `shouldBe` "Fizz"
+```
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す
+    2 を渡すと '2' を返す
+    3 の倍数を渡すと 'Fizz' を返す FAILED [1]
+
+Failures:
+
+  test/FizzBuzz/FizzBuzzSpec.hs:15:7:
+  1) generate 3 の倍数を渡すと 'Fizz' を返す
+       expected: "Fizz"
+        but got: "3"
+
+3 examples, 1 failure
+```
+
+### Green: ガード式による条件分岐
+
+3 の倍数のときは "Fizz" を返すように実装します。Haskell では **ガード式** を使って条件分岐を記述します。
+
+```haskell
+generate :: Int -> String
+generate n
+  | n `mod` 3 == 0 = "Fizz"
+  | otherwise       = show n
+```
+
+ガード式は `|` の後に条件を書き、`=` の後に条件が真のときの返り値を記述します。`otherwise` は常に `True` を返す定数で、すべての条件に合致しなかった場合のデフォルトケースとして機能します。`mod` 関数はバッククォートで囲むことで中置演算子として使えます（`n `mod` 3` は `mod n 3` と同じ意味です）。
+
+Rust の `if` 式や `match` 式に比べ、Haskell のガード式は数学的な関数定義に近い書き方ができます。
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す
+    2 を渡すと '2' を返す
+    3 の倍数を渡すと 'Fizz' を返す
+
+Finished in 0.0001 seconds
+3 examples, 0 failures
+```
+
+テストが通りました。三角測量として 6 のテストも追加して確認します。
+
+```haskell
+    it "6 を渡すと 'Fizz' を返す" $
+      generate 6 `shouldBe` "Fizz"
+```
+
+```bash
+$ stack test
+4 examples, 0 failures
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [ ] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.4 5 の倍数 -- Buzz
+
+### Red: 5 の倍数のテスト
+
+```haskell
+    it "5 の倍数を渡すと 'Buzz' を返す" $
+      generate 5 `shouldBe` "Buzz"
+```
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    5 の倍数を渡すと 'Buzz' を返す FAILED [1]
+
+Failures:
+
+  test/FizzBuzz/FizzBuzzSpec.hs:21:7:
+  1) generate 5 の倍数を渡すと 'Buzz' を返す
+       expected: "Buzz"
+        but got: "5"
+
+5 examples, 1 failure
+```
+
+### Green: Buzz の実装
+
+ガード式に 5 の倍数の条件を追加します。
+
+```haskell
+generate :: Int -> String
+generate n
+  | n `mod` 3 == 0 = "Fizz"
+  | n `mod` 5 == 0 = "Buzz"
+  | otherwise       = show n
+```
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す
+    2 を渡すと '2' を返す
+    3 の倍数を渡すと 'Fizz' を返す
+    5 の倍数を渡すと 'Buzz' を返す
+    6 を渡すと 'Fizz' を返す
+
+Finished in 0.0001 seconds
+5 examples, 0 failures
+```
+
+三角測量として 10 のテストも追加します。
+
+```haskell
+    it "10 を渡すと 'Buzz' を返す" $
+      generate 10 `shouldBe` "Buzz"
+```
+
+```bash
+$ stack test
+6 examples, 0 failures
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+## 2.5 15 の倍数 -- FizzBuzz
+
+### Red: 15 の倍数のテスト
+
+```haskell
+    it "15 の倍数を渡すと 'FizzBuzz' を返す" $
+      generate 15 `shouldBe` "FizzBuzz"
+```
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    15 の倍数を渡すと 'FizzBuzz' を返す FAILED [1]
+
+Failures:
+
+  test/FizzBuzz/FizzBuzzSpec.hs:27:7:
+  1) generate 15 の倍数を渡すと 'FizzBuzz' を返す
+       expected: "FizzBuzz"
+        but got: "Fizz"
+
+7 examples, 1 failure
+```
+
+15 は 3 の倍数でもあるため、"Fizz" が返されてしまいました。ガード式は上から順番に評価されるので、3 の倍数の条件に先にマッチしてしまいます。3 と 5 の両方の倍数（つまり 15 の倍数）の判定を **先に** 行う必要があります。
+
+### Green: ガード式の順序を修正
+
+```haskell
+generate :: Int -> String
+generate n
+  | n `mod` 15 == 0 = "FizzBuzz"
+  | n `mod` 3 == 0  = "Fizz"
+  | n `mod` 5 == 0  = "Buzz"
+  | otherwise        = show n
+```
+
+ガード式は上から順に評価されるため、最も限定的な条件（15 の倍数）を最初に配置します。これは Rust の `match` 式のパターンの並び順や、Go の `switch` 文の `case` の順序と同じ考え方です。
+
+```bash
+$ stack test
+FizzBuzz.FizzBuzzSpec
+  generate
+    1 を渡すと '1' を返す
+    2 を渡すと '2' を返す
+    3 の倍数を渡すと 'Fizz' を返す
+    5 の倍数を渡すと 'Buzz' を返す
+    6 を渡すと 'Fizz' を返す
+    10 を渡すと 'Buzz' を返す
+    15 の倍数を渡すと 'FizzBuzz' を返す
+
+Finished in 0.0001 seconds
+7 examples, 0 failures
+```
+
+三角測量として 30 のテストも追加しておきます。
+
+```haskell
+    it "30 を渡すと 'FizzBuzz' を返す" $
+      generate 30 `shouldBe` "FizzBuzz"
+```
+
+```bash
+$ stack test
+8 examples, 0 failures
+```
+
+**TODO リスト**:
+
+- [x] 数を文字列にして返す
+- [x] 3 の倍数のときは数の代わりに「Fizz」と返す
+- [x] 5 の倍数のときは「Buzz」と返す
+- [x] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
+- [ ] 1 から 100 までの数
+- [ ] プリントする
+
+ここまでの作業をコミットしておきましょう。
+
+```bash
+$ git add .
+$ git commit -m 'feat: FizzBuzz のコアロジックを実装'
+```
+
+## 2.6 まとめ
+
+この章では以下のことを学びました。
+
+- **三角測量** で 2 つ以上の例を使ってプログラムを一般化する手法
+- Haskell の `show` 関数による整数から文字列への変換
+- Haskell の `mod` 関数と中置記法（`` n `mod` 3 ``）による剰余判定
+- **ガード式** による条件分岐の記述（`|` と `otherwise`）
+- ガード式の **評価順序** の重要性（限定的な条件を先に配置）
+- Red-Green-Refactor サイクルを繰り返してコアロジックを段階的に構築する方法
+
+次章では、残りの TODO（リスト生成）を実装し、リファクタリングで「動作するきれいなコード」を目指します。