Prompt file imported from snowman-se/meta-template-for-assignment2 (.github/prompts/implement-test.admin.prompt.md). Copyright stays with the author.

/implement-test.admin

Name: implement-test.admin
Author: snowman-se

目的

本リポジトリは、学生のプログラミング課題をCIで自動採点します。
/implement-test.admin では、release/README.md に記載された課題内容を基に、
学生が実装すべき機能に対応するテストコードを tests/stages/stage-XX 配下に実装し、
実際にテストを実行することで課題内容との整合性を検証します。

前提条件

/readme.admin が実行済みで release/README.md が作成されていること

手順

release/README.md の内容を確認し、課題内容を理解してください。
共通ワークフローに従い、ブランチ feature/implement-tests を作成してください。
tests/stages/stage-XX 配下に、課題内容に対応するテストコードを実装してください。
- 各テストは pytest フレームワークを使用して実装してください。
- 各ステージのテストコードは、課題の各機能に対応するように設計してください。
- 各ステージ用ディレクトリ tests/stages/stage-XX には、対応するステージ番号に基づいたテストファイルを1つのみ作成してください。
- 各テストファイル内では、以下のルールでテストを実装してください。
  - 全てのテスト関数には、@pytest.mark.stageXX デコレータを付与してください（XXはステージ番号）。
  - テスト対象のモジュールやクラスのインポートは、pytest.ini のルールに従って、必ずテスト関数内で行ってください。
  - 1つのテスト関数内には、基本的に1つのアサーションのみを含めてください。
  - 各アサーションの上の行には、何をテストしているのかが学生にとって明確になるよう、日本語のコメントを追加してください。
- 実装例:
```
# tests/stages/stage-01/test_bank_account.py
import pytest

@pytest.mark.stage01
def test_bank_account_exists():
    from kadai.bank_account import BankAccount

    # 銀行口座クラスが存在することを確認する
    assert BankAccount is not None

# <... 他の stage-01 テスト関数も同様に実装 ...> 
```
テストコードを実装したら、実際に生徒が課題を実施する手順を想定して、以下のフローでテストを検証してください。
検証中、テストコード側に問題が見つかった場合は、適宜修正を行ってください。

4.1 ステージ1の検証

4.1.1 テスト実行前の確認

まず、リポジトリのルートディレクトリにいることを確認します。
```
pwd
# 期待される出力: /path/to/Meta-Template-for-Assignment
```
4.1.2 テストの失敗を確認（RED）

実装前の状態で、ステージ1のテストを実行し、テストが失敗することを確認します。
```
pytest -m stage01 -v
```
期待される出力例（失敗時）:
```
================================ test session starts ================================
platform linux -- Python 3.x.x, pytest-7.x.x, pluggy-1.x.x
rootdir: /path/to/Meta-Template-for-Assignment
plugins: ...
collected X items

tests/stages/stage-01/test_XXX.py::test_function_exists FAILED         [XX%]
tests/stages/stage-01/test_XXX.py::test_basic_functionality FAILED     [XX%]

===================================== FAILURES ======================================
______________________________ test_function_exists ________________________________
...
ModuleNotFoundError: No module named 'kadai.XXX'
...
================================ X failed in X.XXs =================================
```
Note: この時点でテストが失敗するのは正常です。学生は空の実装ファイルから始めるため、必要なモジュールやクラスがまだ存在しません。

4.1.3 最低限の実装（GREEN）

src/kadai/ 配下に、ステージ1をクリアするために必要な最低限の実装を行います。例えば、src/kadai/bank_account.py を作成し、以下のような実装を行います：
```
class BankAccount:
    def __init__(self, initial_balance=0):
        self.balance = initial_balance
    
    def deposit(self, amount):
        self.balance += amount
    
    def get_balance(self):
        return self.balance
```
4.1.4 テストの成功を確認（GREEN）

