django-verification

django-verification 技能總覽

django-verification 的用途

django-verification 技能是一套給 Django 專案用的發布就緒工作流程。它能協助你檢查那些最常讓 PR 和部署出問題的基本項目：環境設定、lint、格式化、型別檢查、migration、含覆蓋率的測試，以及偏向安全性的 Django 檢查。

適合誰使用

如果你在做 Django 後端，並且想要一套可重複執行、適合 PR 前或部署前的檢查清單，而不是一個泛泛的「幫我跑測試」提示，那就很適合用 django-verification 技能。它特別適合需要在審查前先抓出 migration 問題、設定錯誤與程式碼品質退化的後端開發者。

為什麼它有用

它的核心價值在於順序與明確性。這個技能不只是叫你「檢查專案」，而是把你帶進一個實際可操作的驗證迴圈：先盡早停在環境問題，再往品質檢查、migration 安全性與部署就緒度前進。當 Django 應用有多個相互牽動的部分時，這能大幅減少猜測成本。

如何使用 django-verification 技能

安裝並啟用

執行 django-verification install 時，先把這個技能加入你的 Claude Code 設定，並使用 repository 的 skills 路徑載入它，再針對當前任務使用：
npx skills add affaan-m/everything-claude-code --skill django-verification

當你的目標是驗證一組 Django 變更，而不是只想針對單一錯誤訊息問一次問題時，才適合使用它。

先提供正確的輸入

django-verification usage 在你提供以下資訊時效果最好：

• Django 版本與 Python 版本
• 變更類型：model 變更、依賴升級、settings 變動、API 變更，或部署前準備
• 你這個 repo 已經在用的命令，例如 pytest、manage.py test、ruff 或 mypy
• 已知限制，例如只有 CI 才有的 secrets、Docker，或非標準的 settings module

較弱的提示詞會是：「幫我檢查我的 Django app。」
較強的提示詞會是：「針對一個 Django 4.2 app 在 model 與 migration 變更後執行 django-verification；優先檢查 migration 安全性、ruff、mypy 與部署檢查；把任何會阻擋發佈的項目都標出來。」

先閱讀這些檔案

為了實際導入，先讀 SKILL.md，再視情況檢查 README.md、AGENTS.md、metadata.json，以及任何支援資料夾。這個 repository 目前只露出 SKILL.md，所以要把它當成唯一的權威來源，並依照你專案實際使用的工具鏈調整工作流程。

把它當工作流程，不是腳本

最佳的 django-verification guide 模式是：

1. 先確認環境與設定正確。
2. 執行程式碼品質檢查，並修掉明顯問題。
3. 在 schema 相關變更前後驗證 migrations。
4. 執行含覆蓋率的測試。
5. 最後做部署就緒檢查。

這個順序很重要，因為它能避免把時間浪費在其實是環境損壞或 migration 有問題所造成的測試失敗上。

django-verification 技能 FAQ

django-verification 只適合後端開發嗎？

是，django-verification for Backend Development 這樣理解最正確。它是圍繞 Django app 的品質、安全性與可部署性設計的，不是前端工作流程，對 design system 或純瀏覽器相關問題也幫助有限。

如果我已經有 CI pipeline，還需要它嗎？

如果你想在 CI 之前先做本機或由 agent 驅動的預檢，那答案是需要。django-verification skill 會補強 CI，幫你更早抓出問題，並讓 agent 依照結構化路徑完成各項檢查。CI 當然還是重要，但這個技能能減少 pipeline 跑起來前的來回溝通與雜訊。

什麼情況下不該用？

如果只是很小的變更，沒有碰到 Django 行為，就可以先跳過；或者當你只需要一個有明確目標的單一命令時，也不必使用它。如果你的專案不使用它預期的常見工具，例如以 migration 為基礎的 schema 管理、或標準的 lint/test 命令，那它也不算理想選擇。

這個技能對新手友善嗎？

大致上是友善的。因為它提供了有順序的檢查清單，所以比自己拼出一個客製化審查提示詞更容易上手。新手最容易遇到的問題，是輸入太模糊，最後只得到泛用的驗證結果，而不是針對專案本身的檢查。

如何改進 django-verification 技能

給技能更多上下文

django-verification 的輸出品質，很大程度取決於你把 repo 狀態描述得多清楚。請包含變更過的檔案、最近的失敗 log，以及你專案實際使用的命令。如果有 migration 相關變更，也要說明你是新增欄位、重新命名 model、改了 nullability，還是修改 constraints。

要求合適的深度

如果你只需要 smoke test，就明確說出來；如果你需要的是 release gate，就要求更嚴格的檢查與明確的停止條件。例如：「任何 migration 衝突、缺少 env var、測試失敗或部署警告都視為阻擋發佈。」這樣結果才更接近可直接做決策的資訊。

留意常見失敗模式

最常見的錯誤，是把這個技能當成泛用的 Django checklist，卻沒有依 repo 調整。另一個失敗模式，是跳過環境驗證，直接進到測試。對 django-verification 來說，這樣很容易把後面失敗的真正原因遮住。

用 repo 專屬證據反覆迭代

第一次跑完後，把具體失敗結果回饋回去，並要求更窄範圍的重跑。例如：「重新執行 django-verification，只聚焦在 migration 安全性和測試覆蓋率；lint 那一步已經是乾淨的。」這樣下一輪會比重跑完整流程更快，也更有用。