netlify-forms
作者 netlify這份 netlify-forms 指南說明如何在 Netlify 上處理 HTML 表單。可用來新增聯絡表單、意見回饋表單、檔案上傳、垃圾訊息過濾、AJAX 送出，以及自訂感謝頁，且不需要伺服器端程式碼。對 Backend Development 工作流程，以及需要在建置時偵測表單的 JS 渲染應用程式特別有幫助。
這個技能獲得 78/100，值得收錄：它為表單處理提供了具體且貼近 Netlify 的流程，操作細節也足夠，能比一般提示詞更有效降低試錯成本。目錄使用者可期待一個實用的安裝型技能，能協助實作真實任務；但也要注意，支援生態檔案不夠完整，工作流程上還有幾個空缺。
- 對 Netlify 上的 HTML 表單有清楚的觸發條件與適用範圍，涵蓋聯絡、回饋、檔案上傳與送出等使用情境。
- 操作指引很具體：`data-netlify` 屬性、建置時偵測、自訂成功頁行為、AJAX 送出、垃圾訊息過濾與檔案上傳注意事項都明確提到。
- SKILL.md 內容篇幅充足，且有標題、限制與程式碼範例，對 agent 的直接執行很有幫助。
- 沒有提供安裝指令、支援檔案或參考資料，因此使用者必須完全依賴 `SKILL.md`。
- 內容中有 placeholder 標記，表示雖然整體品質不錯，但部分段落可能仍未完成或仍是範本狀態。
netlify-forms 技能總覽
netlify-forms 是用來做什麼的
netlify-forms 技能可協助你實作 Netlify Forms 來處理 HTML 表單，而不必另外建立自己的伺服器端送出端點。它特別適合聯絡表單、名單收集、意見回饋、簡單檔案上傳，以及其他希望交由 Netlify 收集與分流的表單情境。
誰適合使用
如果你是在 Netlify 上開發，並且想為靜態網站、SSR 應用程式，或以 JavaScript 渲染的表單找到清楚的設定路徑，就適合用這個 netlify-forms 技能。對於 Backend Development 流程而言，它尤其有用，因為目標是在不建立自訂表單基礎架構的前提下，仍維持穩定的送出流程。
實務上最重要的是什麼
真正的決策重點在於表單偵測、正確的表單命名，以及表單是伺服器端渲染還是只會在瀏覽器中出現。當你需要 netlify-forms 的安裝與使用步驟在第一次部署就成功，而不是靠反覆試錯才跑通時，這個技能最有價值。
如何使用 netlify-forms 技能
安裝並限定技能範圍
在你的 skills 工作流程中使用 netlify-forms install 路徑，然後先讀 SKILL.md。這個 repository 很小，而且是獨立封裝的，所以 SKILL.md 是主要來源；沒有 rules/、references/ 或 resources/ 資料夾需要另外查看。
把你的目標轉成有用的提示詞
請明確提供表單目標、框架，以及部署情境。好的輸入像是：「在 Next.js 應用中加入 Netlify 聯絡表單，包含自訂感謝頁與防垃圾訊息保護。」較弱的輸入則像是：「設定表單。」路徑、欄位清單與框架資訊越具體，輸出需要猜測的部分就越少。
先讀會影響輸出品質的部分
先從 Basic Setup 與 JavaScript-Rendered Forms 開始，若你需要非預設行為，再讀 AJAX Submissions 與 Vanilla JavaScript。如果你的應用使用 React、Vue、SvelteKit、Remix、Nuxt 或 Next.js，建置時偵測的說明就是 netlify-forms 指南的關鍵部分。
正確套用工作流程
確認表單有唯一的 name、method="POST"，以及 data-netlify="true"。如果你需要自訂成功頁，請使用像 /thank-you 這樣的路徑，而不是 /thank-you.html。對於以 JavaScript 渲染的表單，請加入可供建置時偵測的靜態 HTML 骨架；否則即使表單在 UI 上看得到，Netlify 也可能完全偵測不到。
netlify-forms 技能 FAQ
這比一般提示詞更好嗎？
是的，當你需要的是會影響正式環境的實作細節時尤其如此：例如 Netlify 如何偵測表單、隱藏的 form-name 是怎麼處理的，以及 JS 渲染應用要怎麼做才算正確。一般提示詞常常會漏掉偵測這個限制，而這正是 netlify-forms 最常見的導入阻礙。
簡單的 HTML 表單也需要這個技能嗎？
如果你只是在 Netlify 上做一個基本聯絡表單，這個技能仍然可以幫你省時間，因為它會直接給你最小可行的標記與成功頁規則。如果你的需求不在 Netlify 主機上，或需要自訂後端邏輯，netlify-forms 很可能就不是合適選擇。
它支援現代框架嗎？
可以，但不能只依賴瀏覽器渲染後的標記。對 React、Vue、SSR 框架，以及其他 client-rendered 架構來說，這個技能之所以重要，是因為它說明了 Netlify 建置偵測所需要的靜態骨架模式。
這對初學者友善嗎？
大致上算友善。語法很簡單，但重點在於理解部署模型。初學者通常只要嚴格照著 netlify-forms 的使用步驟做，並避免以為瀏覽器看得到的表單就一定會被自動偵測，成功速度就會快很多。
如何改善 netlify-forms 技能
補上缺少的部署細節
最好的結果通常來自一開始就把框架、託管設定，以及送出目的地行為講清楚。請一併說明你是否需要 AJAX submission、檔案上傳、防垃圾訊息過濾，或自訂感謝頁路徑，這樣技能才能選對處理方式。
描述表單的精確形狀
列出欄位、驗證需求，以及任何你想收集的隱藏中繼資料。例如，「name、email、company、message、email 必填、可選檔案上傳」就比「聯絡表單」更有操作性，因為它能讓技能產出更好的標記與更清楚的 Netlify 專屬指引。
注意常見失敗模式
最常見的錯誤包括少了 data-netlify="true"、表單名稱重複、JS 渲染表單缺少靜態偵測、以及成功頁路徑連錯。若第一次輸出失敗，先檢查這些地方，再考慮整個表單流程要不要重寫。
用建置與送出結果持續迭代
第一次產出後，請實際測試部署、確認表單是否出現在 Netlify，並記下任何缺漏欄位或路由問題。接著把精確失敗狀況回填到 netlify-forms 提示詞裡，例如「正式環境沒有偵測到表單」或「AJAX 送出在本機可行但部署後失敗」，這樣下一輪輸出才會更有針對性。