把技術棧規則寫進 AGENTS.md / CLAUDE.md（改寫自 awesome-cursorrules）

你的 AI 助手每次都用「網路平均寫法」生碼，不照你的框架版本與團隊慣例？把技術棧規則寫成一份規則檔，從此每次都對齊。CC0 授權、最自由可商用。

[ 登入後可看完整內容 ]

**這是什麼／解決什麼痛點** AI 編碼助手（Cursor、Claude Code、Codex）預設用「網路上的平均寫法」生程式碼：它不知道你用 Next.js 15 還是 13、用 Tailwind 還是 styled-components、團隊是否禁用 `any`、檔案命名要 kebab-case 還是 camelCase。結果就是每次都要在 review 時把它「拉回」你的慣例。解法是把這些慣例一次寫成一份專案規則檔——Cursor 叫 `.cursor/rules/*.mdc`，Claude Code 叫 `CLAUDE.md`，Codex 叫 `AGENTS.md`——助手每次開工都先讀它，產出自然對齊。 **為什麼這個來源值得用** PatrickJS 的 awesome-cursorrules 是這個領域的指標倉庫（約 4 萬星、CC0 公共領域授權），整理了 13+ 大類、上百個技術棧的規則範例：前端框架（React / Next.js / Vue / Angular / Svelte / Astro / Solid / Qwik）、後端（Node / FastAPI / Django / Go / Spring / Laravel / Rails / Deno）、行動端（React Native / Flutter / SwiftUI / Android）、樣式（Tailwind / shadcn/ui / Chakra）、狀態管理（Redux / Zustand / Pinia / TanStack Query）、測試（Cypress / Playwright / Jest / Vitest）、部署（Vercel / Netlify / Cloudflare）等。它的價值不在「複製某個檔案」，而在示範了一份好規則該涵蓋哪些面向。CC0 是最自由的授權，內容可任意商用、改寫、再散布，零限制。 **怎麼用（步驟）** 1. 確認你的助手吃哪個檔名：Cursor → `.cursor/rules/<stack>.mdc`（帶 frontmatter：`description` / `globs` 指定套用的檔案模式如 `**/*.tsx` / `alwaysApply`）；Claude Code → 專案根的 `CLAUDE.md`；Codex → `AGENTS.md`。 2. 用下方 `full_prompt` 範本當骨架，把 `{{...}}` 填成你專案的真實值（框架版本、語言、樣式方案、測試工具、命名規則、禁用清單）。 3. 規則要「可驗證、具體」：寫「禁用 `any`，改用 `unknown` + 型別守衛」比寫「請寫好的型別」有用一百倍。 4. 提交進 git，全團隊（含每個 AI session）共用同一份規則，對齊所有貢獻者。 **何時用** 任何有固定技術棧、且你發現自己一直在 review 時糾正 AI 同樣幾件事的專案。一次寫好、長期受益。 📎 來源：PatrickJS/awesome-cursorrules（作者 PatrickJS，CC0 公共領域授權）— 本篇為繁中改寫整理，原始倉庫與各技術棧規則範例見上方連結。