gascity：從 README 拆解介面、限制與採用條件
此專案圍繞「gastownhall/gascity」建置，面向真實業務場景，提供可重複使用、可持續維運的開源實作。
秒懂
- 它是什麼？
- Orchestration-builder SDK for multi-agent coding workflows 本文整理 gastownhall/gascity 的入口、資料流、環境條件與專案專屬核驗觀察點。
- 適合誰用？
- gascity 適合需要 README 所列能力，並能管理輸入、依賴與執行平台的使用者；不適合把未說明行為當成穩定承諾。先在隔離環境以 gastownhall/gascity 的 README 入口跑最小案例，檢查具體輸出、錯誤訊息與產物，再決定是否納入正式流程。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 1 天前。
- 用什麼語言寫的？
- 主要是 Go（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
gascity：從 Gas Town 提取可重用基礎設施（批次 0037 第 1 節）
Gas City 是一個用 Go 編寫的面向多代理編碼工作流的編排構建器 SDK。README 將其描述為從 Gas Town 提取可重用基礎設施，形成一個可配置工具包。該工具包包括運行時提供器、工作路由、公式、訂單、健康巡邏和聲明式城市配置。該項目定位為原始優先模型，並有一個單獨的指南，為來自 Gas Town 的用戶將 Town 的角色、命令、插件、車隊和目錄習慣映射到 Gas City 的模型。
在 gastownhall/gascity 的第 1 節脈絡裡，判斷要連同 gascity、main 分支、MIT、https://github.com/gastownhall/gascity 一起看。README 記載的介面可以當作範圍，沒有寫出的預設值、效能與錯誤處理則維持未說明。實際核對時，請用專案自己的入口重現本節描述，記錄終端輸出、設定檔與產物位置，避免把倉庫摘要誤當成執行結果。
gascity：包含的工具包（批次 0037 第 2 節）
README 的"你得到什麼"列表列出了五項：city.toml 中的聲明式城市配置；多種運行時提供器（tmux、subprocess、exec、ACP、Kubernetes 和 herdr）；基於 beads 的工作追蹤、公式、分子、等待和郵件；一個控制器/監督循環，將期望狀態協調到運行狀態；以及用於多項目設置的包、覆蓋和 rig 範圍編排。這些是文檔化的能力；README 沒有詳細說明每個提供器的行為或協調循環的實現細節。
在 gastownhall/gascity 的第 2 節脈絡裡，判斷要連同 gascity、main 分支、MIT、https://github.com/gastownhall/gascity 一起看。README 記載的介面可以當作範圍，沒有寫出的預設值、效能與錯誤處理則維持未說明。實際核對時，請用專案自己的入口重現本節描述，記錄終端輸出、設定檔與產物位置，避免把倉庫摘要誤當成執行結果。
gascity：系統前提條件與提供器依賴（批次 0037 第 3 節）
安裝指南列出了必需工具：tmux、git、jq、pgrep 和 lsof 始終必需。beads 提供器 bd 需要 dolt（2.1.0 或更新）、bd（1.0.0）和 flock。GitHub CLI gh 對於 GitHub 門控是可選的，而 claude、codex 或 gemini 等 CLI 工具按提供器而定。README 指出 tmux 是默認會話後端和回退，因此即使代理運行在其他後端上，它仍然是必需的。對於基於文件的存儲，使用 GC_BEADS=file 或在 city.toml 中設置 [beads] provider = "file" 可避免 dolt、bd 和 flock。
在 gastownhall/gascity 的第 3 節脈絡裡，判斷要連同 gascity、main 分支、MIT、https://github.com/gastownhall/gascity 一起看。README 記載的介面可以當作範圍，沒有寫出的預設值、效能與錯誤處理則維持未說明。實際核對時，請用專案自己的入口重現本節描述，記錄終端輸出、設定檔與產物位置，避免把倉庫摘要誤當成執行結果。
gascity：安裝路徑（批次 0037 第 4 節）
快速入門展示了兩種安裝方式。Homebrew 用戶可以運行 brew install gascity 然後 gc version。從源碼構建需要 make、Go 1.26.4 或更新版本以及 ICU（用於傳遞的 Dolt CGO 依賴）；README 給出了 make install 和一小串命令，用於初始化城市、添加 rig、創建 bead 並附加到會話。確切的命令出現在 README 中，並在教程參考中重複，但 README 沒有解釋每個命令的作用。
在 gastownhall/gascity 的第 4 節脈絡裡，判斷要連同 gascity、main 分支、MIT、https://github.com/gastownhall/gascity 一起看。README 記載的介面可以當作範圍，沒有寫出的預設值、效能與錯誤處理則維持未說明。實際核對時，請用專案自己的入口重現本節描述，記錄終端輸出、設定檔與產物位置，避免把倉庫摘要誤當成執行結果。
gascity：在 Nix 和 Flox 機器上構建（批次 0037 第 5 節）
README 特別提到了 NixOS 和 Flox 管理的 Linux 工具鏈上的一個特定失敗模式：系統 include 和 lib 目錄不會被搜索，因此構建失敗，出現 fatal error: unicode/uregex.h: No such file or directory。解決方法是將 CGO 指向 Nix 存儲中的 ICU 開發頭文件和匹配的運行時庫，並使用 SYS_USR_CGO_FALLBACK=0 禁用 Makefile 的 /usr/lib 回退。README 給出了存儲路徑示例，並指出支持 CGO 的測試使用相同的三個 CGO_* 變量。
在 gastownhall/gascity 的第 5 節脈絡裡，判斷要連同 gascity、main 分支、MIT、https://github.com/gastownhall/gascity 一起看。README 記載的介面可以當作範圍，沒有寫出的預設值、效能與錯誤處理則維持未說明。實際核對時，請用專案自己的入口重現本節描述，記錄終端輸出、設定檔與產物位置，避免把倉庫摘要誤當成執行結果。
gascity：倉庫結構與貢獻者指南（批次 0037 第 6 節）
倉庫地圖列出了十一個路徑。cmd/gc/ 包含 CLI 入口、控制器接線、運行時組裝和命令處理程序；internal/runtime/ 包含提供器實現；internal/config/ 處理 city.toml 模式和包組合；internal/beads/ 涵蓋存儲抽象；internal/session/、internal/orders/、internal/convergence/ 和 internal/api/ 分別處理會話元數據、訂單掃描、細化循環和 HTTP API 處理程序。文檔位於 docs/，貢獻者工程文檔在 engdocs/，還有 examples/、contrib/ 和 test/。README 為貢獻者指出了 CLI 行為、運行時工作、配置、工作調度和監督會話的特定文件。
在 gastownhall/gascity 的第 6 節脈絡裡，判斷要連同 gascity、main 分支、MIT、https://github.com/gastownhall/gascity 一起看。README 記載的介面可以當作範圍，沒有寫出的預設值、效能與錯誤處理則維持未說明。實際核對時，請用專案自己的入口重現本節描述，記錄終端輸出、設定檔與產物位置，避免把倉庫摘要誤當成執行結果。
gascity：文檔、貢獻與許可證（批次 0037 第 7 節）
該項目指向 docs.gascityhall.com 獲取在線文檔，該文檔使用基於 docs/ 的 Mintlify 結構。貢獻指南位於 CONTRIBUTING.md 和 engdocs/contributors/index.md；有用的命令包括 make setup、make check、make check-docs 和 make test-integration。許可證是 MIT，版權歸 Steve Yegge（README 未提及版權，但許可證摘錄中有）。MIT 許可證授予使用、複製、修改、合併、發布、分發、再許可和銷售副本的權限，並聲明軟件按"原樣"提供，不提供任何形式的擔保。許可證未提及支持、安全或維護承諾。
在 gastownhall/gascity 的第 7 節脈絡裡，判斷要連同 gascity、main 分支、MIT、https://github.com/gastownhall/gascity 一起看。README 記載的介面可以當作範圍，沒有寫出的預設值、效能與錯誤處理則維持未說明。實際核對時，請用專案自己的入口重現本節描述，記錄終端輸出、設定檔與產物位置，避免把倉庫摘要誤當成執行結果。
gascity 的第 1 次核對仍以 gastownhall/gascity 為對象，固定 main 分支與素材所記錄的版本訊號，逐項保存輸入、命令回應、生成檔案和失敗位置。若結果與 README 不同，先檢查依賴和設定，再將差異標成文件已說明或尚待查證；這個記錄只描述 gascity 的實際行為，不替專案增加未宣稱的保證。
gascity 的第 2 次核對仍以 gastownhall/gascity 為對象，固定 main 分支與素材所記錄的版本訊號，逐項保存輸入、命令回應、生成檔案和失敗位置。若結果與 README 不同，先檢查依賴和設定，再將差異標成文件已說明或尚待查證；這個記錄只描述 gascity 的實際行為，不替專案增加未宣稱的保證。
gascity 的第 3 次核對仍以 gastownhall/gascity 為對象，固定 main 分支與素材所記錄的版本訊號，逐項保存輸入、命令回應、生成檔案和失敗位置。若結果與 README 不同，先檢查依賴和設定，再將差異標成文件已說明或尚待查證；這個記錄只描述 gascity 的實際行為，不替專案增加未宣稱的保證。
gascity 的第 4 次核對仍以 gastownhall/gascity 為對象，固定 main 分支與素材所記錄的版本訊號，逐項保存輸入、命令回應、生成檔案和失敗位置。若結果與 README 不同，先檢查依賴和設定，再將差異標成文件已說明或尚待查證；這個記錄只描述 gascity 的實際行為，不替專案增加未宣稱的保證。
編輯結論
gascity 適合需要 README 所列能力，並能管理輸入、依賴與執行平台的使用者；不適合把未說明行為當成穩定承諾。先在隔離環境以 gastownhall/gascity 的 README 入口跑最小案例，檢查具體輸出、錯誤訊息與產物，再決定是否納入正式流程。
社群筆記