EtienneLescot/n8n-as-code

解決的問題

n8n-as-code 提供以開發者為中心的工作流程，用於管理 n8n 自動化。它將 n8n 開發從純視覺介面轉換為基於程式碼的環境，支援版本控制（GitOps）、環境推移（開發 → 生產），並允許使用 AI 代理在有根據的上下文中安全地建構與編輯工作流程。

如何運作

此專案將 n8n 的 JSON 基礎工作流程轉換為易讀的 TypeScript 檔案（.workflow.ts），方便人類與 AI 代理進行修改。它提供 CLI（n8nac）與 VS Code/Cursor 延伸模組，可將這些檔案與 n8n 環境同步、驗證，並透過 n8n-manager 管理本地 n8n 實例。為支援 AI 代理，專案提供「技能」層，包含節點模式、文件與驗證規則，讓代理能產生精確的工作流程。

適用對象

使用 n8n 並希望在首選程式碼編輯器中應用 GitOps、環境管理、AI 輔助開發等軟體工程最佳實務的開發者與自動化工程師。

主要亮點

• GitOps 同步：明確地從版本控制拉取與推送工作流程，審查差異，解決衝突。
• TypeScript 編寫：將工作流程轉換為 TypeScript，提升可讀性與可編輯性。
• 代理就緒的上下文：提供基於事實的知識（模式、範例），讓 AI 代理能安全地產生與編輯工作流程。
• 環境推移：將工作流程從一個環境（例如開發）推移到生產環境，自動重新映射憑證與參考。
• 整合工具鏈：包含 VS Code 延伸模組、CLI 工具，以及適用於 Claude Code 等代理的專用技能。