tomevault-io テストコード作成スキル
このスキルは、テストコードを生成するためのガイドラインと手順を提供します。
テストの実装方針
基本方針
- 過剰なカバレッジは追わず、維持可能で実用的なテストを優先する
- 正常系を中心に実装し、必要最小限の異常系を追加する
- 純粋なロジック部分のみをテスト対象とする（ビジネスロジック、ユーティリティ関数など）
- 外部API（OpenAI/Azure OpenAI、Spotify、Google Drive、LINE等）は実呼び出しする場合のみテストし、環境変数がなければ
pytest.skipで飛ばす - Cosmos DBやStorageなどのインフラ依存は原則テストしない（接続もモックもしない）
- 共通のセットアップが必要な場合は
conftest.pyにまとめる（現状は未使用）
サービス単位の注意点
- リポジトリは
src/api,src/func,src/mcpの3サービス構成。テストは対象サービスのディレクトリで実行する（例:cd src/api && uv run pytest） - 各サービスで必要に応じてフィクスチャを追加する（現状は
monkeypatch等の標準的なものを使用）
外部APIの扱い
- 外部APIは実呼び出しを行う（OpenAI/Azure OpenAI、Spotify、Google Drive等）
- 必要な環境変数がない場合は
pytest.skipで飛ばす - 例:
if not os.getenv("OPENAI_API_KEY"): pytest.skip("OPENAI_API_KEY environment variable not set") - モックは使わず、実際の動作確認を重視する
データベースと状態管理
- Cosmos DBやStorageは原則テストしない
- DBに依存しない純粋なロジック部分のみをテスト対象とする
- モックエージェントやダミークラスを使ってロジックを検証する（例:
test_digest_reorganizer.py参照）
実装手順（推奨ワークフロー）
- 変更対象のサービスディレクトリで既存テストを確認する（
uv run pytest -q） - 純粋なロジック部分を抽出してテスト対象を明確にする
- 外部API呼び出しが必要な場合は、環境変数チェックと
pytest.skipを実装する - 作成したテストをローカルで実行・修正する（
uv run pytest <test_file>）
注意点
- テストは
uv run pytestで実行する（uvラッパーはこのリポジトリの実行方針に準拠） - DBやインフラ依存は避け、純粋なロジックのみをテストする
- 外部API呼び出しが必要な場合は環境変数チェックと
pytest.skipを必ず実装する
このガイドに沿ってテストを実装してほしい。具体的なテストファイルの雛形や、既存テストの修正が必要なら手を入れるので知らせてください。
Instructions
方針確認
- 上の「テストの実装方針」を読み、対象サービス（
src/api/src/func/src/mcp）に合わせて進める - 純粋なロジック部分のみをテスト対象とする
- DB依存部分はテストしない
- 上の「テストの実装方針」を読み、対象サービス（
既存テストの確認
- 同じサービス内の既存テストを確認し、パターンを踏襲する
- 例:
test_crypto_utils.py（ロジックテスト）、test_spotify_search.py（API実呼び出し）
テスト計画と実装
- 何を検証するか（ユーティリティ関数、ビジネスロジック等）を明確化する
- 外部API呼び出しが必要な場合は環境変数チェックと
pytest.skipを実装する - DB依存を避け、モックエージェントやダミークラスを使う（例:
test_digest_reorganizer.py）
実行と検証
- 対象サービスディレクトリで依存を固定してからテストを実行する:
cd src/api # または src/func, src/mcp
uv sync --frozen
uv run pytest -q
問題があれば修正し再実行する
Converted and distributed by TomeVault — claim your Tome and manage your conversions.