Dicklesworthstone/agentic_coding_flywheel_setup

Bootstraps a fresh Ubuntu VPS into a complete multi-agent AI development environment in 30 minutes: coding agents, session management, safety tools, and coordination infrastructure

Agentic Coding Flywheel Setup (ACFS)

是什麼 – 一個基於 Bash 的安裝程式，可將全新的 Ubuntu 或 Arch VPS 轉換為即開即用的「智能體編程」工作站。透過單一的幂等性 curl | bash 命令，一次性安裝完整的開發堆疊（shell、執行時、雲端 CLI 等）與三個 AI 編程智能體（Claude Code、Codex CLI、Antigravity CLI）。

為何重要 – 此倉儲打包了「AI 輔助程式設計」工作流程所需的全部工具鏈，並使個人、團隊或教室實驗室的設定可重現。透過在清單檔中定義清單，並基於此生成安裝腳本，項目旨在實現可審計性與易於更新。

核心元件（如 README 所述）

元件	路徑	技術	作用
清單	`acfs.manifest.yaml`	YAML	唯一的真相來源 – 列出每個工具、其安裝命令與驗證步驟
產生器	`packages/manifest/src/generate.ts`	TypeScript + Bun + Zod	解析清單，驗證其有效性，並產生 Bash 類別庫、醫生檢查腳本與支架
網站向導	`apps/web/`	Next.js 16 + Tailwind 4	互動式 13 步指南，協助初學者租用 VPS、產生 SSH 金鑰並執行安裝程式
安裝程式	`install.sh`	Bash	生產環境的一行指令；載入產生的庫並協調分階段安裝
庫腳本	`scripts/lib/`	Bash	可重複使用的函數，用於安全、校驗和驗證、健康檢查、更新等
產生的腳本	`scripts/generated/`	Bash（僅原始碼）	類別特定的安裝模組、醫生檢查腳本、清單索引、校驗和帳本
設定	`acfs/`	Shell/Tmux 檔案	使用者層級的 dotfiles（`.zshrc`, `tmux.conf`, 上手教學）部署至 `~/.acfs/`
校驗和	`checksums.yaml`	YAML	每個上游安裝腳本的 SHA-256 哈希值；由安全庫使用

安裝程式工作流程（高階流程）

使用者執行 一行指令（curl … | bash …）。
install.sh 載入產生的類別庫。
按照清單中的 phase 順序，對每個模組執行列出的 install 命令 以所需使用者身分（通常是 root）執行。
模組完成後，執行相應的 verify 命令；失敗則中止執行。
所有外部安裝程式均透過 HTTPS 下載，其 SHA-256 哈希值與 checksums.yaml（透過 scripts/lib/security.sh）比對，僅在驗證通過後才執行。
成功後，VPS 將具備：
- 現代化 shell（zsh, oh-my-zsh, powerlevel10k）
- 語言執行時（bun, uv/Python, Rust, Go）
- 雲端 CLI（Vault, Wrangler, Supabase, Vercel 等）
- 智能體協調工具（NTM, MCP Agent Mail, SLB 等）
- 可從命令列呼叫的三個 AI 編程智能體

README 中強調的關鍵特性

一行指令，幂等性 – 可安全重複執行；從上次完成的階段繼續。
「氛圍」模式 – 預設配置以追求速度（免密碼 sudo，激進的智能體標誌）。
向導網站 – 引導絕對初學者完成 SSH 金鑰建立、VPS 租用與安裝程式執行。
清單驅動生成 – 新增工具只需編輯 acfs.manifest.yaml；TypeScript 產生器會自動更新所有 Bash 模組。
基於校驗和的安全性 – 每個上游腳本在執行前均與儲存的 SHA-256 哈希值進行驗證。
可重現的團隊環境 – 透過 --ref 鎖定至標籤或提交，確保跨機器的安裝完全一致。

典型使用情境

受眾	他們獲得什麼
初學者	分步網頁向導，一個「開箱即用」的 VPS，AI 智能體已準備就緒，可為他們撰寫程式碼。
個人開發者	一條指令即可為新虛擬機配備完整堆疊與三個編程智能體，節省數小時的手動設定時間。
團隊 / 教室	鎖定至發行版本的安裝確保每位成員的環境完全一致，消除「在我的機器上能運作」的問題，適用於智能體工作流程。

快速入門（來自 README）

# 快速安裝（預設使用氛圍模式）
{ acfs_installer="$(curl -fsSL \"https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh\")" \
  || acfs_installer="$(curl -fsSL \"https://cdn.jsdelivr.net/gh/Dicklesworthstone/agentic_coding_flywheel_setup@main/install.sh\")"; } \
  && printf '%s\n' "$acfs_installer" | bash -s -- --yes --mode vibe

在生產環境中，應將 main 替換為標籤（如 v0.9.0）或提交 SHA，並傳遞 --ref 以確保所有腳本使用相同版本。

許可與來源

許可證：MIT + OpenAI/Anthropic Rider（如徽章所示）。因此，專案允許自由使用與修改，同時承認底層 AI 模型的許可證。
平台支援：Ubuntu 22.04 及以上版本，以及基於 Arch 的發行版。

總結：ACFS 是一個具體、開源的引導工具，可自動化建立 VPS 托管的 AI 編程環境。其清單驅動架構、校驗和驗證與對初學者友善的向導，使其成為「智能體編程」領域的真正貢獻。