django-verification

django-verification 概览

django-verification 的作用

django-verification skill 是面向 Django 项目的发布就绪工作流。它帮助你验证那些最容易导致 PR 和部署失败的基础项：环境配置、lint、格式化、类型检查、迁移、带覆盖率的测试，以及面向安全性的 Django 检查。

适合谁使用

如果你在做 Django 后端开发，并且想要一个可重复的 pre-PR 或 pre-deploy 检查清单，而不是一句泛泛的“跑一下测试”，那就适合用 django-verification skill。它尤其适合需要在评审前提前发现迁移问题、配置错误和代码质量回退的后端开发者。

它为什么有用

它的核心价值在于顺序明确、检查具体。这个 skill 不是简单地让你“检查项目”，而是带你走完一套实际可执行的验证流程：先尽早停在环境问题上，再推进到质量检查、迁移安全和部署就绪度。对于有多个环节联动的 Django 应用来说，这能显著减少猜测成本。

如何使用 django-verification skill

安装并启用它

对于 django-verification install，先把 skill 按仓库里的 skills 路径加入你的 Claude Code 配置，然后在当前任务中加载它：
npx skills add affaan-m/everything-claude-code --skill django-verification

当你的目标是验证一组 Django 变更时使用它，而不是只想针对某个报错消息得到一次性答案时。

先提供正确的输入

django-verification usage 在你提供以下信息时效果最好：

• Django 版本和 Python 版本
• 变更类型：模型变更、依赖升级、settings 变更、API 变更，或部署前准备
• 仓库已经在用的命令，例如 pytest、manage.py test、ruff 或 mypy
• 任何已知限制，例如仅 CI 可用的 secrets、Docker，或非标准的 settings module

一个弱的提示会说： “Check my Django app.”
一个更好的提示会说： “Run django-verification for a Django 4.2 app after model and migration changes; prioritize migration safety, ruff, mypy, and deploy checks; call out anything that blocks release.”

先读这些文件

为了真正落地使用，先读 SKILL.md，再检查 README.md、AGENTS.md、metadata.json，以及如果存在的话任何辅助目录。在这个仓库里，SKILL.md 是唯一可见文件，所以应把它当作唯一事实来源，并根据你项目的实际工具链来调整工作流。

把它当作工作流，而不是脚本

最好的 django-verification guide 使用方式是：

1. 先确认环境和 settings 都正确。
2. 运行代码质量检查，并修复明显问题。
3. 在涉及 schema 的改动前后验证迁移。
4. 运行带覆盖率的测试。
5. 最后做部署就绪检查。

这个顺序很重要，因为它可以避免把时间浪费在由环境损坏或迁移异常引发的测试失败上。

django-verification skill 常见问题

django-verification 只适合后端开发吗？

是的，django-verification for Backend Development 这个定位最准确。它是围绕 Django 应用质量、安全性和可部署性设计的，不是前端工作流，也不会太多帮助你处理设计系统或纯浏览器侧的问题。

如果我已经有 CI 流水线，还需要它吗？

需要，前提是你希望在本地或由 agent 驱动的 CI 之前先做一次预检。django-verification skill 可以和 CI 形成互补：它帮助你更早发现问题，并给 agent 一条结构化的检查路径。CI 依然重要，但这个 skill 能减少流水线跑起来之前那些来回反复、噪音很大的排查。

什么情况下不该用它？

如果改动很小，而且不涉及 Django 行为，就可以跳过。只需要一个单点命令时，它也不合适。如果你的项目并不使用它所预期的常见工具链，比如基于迁移的 schema 管理，或者标准的 lint/test 命令，那么它的匹配度也会比较差。

对新手友好吗？

大体上是友好的。它比自己拼一个自定义 review prompt 更容易上手，因为它提供了一个有顺序的检查清单。新手最大的风险是输入太模糊，这会让结果变成通用验证，而不是针对项目的检查。

如何改进 django-verification skill

给 skill 更多上下文

django-verification 的输出质量，取决于你把仓库状态说得有多清楚。请包含改动文件、最近的失败日志，以及你项目实际使用的命令。如果涉及迁移，要说明你是新增字段、重命名模型、修改 nullability，还是改了约束。

直接要求合适的深度

如果你只需要 smoke test，就明确说明。如果你需要 release gate，就要求更严格的检查和明确的停止条件。例如： “Treat any migration conflict, missing env var, failing test, or deploy warning as blocking.” 这样结果会更接近可直接决策的输出。

注意常见失败模式

最常见的失误，是把这个 skill 当成通用 Django 清单来用，却没有根据仓库实际情况调整。另一种失败模式，是跳过环境验证，直接跑测试。对于 django-verification 来说，这样往往会掩盖后续失败的真正原因。

结合仓库证据反复迭代

第一次跑完后，把具体失败结果反馈回去，并要求更聚焦地重跑。例如： “Re-run django-verification focusing on migration safety and test coverage only; the lint step is already clean.” 这样下一轮会比重复完整流程更快，也更有用。