再度ステージ1のテストを実行し、全てのテストが成功することを確認します。
```
pytest -m stage01 -v
```
期待される出力例（成功時）:
```
================================ test session starts ================================
platform linux -- Python 3.x.x, pytest-7.x.x, pluggy-1.x.x
rootdir: /path/to/Meta-Template-for-Assignment
plugins: ...
collected X items

tests/stages/stage-01/test_XXX.py::test_function_exists PASSED         [XX%]
tests/stages/stage-01/test_XXX.py::test_basic_functionality PASSED     [XX%]

================================ X passed in X.XXs =================================
```
4.1.5 詳細な出力の確認（オプション）

より詳細な情報が必要な場合は、以下のオプションを使用します：
```
# テストの実行状況を詳細に表示
pytest -m stage01 -vv

# テスト結果の要約を表示
pytest -m stage01 -v --tb=short

# 失敗したテストのみを再実行
pytest -m stage01 --lf
```
4.2 ステージ2以降の検証

ステージ2以降も同様の手順で検証を行います。各ステージについて以下を実施してください：

4.2.1 各ステージの検証手順
1. RED確認: 実装前にテストを実行し、失敗を確認
```
pytest -m stage02 -v  # ステージ2の場合
pytest -m stage03 -v  # ステージ3の場合
# 以降同様...
```
2. 実装: src/kadai/ 配下に該当ステージの機能を実装
3. GREEN確認: テストを実行し、成功を確認
```
pytest -m stage02 -v  # ステージ2の場合
pytest -m stage03 -v  # ステージ3の場合
# 以降同様...
```
4.2.2 累積的なテスト確認

各ステージ完了後、それまでの全てのステージのテストが通ることを確認します：
```
# ステージ1と2のテストを実行
pytest -m "stage01 or stage02" -v

# ステージ1から3までのテストを実行
pytest -m "stage01 or stage02 or stage03" -v

# 全てのステージのテストを実行
pytest -m "stage01 or stage02 or stage03 or stage04 or stage05" -v
# または
pytest tests/stages/ -v
```
4.3 テスト失敗時のデバッグガイド

テストが期待通りに動作しない場合、以下のデバッグ手順を実施してください。

4.3.1 エラーメッセージの確認
```
# より詳細なエラー情報を表示
pytest -m stage01 -vv --tb=long

# 標準出力も含めて表示
pytest -m stage01 -v -s
```
4.3.2 よくあるエラーと対処法

1. ModuleNotFoundError: No module named 'kadai.XXX'
- 原因: 必要なモジュールファイルが存在しない、またはファイル名が間違っている
- 対処法:
  - src/kadai/ 配下に正しいファイル名でモジュールを作成
  - pytest.ini の pythonpath 設定を確認
2. ImportError: cannot import name 'XXX' from 'kadai.YYY'
- 原因: クラスや関数が定義されていない、または名前が間違っている
- 対処法:
  - モジュール内に必要なクラス/関数が定義されているか確認
  - スペルミスがないか確認
3. AssertionError
- 原因: テストの期待値と実際の戻り値が一致していない
- 対処法:
  - テストコード内のコメントを読み、何をテストしているか確認
  - 実装が仕様通りか確認
  - 必要に応じてテストコードを修正
4. AttributeError: 'XXX' object has no attribute 'YYY'
- 原因: クラスに必要なメソッドや属性が定義されていない
- 対処法:
  - クラスに必要なメソッド/属性を追加
  - メソッド名のスペルミスを確認
4.3.3 個別のテスト関数を実行

特定のテスト関数のみを実行して問題を切り分けます：
```
# 特定のテストファイルのみ実行
pytest tests/stages/stage-01/test_bank_account.py -v

# 特定のテスト関数のみ実行
pytest tests/stages/stage-01/test_bank_account.py::test_function_exists -v

# テスト名の一部で絞り込み
pytest -k "bank_account" -v
```
4.3.4 テストコードの妥当性確認
- テストが課題仕様と一致しているか release/README.md と照らし合わせて確認
- テストの日本語コメントが学生にとって理解しやすいか確認
- エッジケースが適切にカバーされているか確認
4.4 検証完了の確認

