django-tdd

django-tdd 技能概覽

django-tdd 是用來做什麼的

django-tdd 技能是一份實用指南，協助你在 Django 專案中落實測試驅動開發（TDD）。它會引導你先寫測試，再透過模型、views、serializers 和 APIs 的實作來滿足這些測試，並搭配 pytest、pytest-django、factory_boy、mocking 與 coverage reporting 等工具一起使用。

適合誰使用

如果你正在替既有的 Django app 加功能、從零啟動新專案，或是想把需要更好測試結構的 Django REST Framework 程式碼整理得更扎實，django-tdd skill 會很適合你。它最有價值的情境，不是丟給你一段一次性的測試片段，而是你需要可重複的測試習慣。

它的優勢在哪裡

和一般通用提示詞相比，django-tdd 對 TDD 迴圈有明確立場：先定義行為、寫出會失敗的測試、用最小改動完成實作，最後安全重構。這讓它特別適合 django-tdd for Test Automation 這類工作，因為回歸保護、API 行為和可維護的 fixtures 往往比單純產出程式碼更重要。

如何使用 django-tdd 技能

安裝並啟用這個技能

若要進行 django-tdd install, 請依照 repo 的技能安裝流程，把這個技能加入你的 Claude Code 環境，然後在技能目錄中操作：skills/django-tdd。核心入口是 SKILL.md；這個 repo 裡沒有 scripts/、references/ 或 resources/ 這些支援層，因此安裝與否的判斷，應該以這個技能檔本身為主。

一開始就提供正確的需求簡報

要讓 django-tdd usage 發揮最佳效果，請一開始就告訴它三件事：Django app 的範圍、你希望測試的行為，以及會影響實作的技術棧細節。比如說：“Add tests for a DRF endpoint that creates orders, uses factories, and must return 201 with validation errors on bad input.” 這樣比「幫我的 API 寫測試」更好，因為它能給技能一個明確的驗收目標。

先依正確順序閱讀 repo 檔案

先看 SKILL.md，再檢查你專案中的 pytest.ini、test settings，以及任何既有的 tests/ 或 conftest.py 檔案。當這個技能能對齊你專案現有的 markers、資料庫策略與 factory 模式時，建議才最有力，而不是另外憑空建立一套平行配置。

把它當成工作流程，不是模板整包輸出

django-tdd guide 最適合用在一次只處理一小段行為的情境：一條 model 規則、一段 serializer 驗證流程、一次權限檢查，或一個 endpoint 回應。把需求切得夠小，技能才有辦法同時產出失敗測試、最小程式碼修改與重構步驟，而不會把不相關的問題混在一起。

django-tdd 技能 FAQ

django-tdd 只適合 DRF 專案嗎？

不是。這個技能有 Django REST Framework 的範例，但也涵蓋 models、views、serializers 與測試設定。只要你的專案是純 Django，而且你想採用以 TDD 為先的工作流程，它一樣能派上用場。

我一定要先把 pytest 設好嗎？

理想上是要。django-tdd skill 預設你已經有以 pytest 為核心的測試堆疊，尤其是 pytest-django。如果你的專案還只用 Django 預設的 test runner，你可能需要先做一次小型設定整理，這個技能才會真正好用。

什麼情況下不該用 django-tdd？

如果你只是要快速試做一個原型、寫一段一次性腳本，或需要的是沒有具體測試案例的大範圍產品文案，就可以先跳過它。django-tdd 的目標是那些應該被驗證、可重複執行，而且能安全演進的程式碼。

對新手友善嗎？

如果你能用白話描述預期行為，它就算對新手也算友善。若你還不知道應該斷言什麼，它就沒那麼有幫助，因為這個技能很依賴明確的測試意圖。

如何改進 django-tdd 技能

提供的是行為，不只是功能名稱

輸入越具體，產出的測試就越好。不要只說「加上 authentication tests」，而是說「驗證未登入使用者在 POST /api/orders/ 會拿到 401，已登入使用者可以建立訂單，且不合法的 payload 會回傳欄位錯誤。」這樣 django-tdd 才有足夠細節寫出有意義的驗收覆蓋。

盡早告訴它你的專案限制

請把 factory_boy 的使用方式、自訂 user model、資料庫依賴、既有 fixtures，以及任何 DRF permissions 或 serializer 規則一起告訴技能。這些限制會直接影響測試設定的形狀，也能避免輸出看起來對、實際卻不符合你 codebase 的內容。

一次只要求一小段 red-green-refactor

最好的結果通常來自迭代式的 django-tdd usage：先要失敗測試，再要最小實作，最後再做清理重構。如果第一輪輸出太大包，下一輪就把 prompt 收斂到仍然不夠穩的那個斷言或邊界情境。

注意常見失敗模式

最常見的問題，是測試在描述實作，而不是描述行為。另一個常見問題，是在其實用更簡單斷言就能說清楚時，過度使用 factories 或 mocks。如果你看到這種情況，就要求技能把測試簡化、對齊你目前的 app 結構，並保留 TDD 順序，不要直接跳到最終程式碼。