[Open Source] AI 程式碼開發已來臨，Archon 等你掌握！

Archon：AI 程式碼的瑞士刀！讓你的程式碼生成流程更可靠、更可控

各位熱愛程式碼的台灣朋友們，大家好！

隨著 AI 技術的飛速發展，越來越多開發者開始嘗試使用 AI 輔助程式碼編寫。但你是否也曾遇到以下情況：AI 寫出來的程式碼每次都不一樣，有時甚至會忘記測試，或是 PR 描述亂七八糟？

今天，我要向大家介紹一個超棒的開源工具 Archon，它就像是 AI 程式碼生成的瑞士刀，可以幫助你 打造更穩定、可重複，而且由你掌控的 AI 程式碼開發流程！

什麼是 Archon？ 為什麼你需要它？

Archon 是一個工作流程引擎，專為 AI 程式碼編寫而設計。 簡單來說，你可以用 YAML 檔案定義你的開發流程，像是：

1. 規劃 (Planning)： AI 探索程式碼庫，建立實作計畫。
2. 實作 (Implementation)： AI 根據計畫，一步步編寫程式碼，直到完成。
3. 驗證 (Validation)： 執行單元測試，確保程式碼功能正常。
4. 程式碼審查 (Code Review)： AI 或人工審查程式碼，找出問題。
5. 建立 PR (Pull Request)： 將程式碼提交到版本控制系統，準備合併。

Archon 就像是你的 AI 程式碼開發流程的「腳本」，確保每次運行都能按部就班地執行。

Archon 的優點：

• 可重複性 (Repeatable)： 相同的流程，相同的步驟，每次都能得到一致的結果。
• 隔離性 (Isolated)： 每個工作流程都會在獨立的 Git 工作區中執行，多個任務同時進行也不會互相干擾。
• 一鍵啟動 (Fire and forget)： 啟動工作流程後，你就可以去做其他事情，Archon 會幫你完成剩下的工作。
• 可組合性 (Composable)： 可以自由組合 AI 節點 (planning, code generation, review) 和確定性節點 (bash scripts, tests, git 操作)，充分發揮 AI 的優勢。
• 可移植性 (Portable)： 在 .archon/workflows/ 資料夾中定義你的流程，提交到你的程式碼庫，就能在不同環境中運行。

Archon 的實用案例

假設你想讓你的 AI 幫你「為設定頁面新增深色模式」。 使用 Archon，流程會是這樣的：

你： 使用 archon 新增深色模式到設定頁面

Agent： 我會為此運行 archon-idea-to-pr 工作流程
       → 建立在 archon/task-dark-mode 分支上的獨立工作區...
       → 規劃...
       → 實作 (任務 1/4)...
       → 實作 (任務 2/4)...
       → 測試失敗 - 迭代中...
       → 迭代 2 次後，測試通過
       → 程式碼審查完成 - 沒有發現任何問題
       → PR 已就緒: https://github.com/you/project/pull/47

是不是很神奇？ 你只需要告訴 AI 你想要做什麼，Archon 就會幫你搞定其餘的流程，最終產生一個 PR！

快速上手： 給台灣開發者的安裝指南

Archon 的安裝非常簡單，讓你輕鬆上手！

前提：

• Bun: (類似 npm 的套件管理器，速度更快)
  • macOS/Linux： curl -fsSL https://bun.sh/install | bash
  • Windows (PowerShell)： irm bun.sh/install.ps1 | iex
• GitHub CLI:
  • macOS: brew install gh
  • Windows (via winget): winget install GitHub.cli
  • Linux (Debian/Ubuntu): sudo apt install gh
• Claude Code: (AI 程式碼助手，類似 ChatGPT，但專注於程式碼)
  • macOS/Linux/WSL：curl -fsSL https://claude.ai/install.sh | bash
  • Windows (PowerShell)：irm https://claude.ai/install.ps1 | iex

完整設定 (5 分鐘)：

1. 克隆 Archon 倉庫：
   bash
git clone https://github.com/coleam00/Archon
cd Archon
2. 安裝依賴：
   bash
bun install
3. 安裝 Claude Code，並在終端機輸入claude：
   bash
claude
4. 啟動設定嚮導：

   claude
   

   接著，對 Claude 說: “Set up Archon” (設定 Archon)

   嚮導會引導你完成 CLI 安裝、身份驗證、平台選擇，並將 Archon 技能複製到你的程式碼倉庫中。

快速安裝 (30 秒)：

如果你已經有 Claude Code，可以直接安裝 CLI 工具：

• macOS / Linux:
  bash
curl -fsSL https://archon.diy/install | bash
• Windows (PowerShell):
  powershell
irm https://archon.diy/install.ps1 | iex
• Homebrew:
  bash
brew install coleam00/archon/archon

開始使用 Archon：

1. 進入你的專案資料夾：
   bash
cd /path/to/your/project
2. 呼叫 Claude Code：
   bash