全てのステージの検証が完了したら、最終確認を行います：
```
# 全てのステージテストを実行
pytest tests/stages/ -v

# テストカバレッジを確認（オプション）
pytest tests/stages/ --cov=src/kadai --cov-report=term-missing
```
期待される最終出力:
```
================================ test session starts ================================
collected XX items

tests/stages/stage-01/test_XXX.py::test_... PASSED                     [ X%]
tests/stages/stage-02/test_XXX.py::test_... PASSED                     [ X%]
tests/stages/stage-03/test_XXX.py::test_... PASSED                     [ X%]
tests/stages/stage-04/test_XXX.py::test_... PASSED                     [ X%]
tests/stages/stage-05/test_XXX.py::test_... PASSED                     [ X%]

================================ XX passed in X.XXs ================================
```
Success! 全てのテストがパスしたら、検証は完了です。次のステップに進みましょう。
すべてのステージのテストが成功したら、以下のファイルを更新してください。
- src/kadai/: 全ステージをクリアするために必要な実装を含むファイルを模範解答として agent-output/ 配下にコピーしてください。
  その後、元の src/kadai/ 配下の実装済みファイルは全て空ファイルの状態に戻してください。
- pytest.ini: ステージごとのマーカー定義 markers に、実装した全てのステージマーカーを記述してください。
- .github/workflows/classroom.yml: templates/template.classroom.yml をベースとして、実装した全てのステージに対応するジョブを追加し、README.md の課題内容に基づいた配点を設定してください。
  テンプレートファイルには5ステージ分のジョブ定義が含まれているため、必要に応じてステージ数を調整し、各ステージの配点（max-score）を課題内容に合わせて更新してください。
共通ワークフローに従い、変更をコミット（メッセージ: "feat: implement and verify tests for $課題名"）し、リモートリポジトリにプッシュしてください。

