Rulesync:從統一規則檔案產生多種 AI 編碼工具設定
Rulesync 是一個開發人員工具 CLI,可同步 AI 代理規則集、命令範本、MCP 設置,並透過本機和團隊工作流程的選擇性匯入/匯出流忽略文件。
秒懂
- 它是什麼?
- 一個 Node.js CLI,將統一的 AI 規則檔案轉換為數十種 AI 編碼代理的逐工具設定。
- 適合誰用?
- Rulesync 為許多 AI 工具集中管理規則,提供了棄用功能的明確路徑和廣泛的功能矩陣。 採用前請先依照 README 中的具體命令與檔案驗證,並把未說明的部分視為未知。
- 可以商用嗎?
- 可以。MIT 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
- 還在維護嗎?
- 有在維護。儲存庫最近一次提交在 1 天前。
- 用什麼語言寫的?
- 主要是 TypeScript(依據 GitHub 的語言統計)。
以上回答依據專案的 GitHub 資料(最近同步於 2026年9月14日)與我們的分析,不構成法律意見。
開源專案深度解析
一個規則來源,多種工具設定
Rulesync 是一個 Node.js 命令列工具,它從統一的 AI 規則檔案產生多種 AI 開發工具的設定檔。該專案將自身描述為用於 AI 編碼代理的實用程式 CLI。產生的輸出涵蓋規則、指令、MCP 伺服器、忽略檔案、子代理和技能,具體取決於給定工具支援的內容。該 CLI 還支援選擇性產生,因此你可以選擇要寫出的工具和功能。它不會發明新格式,而是將中心規則集對應到每個工具的預期佈局中。
在 dyoshikawa/rulesync 的第 1 個檢查面向,應把專案名稱、README 提到的具體入口與可觀察結果放在一起理解。先確認目前分支 main 的檔案位置,再依文件中的命令或範例執行;若輸入格式、作業系統、編譯器、供應商服務或憑證條件不同,結果就不能直接互相比較。記錄成功輸出、錯誤訊息和程序是否正常結束,才能分辨是功能限制、環境差異還是文件未涵蓋的情況。這個步驟針對 rulesync 本身,不代表 README 對未描述的使用場景作出保證。還要把實際使用的版本、設定值和輸入樣本留下,否則之後無法說明同一個命令為何得到不同輸出。對照輸入與輸出時,應特別查看專案列出的檔案名稱、參數名稱、佇列或資料欄位,並把可重現的差異寫下來。若 README 沒有描述錯誤處理、併發順序或平台支援,就只能記錄觀察結果,不能補成保證。
透過 npm、Homebrew 或指令碼安裝
README 記錄了三種安裝方式。第一種是全域 npm 安裝:npm install -g rulesync。第二種是適用於 macOS 和 Linux 的 Homebrew tap:brew tap dyoshikawa/rulesync https://github.com/dyoshikawa/rulesync,然後 brew install rulesync。README 指出,該 tap 位於此儲存庫中,並且沒有 homebrew- 前置詞,因此必須使用兩個參數的 tap 形式;未經 tap 直接使用簡寫安裝是不起作用的。第三種方式是透過 curl -fsSL https://github.com/dyoshikawa/rulesync/releases/latest/download/install.sh | bash 進行單一二進位安裝。README 指向文件站點以取得手動安裝和特定平台的說明,但本身未詳述這些步驟。
在 dyoshikawa/rulesync 的第 2 個檢查面向,應把專案名稱、README 提到的具體入口與可觀察結果放在一起理解。先確認目前分支 main 的檔案位置,再依文件中的命令或範例執行;若輸入格式、作業系統、編譯器、供應商服務或憑證條件不同,結果就不能直接互相比較。記錄成功輸出、錯誤訊息和程序是否正常結束,才能分辨是功能限制、環境差異還是文件未涵蓋的情況。這個步驟針對 rulesync 本身,不代表 README 對未描述的使用場景作出保證。還要把實際使用的版本、設定值和輸入樣本留下,否則之後無法說明同一個命令為何得到不同輸出。對照輸入與輸出時,應特別查看專案列出的檔案名稱、參數名稱、佇列或資料欄位,並把可重現的差異寫下來。若 README 沒有描述錯誤處理、併發順序或平台支援,就只能記錄觀察結果,不能補成保證。
初始指令:init、fetch、generate
快速入門顯示三個指令。rulesync init 建立必要的目錄、範例規則檔案和設定檔。rulesync fetch dyoshikawa/rulesync 安裝官方技能(README 推薦這樣做)。rulesync generate --targets "*" --features "*" 產生具有所有功能的統一設定。對於已經擁有工具設定的使用者,CLI 提供匯入指令,例如 rulesync import --targets claudecode(來自 CLAUDE.md)、--targets cursor(來自 .cursorrules)和 --targets copilot(來自 .github/copilot-instructions.md)。還有一個轉換指令,可以直接將一個工具的設定對應到另一個工具,而無需寫入 .rulesync/ 檔案,如 rulesync convert --from cursor --to copilot,claudecode 所示。README 指向快速入門指南以取得更多詳細資訊,但沒有複製它。
在 dyoshikawa/rulesync 的第 3 個檢查面向,應把專案名稱、README 提到的具體入口與可觀察結果放在一起理解。先確認目前分支 main 的檔案位置,再依文件中的命令或範例執行;若輸入格式、作業系統、編譯器、供應商服務或憑證條件不同,結果就不能直接互相比較。記錄成功輸出、錯誤訊息和程序是否正常結束,才能分辨是功能限制、環境差異還是文件未涵蓋的情況。這個步驟針對 rulesync 本身,不代表 README 對未描述的使用場景作出保證。還要把實際使用的版本、設定值和輸入樣本留下,否則之後無法說明同一個命令為何得到不同輸出。對照輸入與輸出時,應特別查看專案列出的檔案名稱、參數名稱、佇列或資料欄位,並把可重現的差異寫下來。若 README 沒有描述錯誤處理、併發順序或平台支援,就只能記錄觀察結果,不能補成保證。
工具支援矩陣
README 包含一個 AI 編碼工具及其支援功能的表格。這些功能是規則、忽略、MCP、指令、子代理、技能、鉤子、權限和檢查。該表顯示,例如,Claude Code 支援全部九項,而 Replit 僅支援規則和技能。README 指出,勾選標記表示該功能至少支援一種模式(專案、全域或模擬),並以 Codex CLI 指令作為僅全域的範例。還列出了兩個開放標準:AGENTS.md 和 AgentsSkills。完整的模式細分和每個工具的 targets 值位於文件站點,而不在 README 中。
在 dyoshikawa/rulesync 的第 4 個檢查面向,應把專案名稱、README 提到的具體入口與可觀察結果放在一起理解。先確認目前分支 main 的檔案位置,再依文件中的命令或範例執行;若輸入格式、作業系統、編譯器、供應商服務或憑證條件不同,結果就不能直接互相比較。記錄成功輸出、錯誤訊息和程序是否正常結束,才能分辨是功能限制、環境差異還是文件未涵蓋的情況。這個步驟針對 rulesync 本身,不代表 README 對未描述的使用場景作出保證。還要把實際使用的版本、設定值和輸入樣本留下,否則之後無法說明同一個命令為何得到不同輸出。對照輸入與輸出時,應特別查看專案列出的檔案名稱、參數名稱、佇列或資料欄位,並把可重現的差異寫下來。若 README 沒有描述錯誤處理、併發順序或平台支援,就只能記錄觀察結果,不能補成保證。
棄用和目標拆分
README 記錄了三條棄用說明。ignore 功能已被更富表現力的 permissions 功能取代,但現有的 ignore 設定在 Rulesync 14.x 中仍然受支援,並且移除不會在未來的重大版本之前發生。新的 init 專案會建立 permissions,而不建立忽略檔案。Google Antigravity 被拆分為 antigravity-ide 和 antigravity-cli,因為 Antigravity 2.0 具有獨立的全域設定樹;兩者都將根規則作為專案根目錄中的純 AGENTS.md 輸出。外掛程式打包目標 claudecode-plugin 和 antigravity-plugin 會將元件寫入現有的外掛程式目錄,並從 --targets "*" 中排除。Kiro 目標被拆分為 kiro-cli 和 kiro-ide,因為 IDE 和 CLI 使用不同的設定格式;舊的 kiro 別名保持不變,行為不變。
在 dyoshikawa/rulesync 的第 5 個檢查面向,應把專案名稱、README 提到的具體入口與可觀察結果放在一起理解。先確認目前分支 main 的檔案位置,再依文件中的命令或範例執行;若輸入格式、作業系統、編譯器、供應商服務或憑證條件不同,結果就不能直接互相比較。記錄成功輸出、錯誤訊息和程序是否正常結束,才能分辨是功能限制、環境差異還是文件未涵蓋的情況。這個步驟針對 rulesync 本身,不代表 README 對未描述的使用場景作出保證。還要把實際使用的版本、設定值和輸入樣本留下,否則之後無法說明同一個命令為何得到不同輸出。對照輸入與輸出時,應特別查看專案列出的檔案名稱、參數名稱、佇列或資料欄位,並把可重現的差異寫下來。若 README 沒有描述錯誤處理、併發順序或平台支援,就只能記錄觀察結果,不能補成保證。
文件與 MIT 授權
README 連結到文件站點 https://dyoshikawa.github.io/rulesync/ 和 npm 套件頁面。它說明完整文件涵蓋設定、CLI 參考、檔案格式和程式化 API。授權是 MIT,版權所有 2024 dyoshikawa。授權文字授予使用、複製、修改、合併、發布、分發、再授權和銷售軟體副本的權利,並說明軟體按"原樣"提供,不提供任何形式的保證。授權未涉及支援、安全或維護義務。儲存庫後設資料顯示在撰寫本文時有 1,286 個星標、142 個復刻和 29 個未解決問題,但 README 本身並未提及這些數字。
在 dyoshikawa/rulesync 的第 6 個檢查面向,應把專案名稱、README 提到的具體入口與可觀察結果放在一起理解。先確認目前分支 main 的檔案位置,再依文件中的命令或範例執行;若輸入格式、作業系統、編譯器、供應商服務或憑證條件不同,結果就不能直接互相比較。記錄成功輸出、錯誤訊息和程序是否正常結束,才能分辨是功能限制、環境差異還是文件未涵蓋的情況。這個步驟針對 rulesync 本身,不代表 README 對未描述的使用場景作出保證。還要把實際使用的版本、設定值和輸入樣本留下,否則之後無法說明同一個命令為何得到不同輸出。對照輸入與輸出時,應特別查看專案列出的檔案名稱、參數名稱、佇列或資料欄位,並把可重現的差異寫下來。若 README 沒有描述錯誤處理、併發順序或平台支援,就只能記錄觀察結果,不能補成保證。
編輯結論
Rulesync 為許多 AI 工具集中管理規則,提供了棄用功能的明確路徑和廣泛的功能矩陣。 採用前請先依照 README 中的具體命令與檔案驗證,並把未說明的部分視為未知。
社群筆記