claude
3. 告訴 AI 你想做什麼：

   Use archon to fix issue #42
   

   或者

   What archon workflows do I have? When would I use each one?
   

   Archon 會幫你選擇正確的工作流程，建立分支，並處理工作區的隔離。

   重要提示： 請務必從你的專案倉庫中運行 Claude Code，而不是從 Archon 倉庫。 設定嚮導會將 Archon 技能複製到你的專案中，讓你可以在專案中使用它。

Web UI： 一個更友善的互動介面

Archon 包含一個 Web UI，讓你更方便地與 AI 助手互動，執行工作流程，並監控活動。

• 安裝： 執行 archon serve 來下載並啟動 Web UI。
• 專案註冊： 在聊天側邊欄中點擊 “+”，輸入 GitHub 網址或本機路徑。
• 主要頁面：
  • 聊天 (Chat)： 實時串流和工具呼叫的可視化介面
  • 儀錶板 (Dashboard)： 監控正在運行的工作流程，可以按專案、狀態和日期進行篩選
  • 工作流程構建器 (Workflow Builder)： 拖放式編輯器，用於創建 DAG 工作流程
  • 工作流程執行 (Workflow Execution)： 任何正在運行或已完成的工作流程的逐步進度視圖

Web UI 整合了所有平台的對話，不只是 Web 介面。 CLI 的工作流程、Slack 或 Telegram 的訊息、GitHub 議題的互動，所有內容都集中在一個地方。

更多資訊，請參考 Web UI Guide。

Archon 可以自動化什麼？

Archon 預設提供多種工作流程，涵蓋了常見的開發任務：

Archon 提供了 17 個預設的工作流程。 你可以使用 archon workflow list 列出所有可用的工作流程，或者直接描述你想要做的事情，路由就會挑選正確的流程。

你也可以定義自己的工作流程。 預設工作流程是很棒的起點。 複製 .archon/workflows/defaults/ 中的範例，並加以自定義。 工作流程是 .archon/workflows/ 中的 YAML 檔案，指令是 .archon/commands/ 中的 Markdown 檔案。 儲存到你的專案中，你的團隊就能運行相同的流程。

請參閱 Authoring Workflows 和 Authoring Commands，了解如何創建自定義工作流程。

擴展 Archon： 連結你的聊天平台

除了 Web UI 和 CLI，你還可以連接聊天平台，方便遠端訪問：

深入了解 Archon 的架構

Archon 的架構如下：

┌─────────────────────────────────────────────────────────┐
│  平台適配器 (Web UI, CLI, Telegram, Slack,           │
│                    Discord, GitHub)                      │
└──────────────────────────┬──────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│                     Orchestrator                        │
│          (訊息路由 & 內容管理)         │
└─────────────┬───────────────────────────┬───────────────┘
              │                           │
      ┌───────┴────────┐          ┌───────┴────────┐
      │                │          │                │
      ▼                ▼          ▼                ▼
┌───────────┐  ┌────────────┐  ┌──────────────────────────┐
│  命令  │  │  工作流程  │  │    AI 助手客戶端  │
│  處理器  │  │  執行器  │  │      (Claude / Codex)    │
│  (Slash)  │  │  (YAML)    │  │                          │
└───────────┘  └────────────┘  └──────────────────────────┘
      │              │                      │
      └──────────────┴──────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│              SQLite / PostgreSQL (7 個資料表)             │
│   程式碼庫 • 對話 • 會話 • 工作流程運行  │
│    隔離環境 • 訊息 • 工作流程事件  │
└─────────────────────────────────────────────────────────┘

更多資源

• 完整的文檔可以在 archon.diy 上找到。
• Getting Started：設定指南 (Web UI 或 CLI)
• The Book of Archon：10 章的敘述性教程
• CLI Reference：完整的 CLI 參考
• Authoring Workflows：創建自定義 YAML 工作流程
• Authoring Commands：創建可重用的 AI 命令
• Configuration：所有配置選項、環境變數、YAML 設定
• AI Assistants：Claude 和 Codex 的設定細節
• Deployment：Docker、VPS、生產環境設定
• Architecture：系統設計和內部運作
• Troubleshooting：常見問題和解決方案

參與貢獻

歡迎大家為 Archon 做出貢獻！ 你可以在 issues 頁面上找到可以參與的項目。

在提交 Pull Request 之前，請閱讀 CONTRIBUTING.md 檔案。

結語

Archon 是一個非常強大的工具，它可以幫助你 更好地利用 AI 來加速程式碼開發，並保持對開發流程的掌控。 希望這篇文章對你有所幫助，鼓勵你嘗試使用 Archon，讓 AI 成為你程式碼開發的得力助手！

如果你有任何問題或想法，歡迎在下方留言，一起討論！ 也歡迎分享你在使用 Archon 過程中遇到的經驗，讓我們一起在 AI 程式碼開發的道路上共同進步！

參考閱讀

https://github.com/coleam00/Archon

About the Author

n8n n8n

Administrator

View All Posts