Archon：AI 编码工作流引擎

项目简介

Archon 是一个开源的「工厂构建器」：你把自己希望的工作方式写成 YAML 工作流，Archon 用 AI 代理、脚本和人工决策按图执行。第一个内置工厂是软件开发——自带的 sdlc pack 可以做到「提交一个 issue，产出一个已合并的 PR」，但同一套引擎也能跑任何你能描述清楚的流程，例如内容生产、调研、运维、客服。

它的定位不是又一个编码代理，而是把你已经在用的代理（Claude Code、Codex、Pi）通过各自的 CLI 和 SDK 组织起来：工作流固定步骤、检查与关卡，代理在每一步里提供判断。

主要功能

• 每次都走同一个流程：计划、实现、评审、验证、开 PR，顺序由你写死，不再依赖某次运气。
• 人在环上，而不是在环里：队列会自动推进工作；当运行遇到无法自行决定的问题时暂停为一个「attention item」，附带上下文、理由、建议和选项，你回答后它继续。
• 内置治理：审批关卡、完整的事件日志与运行记录、每次运行的成本，都存在你自己的数据库里。
• 工作流是节点图：节点可以是代理 prompt、bash 命令、脚本、循环、等待人工、子工作流，用 depends_on、when、loop 等字段组织成有向图。
• 自带 SDLC 工厂：archon-intake 判断 issue 需要什么，archon-build-queue 走计划—实现—多视角评审—修问题—等 CI，archon-merge-queue 通过检查评审结论与 CI 后合并，archon-discoveries 记录运行中发现的额外问题。
• 可扩展：核心保持精简，外部对接通过插件完成——工作流 pack、Provider（代理运行时）、Forge（代码托管）、Chat（会话平台）。GitHub 就是插件注册中心，用 archon plugin add owner/repo 安装。
• 自托管：装在自己的机器或服务器上，默认 SQLite，也可以选 PostgreSQL。

安装与使用

1. 先安装并登录 Claude Code，或安装 Codex。
2. 安装 Archon，安装器会询问要添加哪些 provider：

curl -fsSL https://archon.diy/install | bash        # macOS / Linux
irm https://archon.diy/install.ps1 | iex            # Windows (PowerShell)
brew install coleam00/archon/archon                 # Homebrew，之后执行 archon setup

也可以通过 Docker 运行：

docker run --rm -v "$PWD:/workspace" ghcr.io/coleam00/archon:latest workflow list

3. 在任意 git 仓库里运行工作流：

cd your-project
archon workflow list
archon workflow run archon-investigate "Why does the login test fail?"

4. 用 archon serve 打开 Web 控制台查看运行并回答问题，或在终端用 archon workflow attention 处理。

工作流文件放在仓库的 .archon/workflows/ 下，一个简化示例如下：

name: build-feature
nodes:
  - id: plan
    prompt: "Read the request and the code. Write an implementation plan."
  - id: implement
    depends_on: [plan]
    loop:
      prompt: "Implement the next step of the plan."
      until_bash: "bun run test"
      max_iterations: 10
  - id: approve
    depends_on: [implement]
    wait:
      attention: "Review the change. Approve, or reject to stop."
      form: approval

保存后运行 archon workflow run build-feature "Add dark mode to the settings page"。默认情况下，仓库级运行会使用独立的 git worktree，因此多个运行可以同时在同一仓库上工作。

想让编码代理替你驱动 Archon，可以在项目里执行 archon skill add，再让它「use archon to fix issue #42」。

注意事项

• 队列默认不会自动绑定任何触发器，需要你手动启动，或用 trigger 绑定到定时任务、issue 事件。
• sdlc pack 目前通过 GitHub CLI（gh）工作。
• Archon 会发送少量匿名遥测事件（如启动、心跳、工作流开始与结束状态），用于判断哪些工作流被真实使用；官方声明不含任何 PII，也不会上报消息内容、项目名或路径。
• 文档入口在 archon.diy/docs，从源码、Docker、服务器部署等安装方式见安装指南。
• 项目采用 MIT 许可证。

---

本作品整理自 GitHub 开源项目 coleam00/Archon，原作者 @coleam00，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。