Tools mentioned in this article
Open the browser-based tool while you read and try the workflow immediately.
Claude Code、Cursor、GitHub Copilot、Windsurf、Gemini CLI ― AI 編碼工具越用越多，最頭痛的就是「專案規則該寫在哪個檔案」的問題。AI 規則產生器 只要填一次表單，就能一口氣產生六種主要工具的規則檔案，完全在瀏覽器內完成。
每個工具規則檔案都不一樣的問題
AI 編碼工具會各自從不同的檔案讀取專案規範。
| 工具 | 讀取的檔案 |
|---|---|
| OpenAI Codex／Google Jules 等 | AGENTS.md |
| Claude Code | CLAUDE.md |
| Cursor | .cursor/rules/*.mdc |
| GitHub Copilot | .github/copilot-instructions.md |
| Windsurf | .windsurfrules |
| Gemini CLI | GEMINI.md |
團隊成員使用的工具不同時，同樣內容的規則就得複製貼上到好幾個檔案裡。幾週後，就會發生「只有 CLAUDE.md 更新了，Cursor 的規則還停留在舊版本」這種常見事故。
以 AGENTS.md 為「唯一標準」的設計
對這個問題比較務實的解法，是從單一標準（Single Source of Truth）衍生出各工具專用的檔案。
適合作為標準的正是 AGENTS.md。這是一份用來向 AI 編碼代理說明專案的開放標準檔案，可以視為「AI 代理版的 README」，包括 OpenAI Codex 與 Google Jules 在內，越來越多工具正在支援它。
這個工具也遵循同樣的設計：先從表單輸入組出 AGENTS.md，其餘五個檔案再由它衍生而來。CLAUDE.md、copilot-instructions.md、.windsurfrules、GEMINI.md 直接共用同一份內容，只有 Cursor 用的 .mdc 會在開頭加上 MDC 格式的 frontmatter（description 與 alwaysApply: true）。由於內容在所有檔案間永遠一致，結構上就不會出現複製貼上造成的落差。
使用方法
- 開啟 AI 規則產生器，在表單中輸入：
- 專案名稱／概要 ― AI 最先讀到的前提資訊
- 技術堆疊 ― 用逗號或換行分隔（例如
TypeScript, React, Vite） - 指令 ― 開發伺服器、建置、測試、lint 的執行指令
- 程式碼規範／禁止事項 ― 每行一項條列
- 目錄結構／補充說明 ― 視需要填寫（空白欄位會自動從輸出中省略）
- 選擇輸出語言（英文／日文），點擊「產生規則檔案」。
- 六個檔案會以分頁顯示，可以個別複製，也可以用「ZIP 一次下載」保存。ZIP 內已經包含
.cursor/rules/與.github/的目錄結構，只要在儲存庫根目錄解壓縮即可完成配置。
產生過程完全在瀏覽器內以 JavaScript 完成，輸入的專案資訊不會傳送到伺服器。
規則檔案該寫什麼
要提升 AI 代理建議的準確度，效果最大的是這類「從程式碼難以讀出的知識」：
- 驗證指令 ― 測試、lint、建置的執行方式，讓 AI 能自行驗證變更
- 專案專屬規範 ― 例如「只用函式元件」「日期一律用 dayjs 處理」等既有程式碼的慣例
- 禁止事項 ― 「不使用 any」「不修改自動生成的檔案」「不將
.env提交進版本控制」等明確寫下不希望發生的事
反過來說，只要看程式碼就能知道的資訊（檔案列表、函式說明等）不需要長篇大論。規則太長反而會讓重要指示被埋沒，建議先把上述三類內容簡潔整理好。
使用上的小建議
- 把產生結果當成範本 ― 由團隊審閱，依實際狀況增刪修改
- 已有既存檔案時採差異合併 ― 若已經在使用 CLAUDE.md 等檔案，不要直接覆蓋，先確認差異再整合
- 不要寫入機密資訊 ― 規則檔案會被提交進版本庫，請勿寫入 API 金鑰或內部網址
- 更新也透過這個工具進行 ― 規則變更時重新填寫表單並重新產生，就能讓六個檔案保持同步
常見問題
為什麼要產生內容相同的多個檔案？
因為每個代理程式讀取的檔名不同。Claude Code 讀 CLAUDE.md、Cursor 讀 .cursor/rules/、GitHub Copilot 讀 .github/copilot-instructions.md、Windsurf 讀 .windsurfrules、Gemini CLI 讀 GEMINI.md。內容可以一致，因此本工具把 AGENTS.md 當作唯一的真實來源，再由它衍生出其他檔案。
為什麼只有 Cursor 的檔案開頭多了幾行？
因為 Cursor 的 .mdc 格式需要 frontmatter。產生的區塊包含三個欄位：description（這條規則是什麼）、globs（要套用到哪些檔案樣式）與 alwaysApply: true。若只想套用到特定目錄，產生後在 globs 補上樣式即可；留空則會全域套用。
規則變更後需要重新產生所有檔案嗎？
需要，但不必手動修改六個地方。最不容易出錯的做法是只把 AGENTS.md 當作正本來維護，一有變更就用本工具重新產生其餘檔案。一旦開始直接編輯衍生檔案，就會分不清哪一份才是最新的。
輸出該用英文還是中文？
代理程式兩者都看得懂，因此實務上建議與儲存庫其他文件的語言一致。如果註解與 README 是英文，就用英文。規則中寫下的專有名稱（指令名稱、目錄路徑）不論用哪種語言都會原樣傳達。
輸入的內容會被傳送嗎？
不會。AI 編碼規則產生器 完全在瀏覽器內處理，即使輸入尚未公開的專案結構或公司內部規範，也不會傳送到外部。
總結
- AI 編碼工具各自讀取不同的規則檔案，手動維護容易產生複製貼上的落差
- 以 AGENTS.md 為標準衍生產生，能讓規則在各工具間保持一致
- 該寫的是「驗證指令、專案專屬規範、禁止事項」這類難以從程式碼讀出的知識
如果您同時使用多種 AI 工具，不妨先用 AI 規則產生器 一次備齊整套規則檔案。