coleam00/Archon

The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.

Archon – 确定性 AI 编码工作流

它是什么 – Archon 是一个开源工作流引擎，让您以可重复、隔离且可组合的方式编排 AI 辅助的软件开发任务（错误修复、功能实现、代码审查、PR 创建等）。您将开发流程描述为 YAML 工作流；Archon 运行步骤，仅在需要智能的地方调用 LLM，其余部分（bash 脚本、测试、Git 操作）保持确定性。

关键概念

确定性运行 – 相同的工作流总是遵循相同的顺序，消除了“模型情绪”问题。
隔离 – 每次运行都有自己的 Git worktree，允许并行执行而不会冲突。
人机循环 – 循环可以暂停以进行批准或反馈，混合 AI 和手动步骤。
可移植性 – 工作流存在于项目的 .archon/workflows/ 文件夹中，可以从 CLI、Web UI 或聊天平台（Slack、Telegram、Discord、GitHub webhooks）触发。

典型工作流（简化）：

nodes:
  - id: plan        # AI 生成计划
    prompt: "Explore the codebase and create an implementation plan"
  - id: implement   # AI 迭代直到任务完成
    depends_on: [plan]
    loop:
      prompt: "Read the plan. Implement the next task. Run validation."
      until: ALL_TASKS_COMPLETE
      fresh_context: true
  - id: run-tests   # 确定性 bash 步骤
    depends_on: [implement]
    bash: "bun run validate"
  - id: review      # AI 审查变更
    depends_on: [run-tests]
    prompt: "Review all changes against the plan. Fix any issues."
  - id: approve     # 人工批准关卡
    depends_on: [review]
    loop:
      prompt: "Present the changes for review. Address any feedback."
      until: APPROVED
      interactive: true
  - id: create-pr   # AI 创建 PR
    depends_on: [approve]
    prompt: "Push changes and create a pull request"

在 issue 上运行 archon-ship 将自动：

创建隔离的分支/worktree
规划、实现（循环直到测试通过）、审查、等待人工批准，最后开启 PR。

安装与入门

完整设置（约 5 分钟） – 克隆 repo，运行 bun install，安装 Claude Code，然后运行 archon 并遵循交互式向导（设置凭据、将 Archon skill 复制到目标 repo 等）。
快速安装（约 30 秒） – 如果已安装 Claude Code，您可以获取预编译的二进制文件：
```
curl -fsSL https://archon.diy/install | bash   # macOS/Linux
# 或 Windows 上的 PowerShell
irm https://archon.diy/install.ps1 | iex
```
（也提供 Homebrew formula。）
运行工作流 – 在项目目录内：archon workflow run archon-ship 或直接询问助手：Use archon to fix issue #42。

Web UI – archon serve 启动一个控制台，您可以在其中浏览运行、查看工作流图、与助手聊天和管理项目。Slack、Telegram、Discord 和 GitHub webhooks 的适配器让您可以从这些平台触发运行。

内置工作流包 – sdlc 包附带现成的工作流，例如：

archon-ship – 端到端 issue → PR
archon-triage、archon-investigate、archon-plan、archon-implement、archon-review、archon-validate、archon-upkeep 您可以使用 archon workflow list 列出它们，并自定义或编写自己的 YAML 工作流。

架构概览

Platform adapters (Web UI, CLI, Slack, …) → Orchestrator →
   Command handler, Workflow executor, AI assistant clients (Claude, Codex, Pi)
   ↕
   SQLite / PostgreSQL persistence (runs, projects, sessions, etc.)

遥测 – Archon 发送匿名使用事件（工作流名称、结果、节点数、提供商/模型 ID、成本等），但绝不发送任何代码、提示或个人数据。可以通过 ARCHON_TELEMETRY_DISABLED=1 或标准的 DO_NOT_TRACK 禁用遥测。

谁可能使用它 – 依赖 LLM 进行代码生成并想要可重现、类似 CI 管道的开发人员；希望将 AI 助手嵌入现有开发工作流而不牺牲可审计性和可重复性的团队。

TL;DR – Archon 是一个确定性、Git 感知的工作流引擎，让您以 YAML 编写 AI 辅助的开发步骤，从 CLI 或聊天平台运行它们，并获得可靠的 PR，而没有通常伴随“让 AI 修复错误”而来的随机性。

coleam00/Archon

Archon – 确定性 AI 编码工作流

相关