Archon - 让AI编码更高效、可重复的开源工具

Archon：开源的AI编码流程管理工具

Archon是首个开源的AI编码流程构建工具，致力于让AI编码过程变得可预测和可重复。作为一种工作流引擎，用户可以通过定义YAML工作流来描述开发过程，包括规划、实施、验证、代码审查和PR创建，并能在所有项目中可靠地运行这些流程。

像Dockerfile为基础设施所做的那样，Archon为AI编码工作流提供了同样的创新思维与执行能力。它更像是专为软件开发设计的n8n，帮助用户驱动AI的可靠应用。

为什么选择Archon？

当你让AI助手"修复这个bug"时，结果常常是不可预测的。这可能取决于模型的状态，AI可能会跳过规划、漏掉测试，甚至完全忽略你的PR模板。每次执行的结果都可能不同。

Archon则消除了这种不确定性。通过编码你的开发流程为一个工作流，用户可以定义各个阶段、验证入口和生成的工件。AI在每一步提供智能支持，而结构则是可预测的且由用户控制。

Archon的核心特点：

可重复性：每次执行相同的工作流，按相同的顺序。流程包括计划、实施、验证、审查及PR创建。
隔离性：每次工作流运行都使用独立的git工作树，允许你并行运行多个修复任务而不存在冲突。
"发出即忘"：启动工作流后，可以专注于其他工作，稍后回来查看已完成的PR及审查评论。
可组装性：将确定性的节点（如bash脚本、测试、git操作）与AI节点（如规划、代码生成、审查）相结合，AI只在有价值的地方运行。
可移植性 ：一次定义工作流，保存在.archon/workflows/目录中并提交到你的代码库。无论是命令行、Web UI、Slack、Telegram还是GitHub，都能以相同的方式运行。

Archon工作流示例

以下是一个使用Archon的工作流示例，完成计划、实现（直到测试通过）、获取你的批准，然后创建PR的过程：

yaml 复制代码

# .archon/workflows/build-feature.yaml
nodes:
  - id: plan
    prompt: "Explore the codebase and create an implementation plan"

  - id: implement
    depends_on: [plan]
    loop:                                      # AI loop - iterate until done
      prompt: "Read the plan. Implement the next task. Run validation."
      until: ALL_TASKS_COMPLETE
      fresh_context: true                      # Fresh session each iteration

  - id: run-tests
    depends_on: [implement]
    bash: "bun run validate"                   # Deterministic - no AI

  - id: review
    depends_on: [run-tests]
    prompt: "Review all changes against the plan. Fix any issues."

  - id: approve
    depends_on: [review]
    loop:                                      # Human approval gate
      prompt: "Present the changes for review. Address any feedback."
      until: APPROVED
      interactive: true                        # Pauses and waits for human input

  - id: create-pr
    depends_on: [approve]
    prompt: "Push changes and create a pull request"

在实际使用中，你只需告诉编码助手你的需求，Archon会处理剩下的任务。例如，你可以输入"使用archon在设置页添加黑暗模式"，助手将自动运行相关工作流，创建独立分支，进行规划、实施，并最终生成PR的链接。

复制代码

You: Use archon to add dark mode to the settings page

Agent: I'll run the archon-idea-to-pr workflow for this.
       → Creating isolated worktree on branch archon/task-dark-mode...
       → Planning...
       → Implementing (task 1/4)...
       → Implementing (task 2/4)...
       → Tests failing - iterating...
       → Tests passing after 2 iterations
       → Code review complete - 0 issues
       → PR ready: https://github.com/you/project/pull/47

快速入门

完整设置（5分钟）

对于大多数用户，建议通过完整设置开始。这个过程将指导你进行凭据配置、安装Archon技能到你的项目中，并提供Web仪表板。

先决条件：Bun、Claude Code和GitHub CLI。

Bun 安装命令：

bash 复制代码

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Windows (PowerShell)
irm bun.sh/install.ps1 | iex

