Vibe Kanban 如何為倉庫配置 Setup 腳本讓代理啟動前自動安裝依賴并準備環境【免費下載鏈接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent項目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban在 Vibe Kanban 中每次代理執行任務都會運行在一個新建的 git worktree 里這個隔離環境里通常不包含你本地倉庫的依賴、.env和配置文件。如果什么都不配代理需要自己摸索“還沒裝依賴”這件事既慢又不可靠。Vibe Kanban 提供了 Setup 腳本在倉庫級別配置一組命令代理啟動前自動在倉庫根目錄執行用于安裝依賴、準備構建產物或初始化環境。本文說明如何為倉庫配置 Setup 腳本、配置后如何驗證它確實運行了以及腳本失敗時按文檔排查的順序。為什么需要 Setup 腳本文檔給出的使用動機有三個見 Projects Repositories安裝依賴確保所有包在代理改代碼之前已經裝好構建前置產物編譯共享庫或生成代理需要的文件環境準備初始化數據庫、拉取 Docker 鏡像、配置服務。Creating Projects 進一步解釋了必要性每次代理執行都在 git worktree 中運行而 worktree 里“不太可能”包含你的依賴、配置和.env。用 Setup 腳本例如npm install或cargo build提前跑一遍代理就不需要自己發現這些命令沒執行過。配置入口Settings 中的 Repositories 標簽頁按 Projects Repositories 的說明操作從 Workspaces 導航欄打開Settings選擇Repositories標簽頁從下拉框中選擇要配置的倉庫。該頁面除了Display Name倉庫顯示名和Repository Path倉庫本地路徑外還有 Scripts Configuration 區域用來配置這個倉庫的 dev server、setup、cleanup 三類腳本。這些腳本在該倉庫被任何 workspace 使用時都會生效。創建項目后也可以通過項目卡片右上角的設置按鈕進入同樣的項目級腳本配置見 Creating Projects。填寫 Setup 腳本在 Setup Script 一欄填入代理啟動前要執行的命令。Setup 腳本的語義是在編碼代理開始工作之前運行用于準備開發環境。文檔給出的示例按語言/包管理器選擇其一即可# Node.js 項目 npm install # Python 項目 pip install -r requirements.txt # 多條命令用 串聯 npm install npm run build:deps # Rust 項目 cargo fetch如果倉庫需要本地環境文件可以在同一設置頁配置Copy Files一個逗號分隔的文件列表從原項目目錄復制到 worktree。文檔說明這些文件在 worktree 創建之后、Setup 腳本運行之前被復制適合.env、配置文件和本地設置這類環境相關文件。注意文檔的警告這些文件必須被 gitignore否則可能被提交進代碼庫。配置前先在終端里手動跑一遍腳本。Projects Repositories 的最佳實踐明確要求在 Vibe Kanban 里配置之前先手動運行腳本確認它能正常工作。執行時機工作區創建時自動運行配置完成后不需要手動觸發。按 Creating Workspaces 的描述創建工作區時會依次發生創建 git worktree獨立工作目錄和分支原倉庫不受影響基于目標分支如main自動創建工作分支初始化編碼代理會話如果倉庫配置了 Setup 腳本自動運行以準備環境。Monitoring Task Execution 描述的任務執行順序與此一致Git worktree 創建 → Setup 腳本運行 → 代理開始處理任務。Setup 腳本在倉庫根目錄執行Projects Repositories 特別指出它在 workspace 啟動時執行一次而不是每條代理消息都執行。工作區創建流程點按鈕或Cmd/Ctrl K選New Workspace本身不涉及腳本配置選中配好 Setup 腳本的倉庫后腳本會在啟動時自動跑完代理才開始干活。驗證腳本確實運行了文檔提供了三種檢查方式看日志Monitoring Task Execution 說明任務開始后你看到的第一條日志就是 Setup 腳本在運行如果配置了的話它安裝依賴、準備環境然后代理才開始工作。日志里能看到腳本執行的實時輸出。手動重跑Workspaces 界面提供R S組合鍵直接執行 Setup 腳本R C執行 cleanup 腳本見 Keyboard Shortcuts。在 workspace 里按R S可以單獨重跑一次腳本來確認行為。View Processes點界面右上角的三點圖標選View Processes可以看到運行中和已完成的進程及各自的輸出日志包括構建類腳本。如果用的是 Web 應用Testing Your Application 提醒配置 dev server 腳本前通常也需要配置 Setup 腳本如npm install否則開發服務器啟動時缺少依賴這個配置同樣放在項目設置的 Setup Scripts 中。腳本失敗時按文檔排查Creating Workspaces 的故障排查部分列出了 Setup 腳本失敗的三類可能原因和對應處理可能原因處理腳本本身有錯誤先在終端手動測試腳本缺少依賴先在終端手動測試腳本工作目錄不對確保腳本中的路徑相對于倉庫根目錄同時查看Logs 面板里的錯誤信息定位具體失敗位置。這與腳本配置頁的最佳實踐呼應腳本從倉庫根目錄運行應使用相對路徑或環境變量不要寫死絕對路徑。寫腳本時的三條建議同樣來自 Projects Repositories保持腳本快速耗時過長的 Setup 會拖慢 workspace 啟動依賴安裝可以放這里但冗長的構建過程能免則免優雅處理錯誤可能失敗但不該阻塞 workspace 的命令加上|| true例如npm install || true用相對路徑腳本從倉庫根目錄運行。邊界與說明Setup 腳本按倉庫配置在該倉庫被任何 workspace 使用時生效項目設置在其適用范圍內會覆蓋全局設置。腳本在 worktree 的倉庫根目錄執行一次不在每條消息時重復執行需要每輪代理結束后做的事格式化、清理應配在 Cleanup 腳本里而不是塞進 Setup 腳本。除 UI 配置外Vibe Kanban 的 MCP Server 也提供update_setup_script工具傳入repo_id和script即可更新某倉庫的 Setup 腳本見 Vibe Kanban MCP Server適合在終端代理里順帶管理倉庫腳本。配置完成后新建一個使用該倉庫的工作區在 Logs 面板確認第一條日志就是 Setup 腳本輸出且無報錯、代理隨后正常開始處理任務即表示配置生效。【免費下載鏈接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent項目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Vibe Kanban 如何為倉庫配置 Setup 腳本，讓代理啟動前自動安裝依賴并準備環境
Vibe Kanban 如何為倉庫配置 Setup 腳本讓代理啟動前自動安裝依賴并準備環境【免費下載鏈接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent項目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban在 Vibe Kanban 中每次代理執行任務都會運行在一個新建的 git worktree 里這個隔離環境里通常不包含你本地倉庫的依賴、.env和配置文件。如果什么都不配代理需要自己摸索“還沒裝依賴”這件事既慢又不可靠。Vibe Kanban 提供了 Setup 腳本在倉庫級別配置一組命令代理啟動前自動在倉庫根目錄執行用于安裝依賴、準備構建產物或初始化環境。本文說明如何為倉庫配置 Setup 腳本、配置后如何驗證它確實運行了以及腳本失敗時按文檔排查的順序。為什么需要 Setup 腳本文檔給出的使用動機有三個見 Projects Repositories安裝依賴確保所有包在代理改代碼之前已經裝好構建前置產物編譯共享庫或生成代理需要的文件環境準備初始化數據庫、拉取 Docker 鏡像、配置服務。Creating Projects 進一步解釋了必要性每次代理執行都在 git worktree 中運行而 worktree 里“不太可能”包含你的依賴、配置和.env。用 Setup 腳本例如npm install或cargo build提前跑一遍代理就不需要自己發現這些命令沒執行過。配置入口Settings 中的 Repositories 標簽頁按 Projects Repositories 的說明操作從 Workspaces 導航欄打開Settings選擇Repositories標簽頁從下拉框中選擇要配置的倉庫。該頁面除了Display Name倉庫顯示名和Repository Path倉庫本地路徑外還有 Scripts Configuration 區域用來配置這個倉庫的 dev server、setup、cleanup 三類腳本。這些腳本在該倉庫被任何 workspace 使用時都會生效。創建項目后也可以通過項目卡片右上角的設置按鈕進入同樣的項目級腳本配置見 Creating Projects。填寫 Setup 腳本在 Setup Script 一欄填入代理啟動前要執行的命令。Setup 腳本的語義是在編碼代理開始工作之前運行用于準備開發環境。文檔給出的示例按語言/包管理器選擇其一即可# Node.js 項目 npm install # Python 項目 pip install -r requirements.txt # 多條命令用 串聯 npm install npm run build:deps # Rust 項目 cargo fetch如果倉庫需要本地環境文件可以在同一設置頁配置Copy Files一個逗號分隔的文件列表從原項目目錄復制到 worktree。文檔說明這些文件在 worktree 創建之后、Setup 腳本運行之前被復制適合.env、配置文件和本地設置這類環境相關文件。注意文檔的警告這些文件必須被 gitignore否則可能被提交進代碼庫。配置前先在終端里手動跑一遍腳本。Projects Repositories 的最佳實踐明確要求在 Vibe Kanban 里配置之前先手動運行腳本確認它能正常工作。執行時機工作區創建時自動運行配置完成后不需要手動觸發。按 Creating Workspaces 的描述創建工作區時會依次發生創建 git worktree獨立工作目錄和分支原倉庫不受影響基于目標分支如main自動創建工作分支初始化編碼代理會話如果倉庫配置了 Setup 腳本自動運行以準備環境。Monitoring Task Execution 描述的任務執行順序與此一致Git worktree 創建 → Setup 腳本運行 → 代理開始處理任務。Setup 腳本在倉庫根目錄執行Projects Repositories 特別指出它在 workspace 啟動時執行一次而不是每條代理消息都執行。工作區創建流程點按鈕或Cmd/Ctrl K選New Workspace本身不涉及腳本配置選中配好 Setup 腳本的倉庫后腳本會在啟動時自動跑完代理才開始干活。驗證腳本確實運行了文檔提供了三種檢查方式看日志Monitoring Task Execution 說明任務開始后你看到的第一條日志就是 Setup 腳本在運行如果配置了的話它安裝依賴、準備環境然后代理才開始工作。日志里能看到腳本執行的實時輸出。手動重跑Workspaces 界面提供R S組合鍵直接執行 Setup 腳本R C執行 cleanup 腳本見 Keyboard Shortcuts。在 workspace 里按R S可以單獨重跑一次腳本來確認行為。View Processes點界面右上角的三點圖標選View Processes可以看到運行中和已完成的進程及各自的輸出日志包括構建類腳本。如果用的是 Web 應用Testing Your Application 提醒配置 dev server 腳本前通常也需要配置 Setup 腳本如npm install否則開發服務器啟動時缺少依賴這個配置同樣放在項目設置的 Setup Scripts 中。腳本失敗時按文檔排查Creating Workspaces 的故障排查部分列出了 Setup 腳本失敗的三類可能原因和對應處理可能原因處理腳本本身有錯誤先在終端手動測試腳本缺少依賴先在終端手動測試腳本工作目錄不對確保腳本中的路徑相對于倉庫根目錄同時查看Logs 面板里的錯誤信息定位具體失敗位置。這與腳本配置頁的最佳實踐呼應腳本從倉庫根目錄運行應使用相對路徑或環境變量不要寫死絕對路徑。寫腳本時的三條建議同樣來自 Projects Repositories保持腳本快速耗時過長的 Setup 會拖慢 workspace 啟動依賴安裝可以放這里但冗長的構建過程能免則免優雅處理錯誤可能失敗但不該阻塞 workspace 的命令加上|| true例如npm install || true用相對路徑腳本從倉庫根目錄運行。邊界與說明Setup 腳本按倉庫配置在該倉庫被任何 workspace 使用時生效項目設置在其適用范圍內會覆蓋全局設置。腳本在 worktree 的倉庫根目錄執行一次不在每條消息時重復執行需要每輪代理結束后做的事格式化、清理應配在 Cleanup 腳本里而不是塞進 Setup 腳本。除 UI 配置外Vibe Kanban 的 MCP Server 也提供update_setup_script工具傳入repo_id和script即可更新某倉庫的 Setup 腳本見 Vibe Kanban MCP Server適合在終端代理里順帶管理倉庫腳本。配置完成后新建一個使用該倉庫的工作區在 Logs 面板確認第一條日志就是 Setup 腳本輸出且無報錯、代理隨后正常開始處理任務即表示配置生效。【免費下載鏈接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent項目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考