開源工程 · Multi-Agent System

本機上的
自主 AI 公司

Auto Company 以 Claude Code 或 Codex CLI 執行持續工作循環，讓代理團隊在本機讀取共識、組隊、產出並交班。這份手冊說明安裝路徑、代理與工作流配置、人工介入方法，以及高自主權限帶來的操作邊界。

2.6k

GitHub Stars

代理角色

架構層

MIT

package 授權

系統定位

持續運行的
代理工作循環

Auto Company 是一套在本機呼叫 Claude Code 或 Codex CLI 的多代理編排專案。它把公司章程、角色定義、工作方法與狀態交班保存為儲存庫內的 Markdown 檔案，再由 shell 腳本反覆啟動新的 CLI 工作階段。

每輪先讀取 PROMPT.md 與 memories/consensus.md，再依 .claude/skills/team/SKILL.md 從 14 位代理中挑選 3–5 位組成小隊。任務結束前必須重寫共識檔，下一輪只以該檔案承接跨週期狀態。

CLAUDE.md 定義任務優先級、代理責任與不可執行的破壞性操作。人類可修改共識檔的 Next Action，也可透過暫停、停止與前景執行命令控制循環。

單一工作週期

讀取共識→ 決定任務→ 組建小隊→ 執行產出→ 更新共識→ 等待下一輪

“A fully autonomous AI company running 24/7”

— Auto Company README 專案定義

安裝與啟動

macOS 與
Windows / WSL 路徑

先安裝並登入 Claude Code 或 Codex CLI，並確認模型配額可用。macOS 以 Terminal 操作；Windows 10／11 需先安裝 WSL2 Ubuntu，並在 WSL 內備妥 jq、make 與所選 CLI。

# Clone
git clone https://github.com/MaxMiksa/Auto-Company.git
cd auto-company

# Foreground run (live output)
make start

# Or install daemon (auto-start + auto-restart)
make install
      

Windows PowerShell 控制層

在 Windows 端以 PowerShell 腳本控制 WSL 內的循環。預設引擎為 Claude；需要 Codex 時明確傳入 -Engine codex。

# Clone, then enter the repository
git clone https://github.com/MaxMiksa/Auto-Company.git
cd auto-company

# Start with Claude, or select Codex explicitly
.\scripts\windows\start-win.ps1
.\scripts\windows\start-win.ps1 -Engine codex

# Inspect and stop
.\scripts\windows\status-win.ps1
.\scripts\windows\stop-win.ps1
      

先以前景模式驗證。README 將專案標示為實驗性軟體；macOS／WSL 先執行 make start 觀察輸出，再決定是否安裝 daemon。Windows 的 PowerShell 腳本是控制層，實際執行環境仍為 WSL。

能力總覽

六種標準
協作工作流

14 位代理分布於策略、產品、工程、商業與情報層。每輪由團隊技能依任務挑選 3–5 位角色；重大決策必須納入 critic-munger 執行 pre-mortem，前端交付則必須先載入 frontend-design.md。

Workflow · 01

新產品評估

策略與可行性

Research → CEO → Munger → Product → CTO → CFO；從市場證據、風險、產品與單位經濟完成 GO／NO-GO 決策。

Workflow · 02

功能開發

產品與工程

Interaction → UI → Full-stack → QA → DevOps；依序定義流程、介面、實作、品質與部署。

Workflow · 03

產品發布

發布與商業

QA → DevOps → Marketing → Sales → Ops → CEO；完成發布檢查、部署、推廣、銷售與營運決策。

Workflow · 04

定價與變現

財務與策略

Research → CFO → Sales → Munger → CEO；以研究、財務模型、銷售訊號與逆向檢查形成價格決策。

Workflow · 05

每週檢討

營運與品質

Ops → Sales → CFO → QA → CEO；彙整營運、收入、品質與管理決策，並寫入下一輪行動。

Workflow · 06

機會探索

研究與篩選

Research → CEO → Munger → CFO；由市場研究提出機會，再檢查策略、失敗條件與經濟性。

任務與入口選擇

目前需求	操作入口	可觀察結果
在終端查看每輪完整輸出	`make start`	前景顯示循環日誌
持續在背景執行	`make install`	launchd 或 systemd --user 管理 daemon
變更公司下一步	編輯 `memories/consensus.md`	下一輪讀取新的 `Next Action`
與所選引擎直接對話	`ENGINE=codex make team`	開啟互動式 CLI 工作階段

官方運行原則

收斂、交班與
失敗處理

專案把協作規則寫入 PROMPT.md、CLAUDE.md 與核心循環腳本。以下原則均可在儲存庫內直接檢查，適合在首次執行前作為操作清單。

RULE 01

單檔共識交班

每一輪都是新的 CLI 呼叫；跨週期狀態只保存在 memories/consensus.md。檢查 Next Action、Active Projects 與 Open Questions 是否已更新。

來源 · README · scripts/core/auto-loop.sh

RULE 02

三輪收斂節奏

Cycle 1 排出三個構想；Cycle 2 對第一名執行 pre-mortem、市場驗證與財務檢查；Cycle 3 起，GO 即建立專案與出貨，NO-GO 則改測下一案。

來源 · PROMPT.md

RULE 03

每輪小隊限制

依任務挑選 3–5 位最相關代理，不同時載入全部 14 位。每輪結束前仍須將決策、專案狀態與單一 Next Action 寫回共識檔。

來源 · PROMPT.md · team/SKILL.md

RULE 04

產出優先順序

