Archon 工作流工厂

这个 Agent 能做什么，适合哪些场景？

Archon 是一个自托管工作流引擎，用 YAML 描述由代理、脚本、命令、循环、子工作流和人工决策组成的流程。它通过 Claude Code、Codex 和 Pi 的 CLI 或 SDK 执行代理步骤，并可在 Git 仓库中为每次运行创建独立 worktree。内置 sdlc 工作流包可将 GitHub issue 推进到经过审查、等待 CI 并可合并的 pull request；运行也可暂停并在注意事项队列中等待人工回答。用户通过 CLI 启动流程，可用 Web 控制台查看运行和回答问题；默认使用 SQLite，也支持 PostgreSQL。它适合希望自托管、固定步骤和审核门槛的软件团队；使用内置 GitHub 流程需要 GitHub CLI。

在项目的 .archon/workflows/ 中读取 YAML 工作流，按依赖关系执行提示词、bash 命令、脚本、循环和子工作流。代理可调用 Claude Code、Codex 或 Pi；循环可持续运行至指定 bash 条件满足或达到迭代上限。需要人工判断时，运行会暂停并创建 attention 项目，展示原因、建议和可选决策，收到回答后继续。内置 sdlc 包通过 gh 检查 issue、生成交付 brief、执行计划和实现、以专门视角审查并修复发现、等待 CI，再由合并队列检查审查结论与 CI 后处理 pull request。每次运行会记录事件、转录和成本；仓库运行默认使用独立 Git worktree。

1. 维护者希望把 issue 到 pull request 的计划、实现、审查和 CI 步骤固定下来，可采用内置 sdlc 工作流包。
2. 需要同时处理多个任务的软件团队，可让每次仓库运行在独立 Git worktree 中工作。
3. 希望编码队列自主推进、只在需要决策时介入的维护者，可使用 attention 队列处理暂停运行。
4. 需要把内容制作、研究、运营或支持流程写成步骤、检查和决策的团队，可用 YAML 编排代理、命令和人工等待节点。
5. 希望在本机或服务器保留运行状态与审计记录的团队，可自托管并选择 SQLite 或 PostgreSQL。

如何安装或部署这个 Agent？

安装 Claude Code 并登录，或安装 Codex；Archon 安装器可询问要添加哪些 provider。也可使用 Homebrew 安装后运行 setup：

curl -fsSL https://archon.diy/install | bash

Windows PowerShell 安装命令：

irm https://archon.diy/install.ps1 | iex

Homebrew：

brew install coleam00/archon/archon
archon setup

README 还记录了从源码、Docker 和服务器安装方式，但此处未提供对应命令。使用内置 sdlc 包时还需 GitHub CLI gh；队列默认不绑定触发器。

如何使用这个 Agent？

进入一个 Git 仓库，列出可用工作流并启动调查：

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

也可以将自己的 YAML 文件放入 .archon/workflows/，例如：

name: build-feature
description: Plan and implement a feature.
nodes:
  - id: plan
    prompt: "Read the request and 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
      fresh_context: true

使用 archon workflow run build-feature "Add dark mode" 启动该流程。可运行 archon serve 打开 Web 控制台，或用 archon workflow attention 在终端查看并回答暂停运行的问题。要让 Claude Code 或 Codex 驱动 Archon，可在项目中运行 archon skill add。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题