# /implement-test.admin ## 目的本リポジトリは、学生のプログラミング課題をCIで自動採点します。 `/implement-test.admin` では、`release/README.md` に記載された課題内容を基に、学生が実装すべき機能に対応するテストコードを `tests/stages/stage-XX` 配下に実装し、実際にテストを実行することで課題内容との整合性を検証します。 ## 前提条件 - `/readme.admin` が実行済みで `release/README.md` が作成されていること ## 手順 1. `release/README.md` の内容を確認し、課題内容を理解してください。 2. [共通ワークフロー](.github/prompts/WORKFLOW.md) に従い、ブランチ `feature/implement-tests` を作成してください。 3. `tests/stages/stage-XX` 配下に、課題内容に対応するテストコードを実装してください。 - 各テストは `pytest` フレームワークを使用して実装してください。 - 各ステージのテストコードは、課題の各機能に対応するように設計してください。 - 各ステージ用ディレクトリ `tests/stages/stage-XX` には、対応するステージ番号に基づいたテストファイルを1つのみ作成してください。 - 各テストファイル内では、以下のルールでテストを実装してください。 - 全てのテスト関数には、`@pytest.mark.stageXX` デコレータを付与してください（XXはステージ番号）。 - テスト対象のモジュールやクラスのインポートは、`pytest.ini` のルールに従って、 **必ず** テスト関数内で行ってください。 - 1つのテスト関数内には、基本的に1つのアサーションのみを含めてください。 - 各アサーションの上の行には、何をテストしているのかが学生にとって明確になるよう、日本語のコメントを追加してください。 - 実装例: ```python # tests/stages/stage-01/test_bank_account.py import pytest @pytest.mark.stage01 def test_bank_account_exists(): from kadai.bank_account import BankAccount # 銀行口座クラスが存在することを確認する assert BankAccount is not None # <... 他の stage-01 テスト関数も同様に実装 ...> ``` 4. テストコードを実装したら、実際に生徒が課題を実施する手順を想定して、以下のフローでテストを検証してください。検証中、テストコード側に問題が見つかった場合は、適宜修正を行ってください。 ### 4.1 ステージ1の検証 #### 4.1.1 テスト実行前の確認まず、リポジトリのルートディレクトリにいることを確認します。 ```bash pwd # 期待される出力: /path/to/Meta-Template-for-Assignment ``` #### 4.1.2 テストの失敗を確認（RED）実装前の状態で、ステージ1のテストを実行し、テストが失敗することを確認します。 ```bash pytest -m stage01 -v ``` **期待される出力例（失敗時）:** ``` ================================ test session starts ================================ platform linux -- Python 3.x.x, pytest-7.x.x, pluggy-1.x.x rootdir: /path/to/Meta-Template-for-Assignment plugins: ... collected X items tests/stages/stage-01/test_XXX.py::test_function_exists FAILED [XX%] tests/stages/stage-01/test_XXX.py::test_basic_functionality FAILED [XX%] ===================================== FAILURES ====================================== ______________________________ test_function_exists ________________________________ ... ModuleNotFoundError: No module named 'kadai.XXX' ... ================================ X failed in X.XXs ================================= ``` > **Note:** この時点でテストが失敗するのは正常です。学生は空の実装ファイルから始めるため、必要なモジュールやクラスがまだ存在しません。 #### 4.1.3 最低限の実装（GREEN） `src/kadai/` 配下に、ステージ1をクリアするために必要な最低限の実装を行います。例えば、`src/kadai/bank_account.py` を作成し、以下のような実装を行います： ```python class BankAccount: def __init__(self, initial_balance=0): self.balance = initial_balance def deposit(self, amount): self.balance += amount def get_balance(self): return self.balance ``` #### 4.1.4 テストの成功を確認（GREEN）再度ステージ1のテストを実行し、全てのテストが成功することを確認します。 ```bash pytest -m stage01 -v ``` **期待される出力例（成功時）:** ``` ================================ test session starts ================================ platform linux -- Python 3.x.x, pytest-7.x.x, pluggy-1.x.x rootdir: /path/to/Meta-Template-for-Assignment plugins: ... collected X items tests/stages/stage-01/test_XXX.py::test_function_exists PASSED [XX%] tests/stages/stage-01/test_XXX.py::test_basic_functionality PASSED [XX%] ================================ X passed in X.XXs ================================= ``` #### 4.1.5 詳細な出力の確認（オプション）より詳細な情報が必要な場合は、以下のオプションを使用します： ```bash # テストの実行状況を詳細に表示 pytest -m stage01 -vv # テスト結果の要約を表示 pytest -m stage01 -v --tb=short # 失敗したテストのみを再実行 pytest -m stage01 --lf ``` ### 4.2 ステージ2以降の検証ステージ2以降も同様の手順で検証を行います。各ステージについて以下を実施してください： #### 4.2.1 各ステージの検証手順 1. **RED確認**: 実装前にテストを実行し、失敗を確認 ```bash pytest -m stage02 -v # ステージ2の場合 pytest -m stage03 -v # ステージ3の場合 # 以降同様... ``` 2. **実装**: `src/kadai/` 配下に該当ステージの機能を実装 3. **GREEN確認**: テストを実行し、成功を確認 ```bash pytest -m stage02 -v # ステージ2の場合 pytest -m stage03 -v # ステージ3の場合 # 以降同様... ``` #### 4.2.2 累積的なテスト確認各ステージ完了後、それまでの全てのステージのテストが通ることを確認します： ```bash # ステージ1と2のテストを実行 pytest -m "stage01 or stage02" -v # ステージ1から3までのテストを実行 pytest -m "stage01 or stage02 or stage03" -v # 全てのステージのテストを実行 pytest -m "stage01 or stage02 or stage03 or stage04 or stage05" -v # または pytest tests/stages/ -v ``` ### 4.3 テスト失敗時のデバッグガイドテストが期待通りに動作しない場合、以下のデバッグ手順を実施してください。 #### 4.3.1 エラーメッセージの確認 ```bash # より詳細なエラー情報を表示 pytest -m stage01 -vv --tb=long # 標準出力も含めて表示 pytest -m stage01 -v -s ``` #### 4.3.2 よくあるエラーと対処法 **1. ModuleNotFoundError: No module named 'kadai.XXX'** - **原因**: 必要なモジュールファイルが存在しない、またはファイル名が間違っている - **対処法**: - `src/kadai/` 配下に正しいファイル名でモジュールを作成 - `pytest.ini` の `pythonpath` 設定を確認 **2. ImportError: cannot import name 'XXX' from 'kadai.YYY'** - **原因**: クラスや関数が定義されていない、または名前が間違っている - **対処法**: - モジュール内に必要なクラス/関数が定義されているか確認 - スペルミスがないか確認 **3. AssertionError** - **原因**: テストの期待値と実際の戻り値が一致していない - **対処法**: - テストコード内のコメントを読み、何をテストしているか確認 - 実装が仕様通りか確認 - 必要に応じてテストコードを修正 **4. AttributeError: 'XXX' object has no attribute 'YYY'** - **原因**: クラスに必要なメソッドや属性が定義されていない - **対処法**: - クラスに必要なメソッド/属性を追加 - メソッド名のスペルミスを確認 #### 4.3.3 個別のテスト関数を実行特定のテスト関数のみを実行して問題を切り分けます： ```bash # 特定のテストファイルのみ実行 pytest tests/stages/stage-01/test_bank_account.py -v # 特定のテスト関数のみ実行 pytest tests/stages/stage-01/test_bank_account.py::test_function_exists -v # テスト名の一部で絞り込み pytest -k "bank_account" -v ``` #### 4.3.4 テストコードの妥当性確認 - テストが課題仕様と一致しているか `release/README.md` と照らし合わせて確認 - テストの日本語コメントが学生にとって理解しやすいか確認 - エッジケースが適切にカバーされているか確認 ### 4.4 検証完了の確認全てのステージの検証が完了したら、最終確認を行います： ```bash # 全てのステージテストを実行 pytest tests/stages/ -v # テストカバレッジを確認（オプション） pytest tests/stages/ --cov=src/kadai --cov-report=term-missing ``` **期待される最終出力:** ``` ================================ test session starts ================================ collected XX items tests/stages/stage-01/test_XXX.py::test_... PASSED [ X%] tests/stages/stage-02/test_XXX.py::test_... PASSED [ X%] tests/stages/stage-03/test_XXX.py::test_... PASSED [ X%] tests/stages/stage-04/test_XXX.py::test_... PASSED [ X%] tests/stages/stage-05/test_XXX.py::test_... PASSED [ X%] ================================ XX passed in X.XXs ================================ ``` > **Success!** 全てのテストがパスしたら、検証は完了です。次のステップに進みましょう。 5. すべてのステージのテストが成功したら、以下のファイルを更新してください。 - `src/kadai/`: 全ステージをクリアするために必要な実装を含むファイルを模範解答として `agent-output/` 配下にコピーしてください。その後、元の `src/kadai/` 配下の実装済みファイルは全て空ファイルの状態に戻してください。 - `pytest.ini`: ステージごとのマーカー定義 `markers` に、実装した全てのステージマーカーを記述してください。 - `.github/workflows/classroom.yml`: `templates/template.classroom.yml` をベースとして、実装した全てのステージに対応するジョブを追加し、`README.md` の課題内容に基づいた配点を設定してください。テンプレートファイルには5ステージ分のジョブ定義が含まれているため、必要に応じてステージ数を調整し、各ステージの配点（`max-score`）を課題内容に合わせて更新してください。 6. [共通ワークフロー](.github/prompts/WORKFLOW.md) に従い、変更をコミット（メッセージ: "feat: implement and verify tests for $課題名"）し、リモートリポジトリにプッシュしてください。