系統優先級為 Ship > Plan > Discuss。Cycle 2 之後每輪必須留下檔案、儲存庫或部署等實物；同一個 Next Action 連續兩輪時需縮小範圍或換方向。

來源 · PROMPT.md

RULE 05

共識回復機制

核心腳本在每輪前備份共識檔。若 CLI 失敗或新共識未通過格式驗證，腳本回復上一份共識，再累計錯誤並套用斷路器。

來源 · scripts/core/auto-loop.sh

RULE 06

人類方向控制

修改共識檔的 Next Action 可改變下一輪方向。需要立即限制執行時，先以 make pause、make stop 或 Windows 停止腳本中止循環。

來源 · README · Makefile

操作實例

Codex 引擎的
前景驗證流程

以下流程先在前景啟動 Codex 引擎，確認循環與共識更新，再切換至 daemon。首次執行期間保留終端輸出，並在安裝背景服務前檢查 docs/、projects/ 與共識檔。

~/auto-company · terminal · codex engine

Terminal › git clone https://github.com/MaxMiksa/Auto-Company.git cd auto-company

Terminal › ENGINE=codex make start [前景循環啟動；日誌列出 Engine、Interval、Timeout 與 Breaker] [每輪載入 PROMPT.md 與 memories/consensus.md]

Operator › 觀察首輪輸出，確認 CLI 已登入且沒有權限、配額或執行檔錯誤。

Second terminal › make status [檢查循環狀態與最新共識]

Operator › 開啟 memories/consensus.md，檢查 Current Phase、What We Did This Cycle、 Active Projects 與 Next Action 均有可追蹤內容。

Second terminal › make cycles [檢查週期摘要與成功／失敗狀態]

Second terminal › make stop [前景驗證完成後停止循環]

Terminal › ENGINE=codex make install [安裝平台對應 daemon；macOS 使用 launchd，Linux／WSL 使用 systemd --user]

Terminal › make monitor [追蹤 daemon 的即時日誌；Ctrl+C 只離開監看]

“Each cycle is an independent CLI call.
memories/consensus.md is the only cross-cycle state.”

— Auto Company README 運行模型

驗證結果判讀

啟動成功時，日誌會顯示所選引擎與循環設定；make status 可讀取最新共識。若共識未更新，核心腳本會把該輪標記為失敗並回復備份，不應直接轉入 daemon 模式。

daemon 啟動後，以 make monitor 查看即時日誌，並定期檢查 docs/ 與 projects/ 的代理產出。方向變更應寫入共識檔，不需修改核心循環腳本。

操作邊界

自主執行的
權限與成本

專案仍屬實驗性。README 明確表示穩定性不保證。先以前景模式運行，定期審查 docs/ 與 projects/，再評估長時間 daemon。
每輪消耗模型配額。持續循環會反覆呼叫 Claude Code 或 Codex CLI。開始前確認方案、配額與帳務限制，並利用停止或暫停命令限制運行時間。
預設權限設定需人工審查。README 說明 Claude 可使用 bypassPermissions，Codex 則依底層 sandbox 設定直接操作主機或 WSL。先檢查 .claude/settings.json、環境變數與 CLI 設定。
文字護欄不是作業系統隔離。CLAUDE.md 禁止刪除儲存庫、Cloudflare 專案、系統檔與受保護分支的強制推送；執行權限仍由底層 CLI 與主機環境決定。
Windows 需要 WSL。PowerShell 只負責控制，循環在 WSL Ubuntu 內執行。CLI 若只安裝在 Windows 主機，WSL 內會出現找不到 claude 或 codex 的錯誤。
引擎不會自動後援。所選 Claude 或 Codex 執行檔缺失時，啟動會直接失敗。使用 make status 與日誌確認引擎，不應假設系統會切換到另一個 CLI。
背景服務依賴平台服務管理器。macOS 使用 launchd；Linux／WSL 使用 systemd --user。WSL 若未啟用可用的 user systemd，make install 會失敗。

進階路徑

可控的
長時間運行

進階設定應先處理權限、狀態與可觀察性，再延長循環時間。所有調整均可透過儲存庫檔案與環境變數完成。

進階操作地圖

1. 審查公司章程。閱讀 CLAUDE.md 的 Safety Guardrails、Workspace rule 與代理責任。依實際主機權限縮小可執行範圍。

2. 驗證共識格式。檢查 memories/consensus.md 是否包含 Current Phase、Key Decisions、Active Projects、Next Action 與 Open Questions。讓每輪只留下單一可執行的下一步。

3. 調整循環參數。使用 LOOP_INTERVAL、CYCLE_TIMEOUT_SECONDS 與 MAX_CONSECUTIVE_ERRORS 控制等待時間、單輪逾時與斷路器門檻。每次只改一項，再從日誌檢查影響。

4. 固定引擎與 sandbox。以 ENGINE 明確選擇 Claude 或 Codex；需要限制 Codex 時設定 CODEX_SANDBOX_MODE。啟動日誌應顯示預期引擎與模式。

5. 建立例行審查。使用 make cycles、make last 與 make monitor 檢查週期摘要、上一輪完整輸出與即時日誌。同步審查 docs/ 與 projects/ 的新產出。

核心延伸閱讀

① README.md：平台快速開始、架構、設定、常見問題與免責聲明。
② CLAUDE.md：公司章程、安全護欄、14 位代理與標準工作流。
③ docs/windows-setup.md：Windows／WSL 安裝、自啟與故障排除。

“Every discussion ends with a concrete Next Action.”

— Auto Company CLAUDE.md 溝通規範