使用手冊

開源工程 · Multi-Agent System

本機上的自主 AI 公司

Auto Company 繁體中文使用手冊：安裝 Claude Code 或 Codex CLI 驅動的持續代理循環，理解 14 位代理、共識記憶、標準工作流、安全邊界與人工介入方式。

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

MaxMiksa/Auto-Company
星標
2.6K
分支
414
授權
—
資料截至
閱讀時間
7 分
更新日期
開啟原始報告
GitHub Stars
2.6k
代理角色
14
架構層
5
package 授權
MIT
本頁章節

01系統定位

持續運行的代理工作循環

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，也可透過暫停、停止與前景執行命令控制循環。

  1. 讀取共識

  2. 決定任務

  3. 組建小隊

  4. 執行產出

  5. 更新共識

  6. 等待下一輪

“A fully autonomous AI company running 24/7”

— Auto Company README 專案定義

02安裝與啟動

macOS 與 Windows / WSL 路徑

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

bash
# 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。

bash
# 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

03能力總覽

六種標準協作工作流

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 installlaunchd 或 systemd --user 管理 daemon
變更公司下一步編輯 memories/consensus.md下一輪讀取新的 Next Action
與所選引擎直接對話ENGINE=codex make team開啟互動式 CLI 工作階段

04官方運行原則

收斂、交班與失敗處理

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

RULE · 單檔共識交班

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

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

RULE · 三輪收斂節奏

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

來源 · PROMPT.md

RULE · 每輪小隊限制

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

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

RULE · 產出優先順序

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

來源 · PROMPT.md

RULE · 共識回復機制

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

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

RULE · 人類方向控制

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

來源 · README · Makefile

05操作實例

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
ok: [追蹤 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/ 的代理產出。方向變更應寫入共識檔，不需修改核心循環腳本。

06操作邊界

自主執行的權限與成本

07進階路徑

可控的長時間運行

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

進階操作地圖

**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 溝通規範