{ "prompt": "# /implement-test.admin\n\n## 目的\n本リポジトリは、学生のプログラミング課題をCIで自動採点します。 \n`/implement-test.admin` では、`release/README.md` に記載された課題内容を基に、 \n学生が実装すべき機能に対応するテストコードを `tests/stages/stage-XX` 配下に実装し、 \n実際にテストを実行することで課題内容との整合性を検証します。\n\n## 前提条件\n- `/readme.admin` が実行済みで `release/README.md` が作成されていること\n\n## 手順\n1. `release/README.md` の内容を確認し、課題内容を理解してください。\n\n2. [共通ワークフロー](.github/prompts/WORKFLOW.md) に従い、ブランチ `feature/implement-tests` を作成してください。\n\n3. `tests/stages/stage-XX` 配下に、課題内容に対応するテストコードを実装してください。 \n - 各テストは `pytest` フレームワークを使用して実装してください。\n - 各ステージのテストコードは、課題の各機能に対応するように設計してください。\n - 各ステージ用ディレクトリ `tests/stages/stage-XX` には、対応するステージ番号に基づいたテストファイルを1つのみ作成してください。\n - 各テストファイル内では、以下のルールでテストを実装してください。\n - 全てのテスト関数には、`@pytest.mark.stageXX` デコレータを付与してください（XXはステージ番号）。\n - テスト対象のモジュールやクラスのインポートは、`pytest.ini` のルールに従って、 **必ず** テスト関数内で行ってください。\n - 1つのテスト関数内には、基本的に1つのアサーションのみを含めてください。 \n - 各アサーションの上の行には、何をテストしているのかが学生にとって明確になるよう、日本語のコメントを追加してください。\n - 実装例: \n ```python\n # tests/stages/stage-01/test_bank_account.py\n import pytest\n\n @pytest.mark.stage01\n def test_bank_account_exists():\n from kadai.bank_account import BankAccount\n\n # 銀行口座クラスが存在することを確認する\n assert BankAccount is not None\n \n # <... 他の stage-01 テスト関数も同様に実装 ...> \n ```\n\n4. テストコードを実装したら、実際に生徒が課題を実施する手順を想定して、以下のフローでテストを検証してください。 \n 検証中、テストコード側に問題が見つかった場合は、適宜修正を行ってください。\n\n ### 4.1 ステージ1の検証\n\n #### 4.1.1 テスト実行前の確認\n まず、リポジトリのルートディレクトリにいることを確認します。\n ```bash\n pwd\n # 期待される出力: /path/to/Meta-Template-for-Assignment\n ```\n\n #### 4.1.2 テストの失敗を確認（RED）\n 実装前の状態で、ステージ1のテストを実行し、テストが失敗することを確認します。\n ```bash\n pytest -m stage01 -v\n ```\n\n **期待される出力例（失敗時）:**\n ```\n ================================ test session starts ================================\n platform linux -- Python 3.x.x, pytest-7.x.x, pluggy-1.x.x\n rootdir: /path/to/Meta-Template-for-Assignment\n plugins: ...\n collected X items\n\n tests/stages/stage-01/test_XXX.py::test_function_exists FAILED [XX%]\n tests/stages/stage-01/test_XXX.py::test_basic_functionality FAILED [XX%]\n\n ===================================== FAILURES ======================================\n ______________________________ test_function_exists ________________________________\n ...\n ModuleNotFoundError: No module named 'kadai.XXX'\n ...\n ================================ X failed in X.XXs =================================\n ```\n\n > **Note:** この時点でテストが失敗するのは正常です。学生は空の実装ファイルから始めるため、必要なモジュールやクラスがまだ存在しません。\n\n #### 4.1.3 最低限の実装（GREEN）\n `src/kadai/` 配下に、ステージ1をクリアするために必要な最低限の実装を行います。\n 例えば、`src/kadai/bank_account.py` を作成し、以下のような実装を行います：\n ```python\n class BankAccount:\n def __init__(self, initial_balance=0):\n self.balance = initial_balance\n \n def deposit(self, amount):\n self.balance += amount\n \n def get_balance(self):\n return self.balance\n ```\n\n #### 4.1.4 テストの成功を確認（GREEN）\n 再度ステージ1のテストを実行し、全てのテストが成功することを確認します。\n ```bash\n pytest -m stage01 -v\n ```\n\n **期待される出力例（成功時）:**\n ```\n ================================ test session starts ================================\n platform linux -- Python 3.x.x, pytest-7.x.x, pluggy-1.x.x\n rootdir: /path/to/Meta-Template-for-Assignment\n plugins: ...\n collected X items\n\n tests/stages/stage-01/test_XXX.py::test_function_exists PASSED [XX%]\n tests/stages/stage-01/test_XXX.py::test_basic_functionality PASSED [XX%]\n\n ================================ X passed in X.XXs =================================\n ```\n\n #### 4.1.5 詳細な出力の確認（オプション）\n より詳細な情報が必要な場合は、以下のオプションを使用します：\n ```bash\n # テストの実行状況を詳細に表示\n pytest -m stage01 -vv\n\n # テスト結果の要約を表示\n pytest -m stage01 -v --tb=short\n\n # 失敗したテストのみを再実行\n pytest -m stage01 --lf\n ```\n\n ### 4.2 ステージ2以降の検証\n\n ステージ2以降も同様の手順で検証を行います。各ステージについて以下を実施してください：\n\n #### 4.2.1 各ステージの検証手順\n 1. **RED確認**: 実装前にテストを実行し、失敗を確認\n ```bash\n pytest -m stage02 -v # ステージ2の場合\n pytest -m stage03 -v # ステージ3の場合\n # 以降同様...\n ```\n\n 2. **実装**: `src/kadai/` 配下に該当ステージの機能を実装\n\n 3. **GREEN確認**: テストを実行し、成功を確認\n ```bash\n pytest -m stage02 -v # ステージ2の場合\n pytest -m stage03 -v # ステージ3の場合\n # 以降同様...\n ```\n\n #### 4.2.2 累積的なテスト確認\n 各ステージ完了後、それまでの全てのステージのテストが通ることを確認します：\n ```bash\n # ステージ1と2のテストを実行\n pytest -m \"stage01 or stage02\" -v\n\n # ステージ1から3までのテストを実行\n pytest -m \"stage01 or stage02 or stage03\" -v\n\n # 全てのステージのテストを実行\n pytest -m \"stage01 or stage02 or stage03 or stage04 or stage05\" -v\n # または\n pytest tests/stages/ -v\n ```\n\n ### 4.3 テスト失敗時のデバッグガイド\n\n テストが期待通りに動作しない場合、以下のデバッグ手順を実施してください。\n\n #### 4.3.1 エラーメッセージの確認\n ```bash\n # より詳細なエラー情報を表示\n pytest -m stage01 -vv --tb=long\n\n # 標準出力も含めて表示\n pytest -m stage01 -v -s\n ```\n\n #### 4.3.2 よくあるエラーと対処法\n\n **1. ModuleNotFoundError: No module named 'kadai.XXX'**\n - **原因**: 必要なモジュールファイルが存在しない、またはファイル名が間違っている\n - **対処法**: \n - `src/kadai/` 配下に正しいファイル名でモジュールを作成\n - `pytest.ini` の `pythonpath` 設定を確認\n\n **2. ImportError: cannot import name 'XXX' from 'kadai.YYY'**\n - **原因**: クラスや関数が定義されていない、または名前が間違っている\n - **対処法**:\n - モジュール内に必要なクラス/関数が定義されているか確認\n - スペルミスがないか確認\n\n **3. AssertionError**\n - **原因**: テストの期待値と実際の戻り値が一致していない\n - **対処法**:\n - テストコード内のコメントを読み、何をテストしているか確認\n - 実装が仕様通りか確認\n - 必要に応じてテストコードを修正\n\n **4. AttributeError: 'XXX' object has no attribute 'YYY'**\n - **原因**: クラスに必要なメソッドや属性が定義されていない\n - **対処法**:\n - クラスに必要なメソッド/属性を追加\n - メソッド名のスペルミスを確認\n\n #### 4.3.3 個別のテスト関数を実行\n 特定のテスト関数のみを実行して問題を切り分けます：\n ```bash\n # 特定のテストファイルのみ実行\n pytest tests/stages/stage-01/test_bank_account.py -v\n\n # 特定のテスト関数のみ実行\n pytest tests/stages/stage-01/test_bank_account.py::test_function_exists -v\n\n # テスト名の一部で絞り込み\n pytest -k \"bank_account\" -v\n ```\n\n #### 4.3.4 テストコードの妥当性確認\n - テストが課題仕様と一致しているか `release/README.md` と照らし合わせて確認\n - テストの日本語コメントが学生にとって理解しやすいか確認\n - エッジケースが適切にカバーされているか確認\n\n ### 4.4 検証完了の確認\n\n 全てのステージの検証が完了したら、最終確認を行います：\n\n ```bash\n # 全てのステージテストを実行\n pytest tests/stages/ -v\n\n # テストカバレッジを確認（オプション）\n pytest tests/stages/ --cov=src/kadai --cov-report=term-missing\n ```\n\n **期待される最終出力:**\n ```\n ================================ test session starts ================================\n collected XX items\n\n tests/stages/stage-01/test_XXX.py::test_... PASSED [ X%]\n tests/stages/stage-02/test_XXX.py::test_... PASSED [ X%]\n tests/stages/stage-03/test_XXX.py::test_... PASSED [ X%]\n tests/stages/stage-04/test_XXX.py::test_... PASSED [ X%]\n tests/stages/stage-05/test_XXX.py::test_... PASSED [ X%]\n\n ================================ XX passed in X.XXs ================================\n ```\n\n > **Success!** 全てのテストがパスしたら、検証は完了です。次のステップに進みましょう。\n\n5. すべてのステージのテストが成功したら、以下のファイルを更新してください。\n - `src/kadai/`: 全ステージをクリアするために必要な実装を含むファイルを模範解答として `agent-output/` 配下にコピーしてください。 \n その後、元の `src/kadai/` 配下の実装済みファイルは全て空ファイルの状態に戻してください。\n - `pytest.ini`: ステージごとのマーカー定義 `markers` に、実装した全てのステージマーカーを記述してください。\n - `.github/workflows/classroom.yml`: `templates/template.classroom.yml` をベースとして、実装した全てのステージに対応するジョブを追加し、`README.md` の課題内容に基づいた配点を設定してください。 \n テンプレートファイルには5ステージ分のジョブ定義が含まれているため、必要に応じてステージ数を調整し、各ステージの配点（`max-score`）を課題内容に合わせて更新してください。\n\n6. [共通ワークフロー](.github/prompts/WORKFLOW.md) に従い、変更をコミット（メッセージ: \"feat: implement and verify tests for $課題名\"）し、リモートリポジトリにプッシュしてください。", "variables": [], "notes": "課題をCIで自動採点するためのテストコードを実装し、実際に実行することで課題内容との整合性を検証します。", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/snowman-se/meta-template-for-assignment2", "path": ".github/prompts/implement-test.admin.prompt.md", "ref": "aa3183181de6b8ffc696fd3efa6ca6bcd4e23560", "url": "https://github.com/snowman-se/meta-template-for-assignment2/blob/aa3183181de6b8ffc696fd3efa6ca6bcd4e23560/.github/prompts/implement-test.admin.prompt.md", "key": "snowman-se/meta-template-for-assignment2/.github/prompts/implement-test.admin.prompt.md" } } }

implement-test.admin

About

/implement-test.admin

目的

前提条件

手順

4.1 ステージ1の検証

4.1.1 テスト実行前の確認

4.1.2 テストの失敗を確認（RED）

4.1.3 最低限の実装（GREEN）

4.1.4 テストの成功を確認（GREEN）

4.1.5 詳細な出力の確認（オプション）

4.2 ステージ2以降の検証

4.2.1 各ステージの検証手順

4.2.2 累積的なテスト確認

4.3 テスト失敗時のデバッグガイド

4.3.1 エラーメッセージの確認

4.3.2 よくあるエラーと対処法

4.3.3 個別のテスト関数を実行

4.3.4 テストコードの妥当性確認

4.4 検証完了の確認

Use it

Manifest

Reviews