Cursor 免費 Discord.js v14 規則：避免 AI 代理生成過時程式碼

聲明：我經營 AgentCartridge，該公司銷售付費規則包和付費 Discord 機器人套件。此規則檔案是免費的，無需註冊，頁面下方也連結到付費套件。

AI 代理在編寫 Discord.js 程式碼時，經常會參考舊的教學內容。在 14.27 版本中，大部分舊程式碼仍然可以編譯，因此很容易被忽略。我整理了一個規則檔案，告訴 AI 代理目前正確的語法形式。

這些規則涵蓋了以下內容：reply({ ephemeral: true }) 應改為 reply({ flags: MessageFlags.Ephemeral })（ephemeral 已被標記為棄用）；reply({ fetchReply: true }) 應改為 reply({ withResponse: true })（訊息隨後會是 response.resource?.message）；client.once("ready", ...) 應改為 client.once(Events.ClientReady, ...)（"ready" 事件名稱已棄用，新名稱為 "clientReady"）；.setDMPermission(false) 應改為 .setContexts(InteractionContextType.Guild)。

此外，規則也包含 v13 中已不存在於 v14 的名稱，例如 MessageEmbed 應改為 EmbedBuilder，Intents.FLAGS 應改為 GatewayIntentBits，以及 MessageActionRow / MessageButton 應改為 ActionRowBuilder / ButtonBuilder。

它還包含了 Discord 的限制，例如：在 3 秒內回覆、延遲回覆或進行其他首次回應（否則會出現「應用程式未回應」）；15 分鐘的互動令牌；25 個自動完成選項；2000 字元的訊息限制；以及特權意圖（MessageContent、GuildMembers、GuildPresences）。

同時也包含了一些安全規則：令牌只能來自環境變數，以及針對使用者輸入文字的 allowedMentions: { parse: [] }。

設定方法：將其儲存為 .cursor/rules/discordjs-v14.mdc 檔案（它適用於 .ts 和 .js 檔案）。相同的內容也可以直接貼到 CLAUDE.md 或 AGENTS.md 中。然後，要求 AI 代理檢查您現有的指令是否符合這些規則。完整的檔案可以在頁面上直接複製。如果某條規則不適用於您的設定或過於嚴格，請讓我知道，我會進行修正。