django-tdd

django-tdd 技能概览

django-tdd 的用途

django-tdd 技能是一份面向 Django 项目的测试驱动开发实战指南。它帮助你先写测试，再构建模型、视图、serializer 和 API 来满足这些测试，常用到 pytest、pytest-django、factory_boy、mocking 和覆盖率报告等工具。

适合谁使用

如果你是在现有 Django 应用里加功能、从零启动新项目，或者想把需要更好测试结构的 Django REST Framework 代码库梳理得更规范，那么就适合使用这个 django-tdd skill。它最适合你想建立可重复的测试习惯，而不只是临时拼几段测试代码的场景。

它的优势在哪里

和通用提示词相比，django-tdd 对 TDD 循环更有明确立场：先定义行为，写一个会失败的测试，实现最小改动，然后安全重构。这让它特别适合 django-tdd for Test Automation 这类工作，因为这时回归保护、API 行为和可维护的 fixtures 比单纯生成代码更重要。

如何使用 django-tdd 技能

安装并启用该技能

如果要进行 django-tdd install，先通过仓库提供的技能安装流程把它加入你的 Claude Code 环境，然后在技能目录中工作：skills/django-tdd。核心入口是 SKILL.md；这个仓库里没有配套的 scripts/、references/ 或 resources/ 层，所以是否安装，主要应依据这个技能文件本身来判断。

给技能一个合适的起始说明

想获得更好的 django-tdd usage，一开始就告诉它三件事：Django 应用中的具体区域、你希望测试的行为、以及会影响实现方式的技术栈细节。比如说：“为一个创建订单的 DRF endpoint 补测试，使用 factories，并且在输入不合法时必须返回 201 和校验错误。” 这比“帮我写 API 测试”更有效，因为它给了技能明确的验收目标。

按正确顺序阅读仓库文件

先看 SKILL.md，再检查你项目里的 pytest.ini、测试设置，以及现有的 tests/ 或 conftest.py 文件。只有当技能能对齐你项目当前的 markers、数据库策略和 factory 模式时，它的建议才最有价值，而不是另起一套平行配置。

把它当工作流用，不要当模板堆

django-tdd guide 最好按一段一段的行为来提需求：一个模型规则、一条 serializer 校验路径、一个权限检查，或者一个 endpoint 的响应。请求要足够小，这样技能才能产出失败测试、最小代码修改和重构步骤，而不是把无关问题混在一起。

django-tdd 技能常见问题

django-tdd 只适用于 DRF 项目吗？

不是。这个技能包含 Django REST Framework 示例，但也覆盖模型、视图、serializer 和测试配置。如果你的项目是纯 Django，只要你想采用 TDD 优先的工作流，它依然能派上用场。

我需要已经配置好 pytest 吗？

理想情况下是需要的。django-tdd skill 默认假设你使用的是以 pytest 为核心的测试栈，尤其是 pytest-django。如果你的项目还只使用 Django 自带的测试运行器，在这个技能真正好用之前，可能还需要先做一小步基础配置。

什么时候不该用 django-tdd？

如果你需要的是快速探索性的原型、一次性脚本，或者不需要具体测试用例的宽泛产品文案，那就先别用它。django-tdd 面向的是需要可验证、可重复、可安全演进的代码。

它适合新手吗？

如果你能用通俗英语描述预期行为，它对新手是友好的。若你自己还不清楚应该断言什么，它就没那么有帮助，因为这个技能依赖清晰、具体的测试意图。

如何改进 django-tdd 技能

提供行为，而不只是功能名

输入越具体，测试就越有价值。不要只说“添加认证测试”，而要说“断言未认证用户在 POST /api/orders/ 时返回 401，已认证用户可以创建订单，输入无效时返回字段错误”。这样 django-tdd 才有足够细节写出有意义的验收覆盖。

尽早说明你的项目约束

把 factory_boy 的使用方式、自定义用户模型、数据库依赖、现有 fixtures，以及任何 DRF 权限或 serializer 规则告诉技能。这些约束会改变测试搭建的形态，也能避免输出看起来正确、实际上却不适配你代码库的内容。

一次只要一段 red-green-refactor

最好的结果来自迭代式的 django-tdd usage：先要失败测试，再要最小实现，最后再做清理重构。如果第一轮输出范围太大，就把下一轮提示缩小到仍然薄弱的那个断言或边界情况。

留意常见失败模式

最常见的问题是测试在描述实现方式，而不是行为本身。另一个问题是，当一个更简单的断言就足够清楚时，却过度使用 factories 或 mocks。如果你看到了这种情况，就让技能把测试简化、对齐你当前的应用结构，并且保留 TDD 的顺序，不要直接跳到最终代码。