GitHub CLI 安装命令：

bash 复制代码

# macOS
brew install gh

# Windows (via winget)
winget install GitHub.cli

# Linux (Debian/Ubuntu)
sudo apt install gh

Claude Code 安装命令：

bash 复制代码

# macOS/Linux/WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

完成这些步骤后，克隆仓库并进行配置：

bash 复制代码

git clone https://github.com/coleam00/Archon
cd Archon
bun install
claude

然后输入："设置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

无论是选择完整设置还是快速安装，完成后进入你的项目并开始工作：

bash 复制代码

cd /path/to/your/project
claude

你可以输入："使用archon修复问题#42"或"我有哪些archon工作流？何时使用每种工作流？"你的编码助手将处理工作流选择、分支命名和工件隔离。

Web UI

Archon还提供了一个Web仪表板，用于与编码助手交互、运行工作流和监视活动。通过运行archon serve来下载并启动Web UI。

在Web UI中，你可以：

聊天：实时与助手对话，显示工作流程的进展情况。
仪表板：监控运行中的工作流，按照项目、状态和日期筛选历史记录。
工作流构建器：可视化拖放编辑器，用于创建具有循环节点的DAG工作流。

可自动化的任务

Archon出厂时附带了一系列常见开发任务的工作流。以下是一些示例：

工作流	功能描述
`archon-assist`	通用问答、调试、探索 - 完整的Claude Code助手
`archon-fix-github-issue`	分类问题 → 调查/规划 → 实施 → 验证 → PR → 智能审查 → 自修复
`archon-idea-to-pr`	功能构思 → 规划 → 实施 → 验证 → PR → 5个并行审查 → 自修复
`archon-plan-to-pr`	执行现有计划 → 实施 → 验证 → PR → 审查 → 自修复
`archon-issue-review-full`	综合修复 + GitHub问题的全多代理审查流程
`archon-smart-pr-review`	分类PR复杂性 → 运行针对性审查代理 → 综合结果
`archon-comprehensive-pr-review`	多代理PR审查（5个并行审查人员）及自动修复
`archon-create-issue`	分类问题 → 收集上下文 → 调查 → 创建GitHub问题
`archon-validate-pr`	对主分支和功能分支进行全面的PR验证
`archon-resolve-conflicts`	检测合并冲突 → 分析两边 → 解决冲突 → 验证 → 提交

Archon还支持自定义工作流，可以从.archon/workflows/defaults/中复制默认工作流并进行修改。工作流以YAML文件形式保存，命令以markdown文件形式保存在.archon/commands/中。相同名称的文件将覆盖默认值，确保团队中的每个人都能使用相同的流程。

添加平台

Web UI和CLI开箱即用，用户还可以选择将Archon连接到聊天平台，以便于远程访问：

平台	安装时间	指南
Telegram	5分钟	Telegram指南
Slack	15分钟	Slack指南
GitHub Webhooks	15分钟	GitHub指南
Discord	5分钟	Discord指南

文档与支持

完整文档可在 archon.diy 上查阅，提供了详细的设置指导、CLI参考、工作流与命令的创建说明等，以帮助你更好地使用Archon。

此外，用户在使用的过程中如遇到问题，可参考文档中的 故障排除 部分进行自助解决。

类似项目介绍

在开源社区中，存在一些与Archon相似的项目，它们的功能和特点也各具特色，例如：

n8n: 一个可自托管的工作流自动化工具，支持可视化工作流建设，适合对API的集成和任务自动化需求。
Apache Airflow: 强大的调度和监控工作流工具，常用于数据工程领域，支持Python定义工作流。
GitHub Actions: 提供了CI/CD的自动化集成，通过事件触发构建、测试和部署应用，适用于广泛的开发环境。

这些项目给用户提供了多种选择，用户可以根据需求选择最适合的工具来管理和优化他们的开发工作流。