django-tdd

django-tdd skill の概要

django-tdd は何のためのものか

django-tdd skill は、Django プロジェクトでテスト駆動開発を進めるための実践的なガイドです。pytest、pytest-django、factory_boy、モック、カバレッジレポートなどを使いながら、まずテストを書き、そのテストを満たすようにモデル、ビュー、シリアライザー、API を実装していく流れを支えます。

どんな人に向いているか

既存の Django アプリに機能を追加するとき、新しいプロジェクトを立ち上げるとき、あるいはテスト構造をもっと整えたい Django REST Framework のコードベースを改善するときに、この django-tdd skill を使うと効果的です。単発のテスト断片が欲しいのではなく、再現性のあるテスト習慣を作りたい場合に特に向いています。

何が優れているか

一般的なプロンプトと比べて、django-tdd は TDD のループに明確な方針があります。つまり、振る舞いを定義し、失敗するテストを書き、最小限の修正を加え、最後に安全にリファクタリングする、という流れです。そのため、回帰防止、API の挙動、保守しやすいフィクスチャが重要な django-tdd for Test Automation の用途に、より適した選択肢になります。

django-tdd skill の使い方

スキルをインストールして有効化する

django-tdd install を行うには、リポジトリの skill インストール手順に従って Claude Code 環境へこの skill を追加し、その後 skills/django-tdd で作業します。中心となるエントリポイントは SKILL.md です。この repo には scripts/、references/、resources/ の補助層がないため、導入可否は skill ファイルそのものを基準に判断してください。

最初の依頼に必要な情報を渡す

django-tdd usage を最大限活かすには、最初に次の3点を伝えるのが重要です。Django アプリの対象領域、テストしたい振る舞い、そして実装に影響するスタック情報です。たとえば「注文を作成する DRF エンドポイントのテストを追加して。factory を使い、入力が不正なら 201 ではなく検証エラーを返したい」といった具合です。これなら、単に「API のテストを書いて」よりも、明確な合格条件をスキルに渡せます。

repo ファイルは正しい順番で読む

まず SKILL.md を読み、そのあとプロジェクト側の pytest.ini、テスト設定、既存の tests/ や conftest.py を確認してください。スキルの案内が最も力を発揮するのは、あなたのプロジェクトにあるマーカー、DB 戦略、factory パターンに合わせられるときであり、別系統のセットアップを勝手に作ることではありません。

テンプレート集ではなくワークフローとして使う

django-tdd guide は、1回で1つの振る舞いに絞って依頼すると最もうまく機能します。たとえば、モデルのルール、シリアライザーのバリデーション経路、権限チェック、エンドポイントのレスポンスなどです。依頼は十分に小さくして、スキルが失敗するテスト、最小限のコード変更、リファクタリングの手順を、無関係な論点を混ぜずに出せるようにしてください。

django-tdd skill の FAQ

django-tdd は DRF プロジェクト専用ですか？

いいえ。Django REST Framework の例は含まれていますが、モデル、ビュー、シリアライザー、テスト設定までカバーしています。プレーンな Django プロジェクトでも、TDD ファーストのワークフローを使いたいなら十分役立ちます。

pytest はすでに設定しておく必要がありますか？

理想的には、はい。django-tdd skill は pytest ベースのテストスタックを前提としており、とくに pytest-django を想定しています。まだ Django 標準のテストランナーだけを使っている場合は、スキルを十分活用できる状態にする前に、少しセットアップを整える必要があるかもしれません。

どんな場合に django-tdd を使わないほうがいいですか？

素早い探索的プロトタイプ、使い捨てのスクリプト、具体的なテストケースを伴わない広い範囲のプロダクト文案が必要な場合は、使わないほうがよいです。django-tdd は、検証可能で、再現できて、将来も安全に変更できるコードを対象にしています。

初心者向けですか？

期待する振る舞いを平易な英語で説明できるなら、初心者にも使いやすいです。逆に、何を assert すべきかまだ分かっていない段階では、あまり役立ちません。というのも、この skill は正確なテスト意図を前提にしているからです。

django-tdd skill を改善する方法

機能名だけでなく、振る舞いを伝える

入力が具体的であるほど、テストの質も上がります。「認証テストを追加して」ではなく、「未認証ユーザーは POST /api/orders/ で 401、認証済みユーザーは注文を作成でき、無効な payload では field errors を返す」と伝えてください。これだけの情報があれば、django-tdd は意味のある受け入れテストを作れます。

プロジェクトの制約は早めに共有する

factory_boy の使い方、カスタムユーザーモデル、DB 依存、既存の fixture、DRF の permission や serializer のルールをスキルに伝えてください。こうした制約はテストセットアップの形を変えますし、見た目は正しくてもコードベースに合わない出力を防げます。

1回につき red-green-refactor を1スライスずつ依頼する

最も良い結果は、反復的な django-tdd usage から生まれます。まず失敗するテストを依頼し、次に最小限の実装、最後に整理のためのリファクタリングを依頼してください。最初の出力が広すぎるなら、次のプロンプトでは、まだ弱く感じる特定の assert やエッジケースに絞り込むとよいです。

よくある失敗パターンに注意する

最も多い見落としは、振る舞いではなく実装を説明してしまうテストです。もう1つは、よりシンプルな assert で十分な場面でも factory や mock を使いすぎることです。そう感じたら、テストを簡潔にして、現在のアプリ構成に合わせ、final code に飛ばず TDD の順序を保つようスキルに依頼してください。