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 金鑰或內部網址
- 更新也透過這個工具進行 ― 規則變更時重新填寫表單並重新產生，就能讓六個檔案保持同步
總結
- AI 編碼工具各自讀取不同的規則檔案，手動維護容易產生複製貼上的落差
- 以 AGENTS.md 為標準衍生產生，能讓規則在各工具間保持一致
- 該寫的是「驗證指令、專案專屬規範、禁止事項」這類難以從程式碼讀出的知識
如果您同時使用多種 AI 工具，不妨先用 AI 規則產生器 一次備齊整套規則檔案。