@k2works/claude-code-booster 4.4.1 → 4.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/claude-code-booster +2 -2
- package/lib/assets/.claude/agents/xp-architect.md +250 -250
- package/lib/assets/.claude/agents/xp-executive.md +207 -207
- package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -239
- package/lib/assets/.claude/agents/xp-product-manager.md +245 -245
- package/lib/assets/.claude/agents/xp-programmer.md +268 -268
- package/lib/assets/.claude/agents/xp-project-manager.md +229 -229
- package/lib/assets/.claude/agents/xp-technical-writer.md +224 -224
- package/lib/assets/.claude/agents/xp-tester.md +265 -265
- package/lib/assets/.claude/agents/xp-user-representative.md +204 -204
- package/lib/assets/.claude/skills/analyzing-business-case/SKILL.md +148 -148
- package/lib/assets/.claude/skills/analyzing-business-strategy/SKILL.md +277 -277
- package/lib/assets/.claude/skills/analyzing-review/SKILL.md +174 -174
- package/lib/assets/.claude/skills/creating-iteration-report/SKILL.md +210 -210
- package/lib/assets/.claude/skills/creating-release-report/SKILL.md +161 -161
- package/lib/assets/.claude/skills/developing-review/SKILL.md +175 -175
- package/lib/assets/.claude/skills/developing-uiux-review/SKILL.md +207 -207
- package/lib/assets/.claude/skills/generating-bmc/SKILL.md +123 -123
- package/lib/assets/.claude/skills/operating-qt/SKILL.md +147 -147
- package/lib/assets/.claude/skills/operating-review/SKILL.md +171 -171
- package/lib/assets/.claude/skills/operating-script/SKILL.md +145 -145
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +168 -168
- package/lib/assets/.claude/skills/practicing-getting-start-tdd/SKILL.md +266 -266
- package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +54 -54
- package/lib/assets/.devcontainer/devcontainer.json +1 -1
- package/lib/assets/.gitattributes +0 -2
- package/lib/assets/CLAUDE.md +193 -193
- package/lib/assets/Dockerfile +1 -6
- package/lib/assets/README.md +0 -16
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/01-immutability-and-data-transformation.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/15-gossiping-bus-drivers.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/20-pattern-interactions.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/21-best-practices.md +6 -6
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/22-oo-to-fp-migration.md +3 -3
- package/lib/assets/docs/article/functional-desgin-ppp/clojure/index.md +22 -22
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/01-immutability-and-data-transformation.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/elixir/index.md +22 -22
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/01-immutability-and-data-transformation.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/15-gossiping-bus-drivers.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/17-video-rental-system.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/19-wator-simulation.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/21-best-practices.md +2 -2
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/22-oo-to-fp-migration.md +5 -5
- package/lib/assets/docs/article/functional-desgin-ppp/fsharp/index.md +22 -22
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/15-gossiping-bus-drivers.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/haskell/20-pattern-interactions.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/rust/01-immutability-and-data-transformation.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/rust/index.md +22 -22
- package/lib/assets/docs/article/functional-desgin-ppp/scala/01-immutability-and-data-transformation.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/scala/15-gossiping-bus-drivers.md +1 -1
- package/lib/assets/docs/article/functional-desgin-ppp/scala/21-best-practices.md +3 -3
- package/lib/assets/docs/article/functional-desgin-ppp/scala/22-oo-to-fp-migration.md +3 -3
- package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md +22 -22
- package/lib/assets/docs/article/getting-start-tdd/integration/04-type-system-comparison.md +2 -2
- package/lib/assets/docs/article/getting-start-tdd/integration/06-learning-roadmap.md +8 -8
- package/lib/assets/docs/article/getting-start-tdd/ruby/11-immutable-data-and-pipeline.md +2 -2
- package/lib/assets/docs/article/grokkingfp/all/part-2-ch03-immutable-data.md +3 -3
- package/lib/assets/docs/article/grokkingfp/all/part-3-ch06-option.md +4 -4
- package/lib/assets/docs/article/grokkingfp/all/writing-plan.md +8 -8
- package/lib/assets/docs/article/grokkingfp/elixir/part-1.md +1 -1
- package/lib/assets/docs/article/grokkingfp/elixir/part-5.md +1 -1
- package/lib/assets/docs/article/grokkingfp/elixir/part-6.md +1 -1
- package/lib/assets/docs/article/grokkingfp/fsharp/part-6.md +1 -1
- package/lib/assets/docs/article/grokkingfp/haskell/part-4.md +1 -1
- package/lib/assets/docs/article/grokkingfp/haskell/part-6.md +1 -1
- package/lib/assets/docs/article/grokkingfp/java/part-1.md +1 -1
- package/lib/assets/docs/article/grokkingfp/java/part-2.md +4 -4
- package/lib/assets/docs/article/grokkingfp/java/part-6.md +2 -2
- package/lib/assets/docs/article/grokkingfp/python/part-1.md +3 -3
- package/lib/assets/docs/article/grokkingfp/ruby/part-1.md +1 -1
- package/lib/assets/docs/article/grokkingfp/ruby/part-6.md +1 -1
- package/lib/assets/docs/article/grokkingfp/rust/part-4.md +1 -1
- package/lib/assets/docs/article/grokkingfp/scala/part-1.md +1 -1
- package/lib/assets/docs/article/grokkingfp/scala/part-3.md +1 -1
- package/lib/assets/docs/article/grokkingfp/scala/part-6.md +1 -1
- package/lib/assets/docs/article/grokkingfp/typescript/part-1.md +1 -1
- package/lib/assets/docs/article/grokkingfp/typescript/part-4.md +1 -1
- package/lib/assets/docs/article/grokkingfp/typescript/part-6.md +1 -1
- package/lib/assets/docs/article/index.md +39 -39
- package/lib/assets/docs/design/index.md +44 -44
- package/lib/assets/docs/index.md +33 -33
- package/lib/assets/docs/operation/index.md +16 -16
- package/lib/assets/docs/reference/CodexCLIMCP/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/343/203/225/343/203/255/343/203/274.md +546 -546
- package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1 -1
- package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1 -1
- package/lib/assets/docs/reference/Vim/346/223/215/344/275/234/343/203/236/343/203/213/343/203/245/343/202/242/343/203/253.md +13 -0
- package/lib/assets/docs/reference/images/BMC.drawio.svg +3 -3
- package/lib/assets/docs/reference//347/265/214/345/226/266/346/210/246/347/225/245/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +566 -566
- package/lib/assets/docs/requirements/index.md +17 -17
- package/lib/assets/docs/strategy/index.md +17 -17
- package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273.md +327 -327
- package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +275 -275
- package/lib/assets/docs/template//344/272/213/344/276/213/345/210/206/346/236/220.md +513 -513
- package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -57
- package/lib/assets/ops/nix/shells/.tmux.conf +2 -2
- package/lib/assets/ops/nix/shells/.vimrc +15 -2
- package/lib/assets/ops/nix/shells/shell.nix +1 -0
- package/package.json +1 -1
- package/lib/assets/.envrc +0 -1
|
@@ -1,266 +1,266 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: practicing-getting-start-tdd
|
|
3
|
-
description: "テスト駆動開発から始めるプログラミング入門」の対話式チュートリアル。FizzBuzz を題材に TDD の Red-Green-Refactor サイクルを 14 言語で体験する。「TDD を練習したい」「FizzBuzz で TDD を学びたい」「テスト駆動開発の入門をしたい」「Java で TDD を体験したい」「Python で TDD を始めたい」「プログラミング入門チュートリアルをやりたい」「getting-start-tdd をやりたい」「TDD のハンズオンがしたい」「Red-Green-Refactor を体験したい」といった場面で発動する。TDD チュートリアルやプログラミング入門の要望があれば積極的に使用すること。"
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# TDD プログラミング入門 - 対話式チュートリアル
|
|
7
|
-
|
|
8
|
-
FizzBuzz 問題を題材に、TDD(テスト駆動開発)の手法を実践的に学ぶ対話式チュートリアル。ユーザーが自分の手でコードを書き、テストを通す体験を通じて TDD のサイクルと各言語の特徴を身につける。
|
|
9
|
-
|
|
10
|
-
## 教材
|
|
11
|
-
|
|
12
|
-
`docs/article/getting-start-tdd/` に 14 言語 x 12 章の完全な教材がある。チュートリアル進行時は該当する言語・章の教材を参照し、内容に沿って進行する。
|
|
13
|
-
|
|
14
|
-
## チュートリアルの進め方
|
|
15
|
-
|
|
16
|
-
### Step 0: 開発環境の準備
|
|
17
|
-
|
|
18
|
-
チュートリアルを始める前に、開発環境を準備する。環境構築は**ユーザーにインストラクションを提示し、合意を得てから**進める。勝手にコマンドを実行しない。
|
|
19
|
-
|
|
20
|
-
#### コード配置ルール
|
|
21
|
-
|
|
22
|
-
チュートリアルで作成するコードは `apps/` 配下に**言語ごとのディレクトリ**を切って配置する。言語環境・プロジェクト初期化・ソース・テストはすべてそのディレクトリ内で完結させ、他言語と干渉しないようにする。
|
|
23
|
-
|
|
24
|
-
```text
|
|
25
|
-
apps/
|
|
26
|
-
├── java/ # Java プロジェクト(build.gradle, src/ など)
|
|
27
|
-
├── python/ # Python プロジェクト(pyproject.toml, tests/ など)
|
|
28
|
-
├── typescript/ # TypeScript プロジェクト(package.json, src/ など)
|
|
29
|
-
├── go/ # Go プロジェクト(go.mod, *_test.go など)
|
|
30
|
-
├── rust/ # Rust プロジェクト(Cargo.toml, src/ など)
|
|
31
|
-
└── ... # その他の言語も同様に `apps/{lang}/` を作成
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
**進め方**:
|
|
35
|
-
|
|
36
|
-
1. 選択言語のディレクトリ `apps/{lang}/` が存在するか確認する
|
|
37
|
-
2. なければ作成し、各言語標準のプロジェクト初期化コマンド(`cargo init`、`npm init`、`go mod init` 等)をユーザーの合意を得てから実行する
|
|
38
|
-
3. 以降のテスト・実装コードはすべてこのディレクトリ配下に記述する
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
#### 推奨環境: GitHub Codespaces
|
|
42
|
-
|
|
43
|
-
最もスムーズに始められる環境。devcontainer に Nix が設定済みで、言語ごとの開発環境が即座に利用可能。
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
# Codespace 起動後、選択した言語の開発環境に入る
|
|
47
|
-
nix develop .#java # Java の場合
|
|
48
|
-
nix develop .#python # Python の場合
|
|
49
|
-
nix develop .#node # JavaScript/TypeScript の場合
|
|
50
|
-
# ... 各言語に対応した flake が用意されている
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
#### ローカル環境
|
|
54
|
-
|
|
55
|
-
ローカルで進める場合は、OS に応じたパッケージマネージャで各言語の開発環境を構築する。
|
|
56
|
-
|
|
57
|
-
| OS | パッケージマネージャ | 環境構築方法 |
|
|
58
|
-
|----|--------------------|-------------|
|
|
59
|
-
| Windows(**WSL 推奨**) | [WSL](https://learn.microsoft.com/windows/wsl/) + [Nix](https://nixos.org/download) | WSL2(Ubuntu 等)に Nix をインストールし `nix develop .#{lang}` で開発環境に入る |
|
|
60
|
-
| Windows(ネイティブ) | [Scoop](https://scoop.sh/) | Scoop で各言語のランタイム・ビルドツールを直接インストール(Nix は非対応) |
|
|
61
|
-
| macOS | [Homebrew](https://brew.sh/) + [Nix](https://nixos.org/download) | Nix で `nix develop .#{lang}` または Homebrew で個別インストール |
|
|
62
|
-
| Linux | [Nix](https://nixos.org/download) | `nix develop .#{lang}` で開発環境に入る |
|
|
63
|
-
|
|
64
|
-
Windows ユーザーにはまず **WSL(Windows Subsystem for Linux)** を推奨する。WSL 上では Linux と同じく Nix / devcontainer がそのまま使え、教材の動作例ともっとも齟齬が少ない。WSL を利用できない事情がある場合に限り、ネイティブ Windows + Scoop の構成を提案する。
|
|
65
|
-
|
|
66
|
-
##### Windows(WSL)での環境構築例
|
|
67
|
-
|
|
68
|
-
```powershell
|
|
69
|
-
# PowerShell(管理者)で WSL2 と Ubuntu をインストール
|
|
70
|
-
wsl --install -d Ubuntu
|
|
71
|
-
# 再起動後、Ubuntu を起動し初期ユーザーを作成
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
```bash
|
|
75
|
-
# WSL(Ubuntu)内で Nix をインストール
|
|
76
|
-
sh <(curl -L https://nixos.org/nix/install) --daemon
|
|
77
|
-
|
|
78
|
-
# 以降は Linux と同じ手順
|
|
79
|
-
nix develop .#java # 例: Java の場合
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
Windows 側のファイルシステム(`/mnt/c/...`)ではなく、WSL の Linux ファイルシステム(`~` 配下)にリポジトリを clone すると I/O 性能が大幅に向上する。
|
|
83
|
-
|
|
84
|
-
##### Windows(Scoop)での環境構築例
|
|
85
|
-
|
|
86
|
-
Windows では Nix が使えないため、Scoop で各言語のツールを個別にインストールする。
|
|
87
|
-
|
|
88
|
-
```powershell
|
|
89
|
-
# Scoop のインストール(未導入の場合)
|
|
90
|
-
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
|
91
|
-
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
|
|
92
|
-
|
|
93
|
-
# Java の場合
|
|
94
|
-
scoop bucket add java
|
|
95
|
-
scoop install openjdk gradle
|
|
96
|
-
|
|
97
|
-
# Python の場合
|
|
98
|
-
scoop install python
|
|
99
|
-
pip install pytest
|
|
100
|
-
|
|
101
|
-
# Node.js(JavaScript/TypeScript)の場合
|
|
102
|
-
scoop install nodejs
|
|
103
|
-
npm install
|
|
104
|
-
|
|
105
|
-
# Go の場合
|
|
106
|
-
scoop install go
|
|
107
|
-
|
|
108
|
-
# Rust の場合
|
|
109
|
-
scoop install rustup
|
|
110
|
-
rustup default stable
|
|
111
|
-
|
|
112
|
-
# Ruby の場合
|
|
113
|
-
scoop install ruby
|
|
114
|
-
|
|
115
|
-
# PHP の場合
|
|
116
|
-
scoop install php composer
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
各言語の詳細なセットアップ手順は、教材の各章(特に第 1 章・第 5 章)に記載されている。
|
|
120
|
-
|
|
121
|
-
#### 環境構築の進め方
|
|
122
|
-
|
|
123
|
-
1. ユーザーの現在の環境(OS、既存ツール)を確認する
|
|
124
|
-
2. 推奨環境(GitHub Codespaces)を提案する
|
|
125
|
-
3. ローカル環境を希望する場合は、OS に応じたインストール手順を**提示して確認を求める**
|
|
126
|
-
4. ユーザーの合意を得てから、ステップごとにコマンドを実行する
|
|
127
|
-
5. 環境が正しく構築できたことを確認してからチュートリアルに進む
|
|
128
|
-
|
|
129
|
-
### Step 1: 言語選択
|
|
130
|
-
|
|
131
|
-
ユーザーに学びたい言語を尋ねる。対応言語と特徴を簡潔に提示する。
|
|
132
|
-
|
|
133
|
-
| 言語 | 特徴 |
|
|
134
|
-
|------|------|
|
|
135
|
-
| Java | 静的型付け、OOP、JUnit 5 |
|
|
136
|
-
| JavaScript/TypeScript | 動的/静的型付け、Vitest |
|
|
137
|
-
| Python | 動的型付け、pytest |
|
|
138
|
-
| Ruby | 動的型付け、Minitest |
|
|
139
|
-
| PHP | 動的型付け、PHPUnit |
|
|
140
|
-
| Go | 静的型付け、標準 testing |
|
|
141
|
-
| Rust | 所有権、標準テスト |
|
|
142
|
-
| C# | 静的型付け、xUnit |
|
|
143
|
-
| F# | 関数型、Expecto |
|
|
144
|
-
| Clojure | LISP、clojure.test |
|
|
145
|
-
| Scala | OOP+FP、ScalaTest |
|
|
146
|
-
| Elixir | 関数型、ExUnit |
|
|
147
|
-
| Haskell | 純粋関数型、Hspec |
|
|
148
|
-
|
|
149
|
-
### Step 2: 章の選択
|
|
150
|
-
|
|
151
|
-
全 12 章 4 部構成。ユーザーの経験レベルに応じて開始章を提案する。
|
|
152
|
-
|
|
153
|
-
**第 1 部: TDD の基本サイクル**(初心者はここから)
|
|
154
|
-
1. TODO リストと最初のテスト
|
|
155
|
-
2. 仮実装と三角測量
|
|
156
|
-
3. 明白な実装とリファクタリング
|
|
157
|
-
|
|
158
|
-
**第 2 部: 開発環境と自動化**
|
|
159
|
-
4. バージョン管理と Conventional Commits
|
|
160
|
-
5. パッケージ管理と静的解析
|
|
161
|
-
6. タスクランナーと CI/CD
|
|
162
|
-
|
|
163
|
-
**第 3 部: オブジェクト指向設計**
|
|
164
|
-
7. カプセル化とポリモーフィズム
|
|
165
|
-
8. デザインパターンの適用
|
|
166
|
-
9. SOLID 原則とモジュール設計
|
|
167
|
-
|
|
168
|
-
**第 4 部: 関数型プログラミングへの展開**
|
|
169
|
-
10. 高階関数と関数合成
|
|
170
|
-
11. 不変データとパイプライン処理
|
|
171
|
-
12. エラーハンドリングと型安全性
|
|
172
|
-
|
|
173
|
-
### Step 3: 対話式チュートリアルの実施
|
|
174
|
-
|
|
175
|
-
教材ファイルを読み込み、以下のルールで対話的に進行する。
|
|
176
|
-
|
|
177
|
-
#### 教材ファイルの特定
|
|
178
|
-
|
|
179
|
-
言語ごとにファイル名パターンが異なる。
|
|
180
|
-
|
|
181
|
-
- 多くの言語: `docs/article/getting-start-tdd/{lang}/01-todo-list-and-first-test.md` 等
|
|
182
|
-
- C#: `docs/article/getting-start-tdd/csharp/chapter01.md` 等
|
|
183
|
-
- F#: `docs/article/getting-start-tdd/fsharp/chapter01.md` 等
|
|
184
|
-
|
|
185
|
-
#### 進行ルール
|
|
186
|
-
|
|
187
|
-
1. **章の導入**: その章で学ぶ概念と目標を簡潔に説明する
|
|
188
|
-
2. **TODO リスト提示**: 章の TODO リストを提示し、全体像を共有する
|
|
189
|
-
3. **段階的な課題提示**: 一度にすべてを見せず、1 ステップずつ課題を出す
|
|
190
|
-
4. **実装コードの提示**: 各ステップで教材に記載された **テストコード・実装コードを必ず提示** する。コードブロックと併せて「どのファイルのどの位置に書くか」も明示する
|
|
191
|
-
5. **記述方法の選択**: コード提示後、ユーザーに以下のどちらで進めるかを尋ねる
|
|
192
|
-
- **手動記述**: ユーザーが自分の手でエディタに書き写す(学習効果が高い。推奨)
|
|
193
|
-
- **自動記述**: AI が Write/Edit ツールで該当ファイルに自動で記述する(テンポ重視・確認用)
|
|
194
|
-
6. **Red フェーズ**: 提示したテストコードを記述し、失敗することを一緒に確認する
|
|
195
|
-
7. **Green フェーズ**: 提示した最小限の実装コードを記述し、テストが通ることを確認する
|
|
196
|
-
8. **Refactor フェーズ**: 提示したリファクタ後のコードを記述し、テストが通り続けることを確認する。併せて改善ポイントの意図を解説する
|
|
197
|
-
9. **ステップ振り返り**: ステップ完了後に学んだ概念を簡潔にまとめる
|
|
198
|
-
|
|
199
|
-
#### 対話のトーン
|
|
200
|
-
|
|
201
|
-
- 励ましと好奇心を持って接する
|
|
202
|
-
- 間違いを責めず、なぜそうなるかを一緒に考える
|
|
203
|
-
- TDD の書籍からの引用を適宜挟み、理論的背景を伝える
|
|
204
|
-
- ユーザーのペースに合わせる(速い人にはテンポよく、慎重な人にはじっくり)
|
|
205
|
-
|
|
206
|
-
#### ヒントの段階
|
|
207
|
-
|
|
208
|
-
ユーザーが詰まった場合、段階的にヒントを出す。
|
|
209
|
-
|
|
210
|
-
1. **方向性のヒント**: 「3 の倍数を判定するには、どの演算子が使えそうですか?」
|
|
211
|
-
2. **構造のヒント**: 「if 文と剰余演算子(%)を組み合わせてみましょう」
|
|
212
|
-
3. **コード例の一部**: 「`number % 3 == 0` という条件式を使えます」
|
|
213
|
-
4. **完全な解答**: 教材のコードを提示し、なぜそうなるかを解説する
|
|
214
|
-
|
|
215
|
-
#### セッション管理
|
|
216
|
-
|
|
217
|
-
- 各ステップ完了時に TODO リストを更新して進捗を可視化する
|
|
218
|
-
- 長いセッションでは適度な区切り(章の終わり)で休憩を提案する
|
|
219
|
-
- 次回再開時のために、現在の進捗状況を報告する
|
|
220
|
-
|
|
221
|
-
### Step 4: 章のまとめと KPT 振り返り
|
|
222
|
-
|
|
223
|
-
章の終わりに以下を実施する。
|
|
224
|
-
|
|
225
|
-
1. 学んだ概念の要約
|
|
226
|
-
2. TODO リストの最終状態確認
|
|
227
|
-
3. **KPT 振り返りの実施**(必須)
|
|
228
|
-
4. 次章の予告と接続
|
|
229
|
-
5. (希望があれば)追加の練習問題を提案
|
|
230
|
-
|
|
231
|
-
#### KPT 振り返りの進め方
|
|
232
|
-
|
|
233
|
-
各章の最後に、KPT フレームワークで振り返りを行う。ユーザーに以下の 3 観点を順に問いかけ、回答を整理してまとめる。
|
|
234
|
-
|
|
235
|
-
- **Keep(続けたいこと)**: この章でうまくいったこと、今後も続けたい学び方や習慣
|
|
236
|
-
- **Problem(問題点)**: 詰まった箇所、理解が曖昧なまま進んだ点、学習上の課題
|
|
237
|
-
- **Try(次に試すこと)**: 次章または次回の学習で試したい改善アクション
|
|
238
|
-
|
|
239
|
-
KPT は以下のフォーマットでまとめ、セッションログとしてユーザーに提示する。
|
|
240
|
-
|
|
241
|
-
```markdown
|
|
242
|
-
## 第 N 章 KPT 振り返り
|
|
243
|
-
|
|
244
|
-
### Keep
|
|
245
|
-
- (続けたいこと)
|
|
246
|
-
|
|
247
|
-
### Problem
|
|
248
|
-
- (問題点)
|
|
249
|
-
|
|
250
|
-
### Try
|
|
251
|
-
- (次に試すこと)
|
|
252
|
-
```
|
|
253
|
-
|
|
254
|
-
Problem で挙がった項目は、Try で具体的なアクションに変換するよう促す。Try は次章の進め方に反映させる。
|
|
255
|
-
|
|
256
|
-
## 応用: 複数言語での比較
|
|
257
|
-
|
|
258
|
-
ユーザーが複数言語に興味がある場合、`docs/article/getting-start-tdd/integration/` の多言語統合解説を参照し、言語間の比較視点を提供する。
|
|
259
|
-
|
|
260
|
-
## 注意事項
|
|
261
|
-
|
|
262
|
-
- このスキルはユーザーに「教える」のではなく「一緒に学ぶ」姿勢で進行する
|
|
263
|
-
- コードを書くのはユーザー自身。AI はガイド役に徹する
|
|
264
|
-
- ユーザーが「答えを教えて」と言った場合は教材のコードを提示するが、なぜそうなるかの理解を促す
|
|
265
|
-
- 環境構築は必ずユーザーの合意を得てから進める。コマンドの実行前にインストラクションを提示し、確認を取る
|
|
266
|
-
- GitHub Codespaces + Nix devcontainer が推奨環境。ローカルの場合は OS に応じたパッケージマネージャを使う(Windows: **WSL + Nix を第一推奨**、困難なら Scoop で各言語を直接インストール、macOS: Homebrew + Nix、Linux: Nix)
|
|
1
|
+
---
|
|
2
|
+
name: practicing-getting-start-tdd
|
|
3
|
+
description: "テスト駆動開発から始めるプログラミング入門」の対話式チュートリアル。FizzBuzz を題材に TDD の Red-Green-Refactor サイクルを 14 言語で体験する。「TDD を練習したい」「FizzBuzz で TDD を学びたい」「テスト駆動開発の入門をしたい」「Java で TDD を体験したい」「Python で TDD を始めたい」「プログラミング入門チュートリアルをやりたい」「getting-start-tdd をやりたい」「TDD のハンズオンがしたい」「Red-Green-Refactor を体験したい」といった場面で発動する。TDD チュートリアルやプログラミング入門の要望があれば積極的に使用すること。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# TDD プログラミング入門 - 対話式チュートリアル
|
|
7
|
+
|
|
8
|
+
FizzBuzz 問題を題材に、TDD(テスト駆動開発)の手法を実践的に学ぶ対話式チュートリアル。ユーザーが自分の手でコードを書き、テストを通す体験を通じて TDD のサイクルと各言語の特徴を身につける。
|
|
9
|
+
|
|
10
|
+
## 教材
|
|
11
|
+
|
|
12
|
+
`docs/article/getting-start-tdd/` に 14 言語 x 12 章の完全な教材がある。チュートリアル進行時は該当する言語・章の教材を参照し、内容に沿って進行する。
|
|
13
|
+
|
|
14
|
+
## チュートリアルの進め方
|
|
15
|
+
|
|
16
|
+
### Step 0: 開発環境の準備
|
|
17
|
+
|
|
18
|
+
チュートリアルを始める前に、開発環境を準備する。環境構築は**ユーザーにインストラクションを提示し、合意を得てから**進める。勝手にコマンドを実行しない。
|
|
19
|
+
|
|
20
|
+
#### コード配置ルール
|
|
21
|
+
|
|
22
|
+
チュートリアルで作成するコードは `apps/` 配下に**言語ごとのディレクトリ**を切って配置する。言語環境・プロジェクト初期化・ソース・テストはすべてそのディレクトリ内で完結させ、他言語と干渉しないようにする。
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
apps/
|
|
26
|
+
├── java/ # Java プロジェクト(build.gradle, src/ など)
|
|
27
|
+
├── python/ # Python プロジェクト(pyproject.toml, tests/ など)
|
|
28
|
+
├── typescript/ # TypeScript プロジェクト(package.json, src/ など)
|
|
29
|
+
├── go/ # Go プロジェクト(go.mod, *_test.go など)
|
|
30
|
+
├── rust/ # Rust プロジェクト(Cargo.toml, src/ など)
|
|
31
|
+
└── ... # その他の言語も同様に `apps/{lang}/` を作成
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**進め方**:
|
|
35
|
+
|
|
36
|
+
1. 選択言語のディレクトリ `apps/{lang}/` が存在するか確認する
|
|
37
|
+
2. なければ作成し、各言語標準のプロジェクト初期化コマンド(`cargo init`、`npm init`、`go mod init` 等)をユーザーの合意を得てから実行する
|
|
38
|
+
3. 以降のテスト・実装コードはすべてこのディレクトリ配下に記述する
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
#### 推奨環境: GitHub Codespaces
|
|
42
|
+
|
|
43
|
+
最もスムーズに始められる環境。devcontainer に Nix が設定済みで、言語ごとの開発環境が即座に利用可能。
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
# Codespace 起動後、選択した言語の開発環境に入る
|
|
47
|
+
nix develop .#java # Java の場合
|
|
48
|
+
nix develop .#python # Python の場合
|
|
49
|
+
nix develop .#node # JavaScript/TypeScript の場合
|
|
50
|
+
# ... 各言語に対応した flake が用意されている
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
#### ローカル環境
|
|
54
|
+
|
|
55
|
+
ローカルで進める場合は、OS に応じたパッケージマネージャで各言語の開発環境を構築する。
|
|
56
|
+
|
|
57
|
+
| OS | パッケージマネージャ | 環境構築方法 |
|
|
58
|
+
|----|--------------------|-------------|
|
|
59
|
+
| Windows(**WSL 推奨**) | [WSL](https://learn.microsoft.com/windows/wsl/) + [Nix](https://nixos.org/download) | WSL2(Ubuntu 等)に Nix をインストールし `nix develop .#{lang}` で開発環境に入る |
|
|
60
|
+
| Windows(ネイティブ) | [Scoop](https://scoop.sh/) | Scoop で各言語のランタイム・ビルドツールを直接インストール(Nix は非対応) |
|
|
61
|
+
| macOS | [Homebrew](https://brew.sh/) + [Nix](https://nixos.org/download) | Nix で `nix develop .#{lang}` または Homebrew で個別インストール |
|
|
62
|
+
| Linux | [Nix](https://nixos.org/download) | `nix develop .#{lang}` で開発環境に入る |
|
|
63
|
+
|
|
64
|
+
Windows ユーザーにはまず **WSL(Windows Subsystem for Linux)** を推奨する。WSL 上では Linux と同じく Nix / devcontainer がそのまま使え、教材の動作例ともっとも齟齬が少ない。WSL を利用できない事情がある場合に限り、ネイティブ Windows + Scoop の構成を提案する。
|
|
65
|
+
|
|
66
|
+
##### Windows(WSL)での環境構築例
|
|
67
|
+
|
|
68
|
+
```powershell
|
|
69
|
+
# PowerShell(管理者)で WSL2 と Ubuntu をインストール
|
|
70
|
+
wsl --install -d Ubuntu
|
|
71
|
+
# 再起動後、Ubuntu を起動し初期ユーザーを作成
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# WSL(Ubuntu)内で Nix をインストール
|
|
76
|
+
sh <(curl -L https://nixos.org/nix/install) --daemon
|
|
77
|
+
|
|
78
|
+
# 以降は Linux と同じ手順
|
|
79
|
+
nix develop .#java # 例: Java の場合
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Windows 側のファイルシステム(`/mnt/c/...`)ではなく、WSL の Linux ファイルシステム(`~` 配下)にリポジトリを clone すると I/O 性能が大幅に向上する。
|
|
83
|
+
|
|
84
|
+
##### Windows(Scoop)での環境構築例
|
|
85
|
+
|
|
86
|
+
Windows では Nix が使えないため、Scoop で各言語のツールを個別にインストールする。
|
|
87
|
+
|
|
88
|
+
```powershell
|
|
89
|
+
# Scoop のインストール(未導入の場合)
|
|
90
|
+
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
|
91
|
+
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
|
|
92
|
+
|
|
93
|
+
# Java の場合
|
|
94
|
+
scoop bucket add java
|
|
95
|
+
scoop install openjdk gradle
|
|
96
|
+
|
|
97
|
+
# Python の場合
|
|
98
|
+
scoop install python
|
|
99
|
+
pip install pytest
|
|
100
|
+
|
|
101
|
+
# Node.js(JavaScript/TypeScript)の場合
|
|
102
|
+
scoop install nodejs
|
|
103
|
+
npm install
|
|
104
|
+
|
|
105
|
+
# Go の場合
|
|
106
|
+
scoop install go
|
|
107
|
+
|
|
108
|
+
# Rust の場合
|
|
109
|
+
scoop install rustup
|
|
110
|
+
rustup default stable
|
|
111
|
+
|
|
112
|
+
# Ruby の場合
|
|
113
|
+
scoop install ruby
|
|
114
|
+
|
|
115
|
+
# PHP の場合
|
|
116
|
+
scoop install php composer
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
各言語の詳細なセットアップ手順は、教材の各章(特に第 1 章・第 5 章)に記載されている。
|
|
120
|
+
|
|
121
|
+
#### 環境構築の進め方
|
|
122
|
+
|
|
123
|
+
1. ユーザーの現在の環境(OS、既存ツール)を確認する
|
|
124
|
+
2. 推奨環境(GitHub Codespaces)を提案する
|
|
125
|
+
3. ローカル環境を希望する場合は、OS に応じたインストール手順を**提示して確認を求める**
|
|
126
|
+
4. ユーザーの合意を得てから、ステップごとにコマンドを実行する
|
|
127
|
+
5. 環境が正しく構築できたことを確認してからチュートリアルに進む
|
|
128
|
+
|
|
129
|
+
### Step 1: 言語選択
|
|
130
|
+
|
|
131
|
+
ユーザーに学びたい言語を尋ねる。対応言語と特徴を簡潔に提示する。
|
|
132
|
+
|
|
133
|
+
| 言語 | 特徴 |
|
|
134
|
+
|------|------|
|
|
135
|
+
| Java | 静的型付け、OOP、JUnit 5 |
|
|
136
|
+
| JavaScript/TypeScript | 動的/静的型付け、Vitest |
|
|
137
|
+
| Python | 動的型付け、pytest |
|
|
138
|
+
| Ruby | 動的型付け、Minitest |
|
|
139
|
+
| PHP | 動的型付け、PHPUnit |
|
|
140
|
+
| Go | 静的型付け、標準 testing |
|
|
141
|
+
| Rust | 所有権、標準テスト |
|
|
142
|
+
| C# | 静的型付け、xUnit |
|
|
143
|
+
| F# | 関数型、Expecto |
|
|
144
|
+
| Clojure | LISP、clojure.test |
|
|
145
|
+
| Scala | OOP+FP、ScalaTest |
|
|
146
|
+
| Elixir | 関数型、ExUnit |
|
|
147
|
+
| Haskell | 純粋関数型、Hspec |
|
|
148
|
+
|
|
149
|
+
### Step 2: 章の選択
|
|
150
|
+
|
|
151
|
+
全 12 章 4 部構成。ユーザーの経験レベルに応じて開始章を提案する。
|
|
152
|
+
|
|
153
|
+
**第 1 部: TDD の基本サイクル**(初心者はここから)
|
|
154
|
+
1. TODO リストと最初のテスト
|
|
155
|
+
2. 仮実装と三角測量
|
|
156
|
+
3. 明白な実装とリファクタリング
|
|
157
|
+
|
|
158
|
+
**第 2 部: 開発環境と自動化**
|
|
159
|
+
4. バージョン管理と Conventional Commits
|
|
160
|
+
5. パッケージ管理と静的解析
|
|
161
|
+
6. タスクランナーと CI/CD
|
|
162
|
+
|
|
163
|
+
**第 3 部: オブジェクト指向設計**
|
|
164
|
+
7. カプセル化とポリモーフィズム
|
|
165
|
+
8. デザインパターンの適用
|
|
166
|
+
9. SOLID 原則とモジュール設計
|
|
167
|
+
|
|
168
|
+
**第 4 部: 関数型プログラミングへの展開**
|
|
169
|
+
10. 高階関数と関数合成
|
|
170
|
+
11. 不変データとパイプライン処理
|
|
171
|
+
12. エラーハンドリングと型安全性
|
|
172
|
+
|
|
173
|
+
### Step 3: 対話式チュートリアルの実施
|
|
174
|
+
|
|
175
|
+
教材ファイルを読み込み、以下のルールで対話的に進行する。
|
|
176
|
+
|
|
177
|
+
#### 教材ファイルの特定
|
|
178
|
+
|
|
179
|
+
言語ごとにファイル名パターンが異なる。
|
|
180
|
+
|
|
181
|
+
- 多くの言語: `docs/article/getting-start-tdd/{lang}/01-todo-list-and-first-test.md` 等
|
|
182
|
+
- C#: `docs/article/getting-start-tdd/csharp/chapter01.md` 等
|
|
183
|
+
- F#: `docs/article/getting-start-tdd/fsharp/chapter01.md` 等
|
|
184
|
+
|
|
185
|
+
#### 進行ルール
|
|
186
|
+
|
|
187
|
+
1. **章の導入**: その章で学ぶ概念と目標を簡潔に説明する
|
|
188
|
+
2. **TODO リスト提示**: 章の TODO リストを提示し、全体像を共有する
|
|
189
|
+
3. **段階的な課題提示**: 一度にすべてを見せず、1 ステップずつ課題を出す
|
|
190
|
+
4. **実装コードの提示**: 各ステップで教材に記載された **テストコード・実装コードを必ず提示** する。コードブロックと併せて「どのファイルのどの位置に書くか」も明示する
|
|
191
|
+
5. **記述方法の選択**: コード提示後、ユーザーに以下のどちらで進めるかを尋ねる
|
|
192
|
+
- **手動記述**: ユーザーが自分の手でエディタに書き写す(学習効果が高い。推奨)
|
|
193
|
+
- **自動記述**: AI が Write/Edit ツールで該当ファイルに自動で記述する(テンポ重視・確認用)
|
|
194
|
+
6. **Red フェーズ**: 提示したテストコードを記述し、失敗することを一緒に確認する
|
|
195
|
+
7. **Green フェーズ**: 提示した最小限の実装コードを記述し、テストが通ることを確認する
|
|
196
|
+
8. **Refactor フェーズ**: 提示したリファクタ後のコードを記述し、テストが通り続けることを確認する。併せて改善ポイントの意図を解説する
|
|
197
|
+
9. **ステップ振り返り**: ステップ完了後に学んだ概念を簡潔にまとめる
|
|
198
|
+
|
|
199
|
+
#### 対話のトーン
|
|
200
|
+
|
|
201
|
+
- 励ましと好奇心を持って接する
|
|
202
|
+
- 間違いを責めず、なぜそうなるかを一緒に考える
|
|
203
|
+
- TDD の書籍からの引用を適宜挟み、理論的背景を伝える
|
|
204
|
+
- ユーザーのペースに合わせる(速い人にはテンポよく、慎重な人にはじっくり)
|
|
205
|
+
|
|
206
|
+
#### ヒントの段階
|
|
207
|
+
|
|
208
|
+
ユーザーが詰まった場合、段階的にヒントを出す。
|
|
209
|
+
|
|
210
|
+
1. **方向性のヒント**: 「3 の倍数を判定するには、どの演算子が使えそうですか?」
|
|
211
|
+
2. **構造のヒント**: 「if 文と剰余演算子(%)を組み合わせてみましょう」
|
|
212
|
+
3. **コード例の一部**: 「`number % 3 == 0` という条件式を使えます」
|
|
213
|
+
4. **完全な解答**: 教材のコードを提示し、なぜそうなるかを解説する
|
|
214
|
+
|
|
215
|
+
#### セッション管理
|
|
216
|
+
|
|
217
|
+
- 各ステップ完了時に TODO リストを更新して進捗を可視化する
|
|
218
|
+
- 長いセッションでは適度な区切り(章の終わり)で休憩を提案する
|
|
219
|
+
- 次回再開時のために、現在の進捗状況を報告する
|
|
220
|
+
|
|
221
|
+
### Step 4: 章のまとめと KPT 振り返り
|
|
222
|
+
|
|
223
|
+
章の終わりに以下を実施する。
|
|
224
|
+
|
|
225
|
+
1. 学んだ概念の要約
|
|
226
|
+
2. TODO リストの最終状態確認
|
|
227
|
+
3. **KPT 振り返りの実施**(必須)
|
|
228
|
+
4. 次章の予告と接続
|
|
229
|
+
5. (希望があれば)追加の練習問題を提案
|
|
230
|
+
|
|
231
|
+
#### KPT 振り返りの進め方
|
|
232
|
+
|
|
233
|
+
各章の最後に、KPT フレームワークで振り返りを行う。ユーザーに以下の 3 観点を順に問いかけ、回答を整理してまとめる。
|
|
234
|
+
|
|
235
|
+
- **Keep(続けたいこと)**: この章でうまくいったこと、今後も続けたい学び方や習慣
|
|
236
|
+
- **Problem(問題点)**: 詰まった箇所、理解が曖昧なまま進んだ点、学習上の課題
|
|
237
|
+
- **Try(次に試すこと)**: 次章または次回の学習で試したい改善アクション
|
|
238
|
+
|
|
239
|
+
KPT は以下のフォーマットでまとめ、セッションログとしてユーザーに提示する。
|
|
240
|
+
|
|
241
|
+
```markdown
|
|
242
|
+
## 第 N 章 KPT 振り返り
|
|
243
|
+
|
|
244
|
+
### Keep
|
|
245
|
+
- (続けたいこと)
|
|
246
|
+
|
|
247
|
+
### Problem
|
|
248
|
+
- (問題点)
|
|
249
|
+
|
|
250
|
+
### Try
|
|
251
|
+
- (次に試すこと)
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
Problem で挙がった項目は、Try で具体的なアクションに変換するよう促す。Try は次章の進め方に反映させる。
|
|
255
|
+
|
|
256
|
+
## 応用: 複数言語での比較
|
|
257
|
+
|
|
258
|
+
ユーザーが複数言語に興味がある場合、`docs/article/getting-start-tdd/integration/` の多言語統合解説を参照し、言語間の比較視点を提供する。
|
|
259
|
+
|
|
260
|
+
## 注意事項
|
|
261
|
+
|
|
262
|
+
- このスキルはユーザーに「教える」のではなく「一緒に学ぶ」姿勢で進行する
|
|
263
|
+
- コードを書くのはユーザー自身。AI はガイド役に徹する
|
|
264
|
+
- ユーザーが「答えを教えて」と言った場合は教材のコードを提示するが、なぜそうなるかの理解を促す
|
|
265
|
+
- 環境構築は必ずユーザーの合意を得てから進める。コマンドの実行前にインストラクションを提示し、確認を取る
|
|
266
|
+
- GitHub Codespaces + Nix devcontainer が推奨環境。ローカルの場合は OS に応じたパッケージマネージャを使う(Windows: **WSL + Nix を第一推奨**、困難なら Scoop で各言語を直接インストール、macOS: Homebrew + Nix、Linux: Nix)
|