# 兩個編輯器共用一個倉庫，誰先把規則搞砸？ Cursor 和 VS Code 選一個的日子過去了。2026 年 10 月 12 日，Cursor 把付費方… · @swordBluesy · TwKit

@swordBluesy

# 兩個編輯器共用一個倉庫，誰先把規則搞砸？ Cursor 和 VS Code 選一個的日子過去了。2026 年 10 月 12 日，Cursor 把付費方案併入 The X Subscription：Free 0 美元、Plus 8 美元、Premium 30 美元、Super 100 美元、Ultra 200 美元一個月；VS Code 仍然免費，GitHub Copilot 維持自己的點數制。很多開發者現在兩個編輯器都裝著，同一個倉庫看任務隨手開一個。 這個習慣會悄悄壞掉：一個編輯器遵守你的程式規範，另一個無視；測試任務只存在一邊；有人提交了個人主題，diff 噪音就開始了。這篇教程修的是倉庫這一側的問題，13 步、大約 50 分鐘，Node 20 環境，全部用免費方案就能跑完。 ## 一、三層地圖：先決定什麼放哪裡 雙編輯器倉庫能運作，靠三層分工。共用層放所有 Agent 都必須遵守的規則；編輯器層放只有某個編輯器懂的檔案；個人層放你的品味，永遠不進 Git。 | 檔案 | 用途 | Cursor | VS Code＋Copilot | 進 Git？ | | --- | --- | --- | --- | --- | | `AGENTS.md` | 全專案指令 | 讀取（依社群文件） | 列為支援工具，需驗證 | 是 | | `src/AGENTS.md` | 資料夾範圍規則，就近原則 | 同上 | 同上 | 是 | | `.cursor/rules/*.mdc` | Cursor 專屬規則，依檔案 glob 觸發 | 原生 | 忽略 | 是 | | `.github/copilot-instructions.md` | Copilot 倉庫指令，這裡只放指針 | 非原生格式 | 原生 | 是 | | `.vscode/settings.json` | 工作區設定 | 讀取（VS Code 分支） | 原生 | 是 | | `.vscode/extensions.json` | 推薦擴充 | 會提示 | 會提示 | 是 | | `.vscode/mcp.json` | VS Code 的 MCP 伺服器 | 忽略 | 原生 | 是，不含密鑰 | | `.cursor/mcp.json` | Cursor 的 MCP 伺服器 | 原生 | 忽略 | 是，不含密鑰 | | `*.code-workspace`、`~/.cursor`、使用者設定 | 個人狀態 | — | — | 否 | 設計規則很簡單：每條指令寫一次，放在能觸及所有工具的最低層；只有真正只屬於某個編輯器的指令，才往上移到該編輯器自己的檔案。還有一句醜話先說在前面：官方文件並不保證共用 `AGENTS.md` 在兩個編輯器裡行為完全一致，後面的金絲雀測試就是為這個準備的。 ## 二、價格先算清：指令檔案的長度就是帳單 VS Code 本體免費，錢花在 AI 層。Cursor 新方案：Free 0 美元、Plus 8 美元（與 Grok 產品共用用量池）、Premium 30 美元（舊 Pro 20 美元的最近替代品，第三方模型另按 API 計價）、Super 100 美元、Ultra 200 美元。Copilot：Free 0 美元（每月 2000 次補全）、Pro 10 美元（補全無限、每月 15 美元額度）、Pro+ 39 美元（高級模型含 Opus、每月 70 美元額度）、Business 每人 19 美元（彙總額度、每人 1900 點）。 Copilot 從 2026 年 6 月 1 日起按用量計費，1 點等於 0.01 美元，程式碼補全本身無限且不計費。實務含義是：一份 600 行的規則檔案，是每個任務都要付的稅；一份 40 行的，就不是。本教程整套設定用免費方案就能跑，付費後每個讀取指令檔案的 Agent 會話都會消耗 token，不管是 Copilot 點數還是 Cursor 預付額度。 ## 三、步驟 1 到 2：建倉庫和基線專案 專案故意做得很無聊——一個把標題轉成網址 slug 的小 ESM 函式庫，因為有趣的部分是周圍的設定： ```bash mkdir dual-editor-repo && cd dual-editor-repo git init -b main mkdir -p src scripts .cursor/rules .github/workflows .vscode .githooks ``` `package.json` 設 `"type": "module"`，腳本三個：`start` 跑示範、`test` 跑 Node 內建測試、`check:editors` 跑漂移檢查，`engines` 要求 Node 20 以上。用 Node 內建測試器，依賴數就是零，這對後面指令檔案裡「不要新增執行期依賴」那條規則很重要。 核心函數 `slugify` 把「Cursor vs VS Code」變成 `cursor-vs-vs-code`，把「 Café, déjà vu! 」變成 `cafe-deja-vu`，純符號回傳空字串。三個測試全通過、兩個示範 slug 都對，才算基線成立。測試失敗先查 Node 是不是 20 以上，因為專案用 ES 模組和內建測試器。 ## 四、步驟 3 到 4：寫共用的 AGENTS.md 根目錄的 `AGENTS.md` 是你希望每個 Agent 都遵守的檔案，寫給第一天加入的新隊友看的東西：專案是什麼、怎麼安裝、跑、測試、風格是什麼、絕對不要碰什麼、什麼叫完成。保持在 150 行以下，範例只有 28 行： ```markdown # AGENTS.md Shared instructions for every AI coding agent that works in this repository. Cursor, GitHub Copilot in VS Code and Codex all read this file. Keep it short. ## Project A tiny Node.js 20+ ESM library that turns titles into URL slugs. Source lives in `src/`. Helper scripts live in `scripts/`. ## Commands - Install: `npm install` - Run the demo: `npm start` - Run tests: `npm test` - Check editor config for drift: `npm run check:editors` ## Conventions - Use ES modules only. No CommonJS `require`. - Two-space indentation, double quotes, semicolons. - Every exported function gets a test next to it in `src/*.test.js`. - Do not add runtime dependencies without asking first. ## Boundaries - Never edit `package-lock.json` by hand. - Never commit secrets, tokens or `.env` files. - Do not touch files under `.github/workflows/` unless the task says so. ## Done means `npm test` and `npm run check:editors` both exit with code 0. ``` 結構有講究：指令區用反引號包住精確字串，後面的漂移腳本會檢查裡面提到的每個 `npm run` 指令是不是真的存在於 `package.json`，這就把一篇散文變成了機器能幫你守真的檔案。邊界區故意寫得很短，Agent 對幾條硬限制的遵守程度，遠勝於一頁軟偏好。慣例區要描述倉庫實際的樣子，不是你希望的樣子。 資料夾範圍的 `src/AGENTS.md` 同理：就近原則，Agent 在某個資料夾工作時用離它最近的那份。 ## 五、步驟 5 到 10：編輯器專屬檔案與漂移檢查 這一段做 20 分鐘左右：Cursor 的 `.cursor/rules/*.mdc`（用 frontmatter 的 glob 決定觸發範圍）、Copilot 的 `.github/copilot-instructions.md`（這裡只放指向共用檔案的指針，避免兩份規則打架）、共用的 `.vscode/settings.json` 與 `extensions.json`、兩份不含密鑰的 MCP 設定（`.vscode/mcp.json` 給 VS Code、`.cursor/mcp.json` 給 Cursor，各自的編輯器會忽略對方的那份）。 漂移檢查腳本 `scripts/check-editor-drift.mjs` 是整套設定裡最值錢的小東西：它讀 `AGENTS.md` 裡提到的指令，對照 `package.json` 的腳本表，缺一個就報錯。規則檔案一旦和倉庫現實脫節，檢查就會先於人類發現。 ## 六、步驟 11 到 13：pre-commit、CI 與金絲雀測試 最後 15 分鐘：pre-commit hook 在提交前跑測試和漂移檢查，CI 任務在遠端再跑一次，兩道門攔住「本地能跑、別人機器上不行」的提交。 金絲雀測試只要兩分鐘，卻是整篇的靈魂：在兩個編輯器裡各問 Agent 同一個問題，看它是不是都遵守了共用規則。官方文件沒保證兩個編輯器行為一致，社群文件說 Cursor 讀、VS Code 列為支援工具——信文件不如信實測。金絲雀沒通過，就不要假裝共用層真的共用了。 ## S1哥觀點 雙編輯器最大的謊言，是「反正都是 VS Code 底子，規則一定通用」。底子一樣，讀規則的腦子不一樣，計費的方式更不一樣。一份 600 行的規則檔案，在免費方案裡只是囉嗦，在付費方案裡是每個任務都在燒的稅。規則檔案的正確長度，不是寫得越全越好，是短到 Agent 每次都願意讀完。問題留給你：你的 AGENTS.md，Agent 是真的在讀，還是只是放在那裡讓你安心？金絲雀測試兩分鐘就能告訴你答案，你敢跑嗎？ 原文連結：https://tech-insider.org/cursor-vs-vscode-one-repo-shared-ai-rules-2026/ 原文：@Tech Insider（由 S1哥 編譯）

曝光 315 · 评论 1 · 点赞 2 · 书签 1