name	tdd-workflow
description	TDDワークフローを強制し、テストファースト開発を支援します。新機能実装時に自動起動し、Red-Green-Refactorサイクルを確実に実行します。
allowed-tools	Read Edit Write Glob Grep Bash

TDD Workflow スキル

このスキルは、Constitution Article 1: Test-First Imperative を強制し、テスト駆動開発（TDD）ワークフローを支援します。

起動条件

以下の状況で自動起動します：

新機能実装開始時: 新しい機能の実装を開始する際
バグ修正開始時: バグを修正する際（再現テストを先に作成）
リファクタリング開始時: 既存コードの改善前にテストを確認

TDDサイクル

Phase 1: Red（テスト作成・失敗確認）

目的: 失敗するテストを先に作成する

テストファイルの作成/特定
- ファイル命名規則: test_<機能名>.py
- 配置場所: tests/ ディレクトリ
テストケースの設計
- 期待する動作を明確に定義
- エッジケースを考慮
- 失敗する理由を明確に

テストの実行と失敗確認

uv run pytest tests/test_<機能名>.py -v

ユーザー承認
- テストケースをユーザーに提示
- 承認を得てから次のフェーズへ

Phase 2: Green（最小限の実装）

目的: テストを通過する最小限のコードを実装する

実装ファイルの作成
- テストを通過させることのみに集中
- 過剰な設計を避ける

テストの実行と成功確認

uv run pytest tests/test_<機能名>.py -v

品質チェック

uv run ruff check --fix . && uv run ruff format . && uv run mypy .

Phase 3: Refactor（リファクタリング）

目的: テストを維持しながらコードを改善する

コードの改善
- 重複の除去
- 可読性の向上
- パフォーマンスの最適化

テストの再実行

uv run pytest tests/test_<機能名>.py -v

全テストの確認
```
uv run pytest
```

テスト構成の原則

ファイル対応

実装ファイル	テストファイル
`src/auth.py`	`tests/test_auth.py`
`src/article.py`	`tests/test_article.py`
`src/session.py`	`tests/test_session.py`

テストクラス構成

# tests/test_auth.py
import pytest

class TestLogin:
    """ログイン機能のテスト"""

    def test_login_success(self) -> None:
        """正常なログインが成功すること"""
        ...

    def test_login_invalid_credentials(self) -> None:
        """無効な認証情報でエラーになること"""
        ...


class TestLogout:
    """ログアウト機能のテスト"""

    def test_logout_success(self) -> None:
        """正常なログアウトが成功すること"""
        ...

テスト命名規則

test_<機能>_<状況>_<期待結果>
例: test_login_with_valid_credentials_returns_session

ワークフロー例

例1: 新しいログイン機能の実装

Step 1: テスト作成（Red）

# tests/test_auth.py
import pytest
from src.auth import login

class TestLogin:
    def test_login_success(self) -> None:
        """正常なログインが成功すること"""
        result = login("valid_user", "valid_password")
        assert result.success is True
        assert result.session_id is not None

    def test_login_invalid_password(self) -> None:
        """無効なパスワードでエラーになること"""
        with pytest.raises(AuthenticationError):
            login("valid_user", "wrong_password")

Step 2: テスト失敗確認

uv run pytest tests/test_auth.py -v
# FAILED - ImportError: cannot import name 'login' from 'src.auth'

Step 3: ユーザー承認

「このテストケースで進めてよろしいですか？」

Step 4: 最小実装（Green）

# src/auth.py
from dataclasses import dataclass

@dataclass
class LoginResult:
    success: bool
    session_id: str | None

class AuthenticationError(Exception):
    pass

def login(username: str, password: str) -> LoginResult:
    if password == "wrong_password":
        raise AuthenticationError("Invalid credentials")
    return LoginResult(success=True, session_id="session_123")

Step 5: テスト成功確認

uv run pytest tests/test_auth.py -v
# PASSED

Step 6: リファクタリング（Refactor）

必要に応じてコードを改善

注意事項

テストなしの実装は禁止: Article 1 は非交渉的原則
テストの承認は必須: ユーザー承認なしに実装を進めない
テストカバレッジ: 主要なパスとエッジケースをカバー
モック使用: 外部依存はモックを使用して単体テストを実現

チェックリスト

実装開始前に確認：

テストファイルが存在するか
テストが失敗状態（Red）であることを確認したか
ユーザーがテストケースを承認したか

実装完了時に確認：

すべてのテストがパス（Green）しているか
品質チェック（ruff, mypy）がパスしているか
不要なコードがないか（リファクタリング完了）

tdd-workflow

Install Skill

SKILL.md