Async：整合 Claude、Linear、GitHub 的开发工具

概述

一款将 AI 编码与任务管理和代码审查相结合的开源开发者工具。Async 将 Claude Code、Linear 和 GitHub PR 集成到一个主张明确的工作流中。

https://www.async.build/

自动研究编码任务 - 分析你的代码库，在执行前提出澄清问题

在云端执行代码变更 - 在隔离环境中运行，不触及本地设置

将工作分解为可审查的子任务 - 创建堆栈 diff，便于代码审查

处理完整工作流 - 从 GitHub issue 到合并 PR，无需离开应用

传统工具的局限

传统 AI 编码工具在新项目上表现出色，但在不能出错的成熟代码库中举步维艰。Async 解决了常见问题：

强制前置规划 - 总是提出澄清问题，执行前需确认

消除上下文切换 - 在云端异步执行，你可以继续其他工作

简单的任务跟踪 - 自动导入 GitHub issue，无 PM 工具的繁复

内置代码审查 - 在堆栈 diff 上评论和迭代，无需离开应用

工作流程

Onboarding & Task Creation（入门与任务创建）：安装 Async GitHub App 并选择仓库。Async 自动将开放的 GitHub issue 作为任务导入。

Research Phase（研究阶段）：新任务触发一个 Google Cloud Run 任务来克隆你的仓库并运行研究 agent。该 agent 分析代码库并生成澄清问题。任务要么自动执行，要么等待你的输入。

Execution（执行）：另一个隔离的 GCR 任务使用 Claude Code 处理执行。创建特性分支 → 将任务分解为子任务 → 将每个子任务作为单独的提交执行 → 开启 PR。

Code Review（代码审查）：审查在 Async 中进行。逐步审查每个子任务的聚焦 diff，留下评论，要么请求更改（创建新子任务），要么批准（压缩并合并）。

架构

后端：FastAPI with 异步支持

AI 模型：Claude Code 用于实现，OpenAI/Anthropic/Google 模型用于研究

云：Google Cloud Platform，容器化执行

数据库：Firebase Firestore

集成：GitHub App、Stripe 支付、邮件通知

前端：支持桌面和移动设备

安装和设置

创建并激活虚拟环境：

uv venv .venv
source .venv/bin/activate

显式同步环境，运行以下命令：

uv sync

然后运行以下命令设置 pre-commit lints

pre-commit install

要在本地运行 agent，在根目录创建 .env 文件（查看 .env.local 作为示例）。

创建一个名为 async-firebase.json 的 firebase 配置文件。

运行以下命令以授予默认登录到 Google Cloud 客户端库的权限：

gcloud auth application-default login

uvicorn src.server:app --reload --port 8000

要进行 linting，运行以下命令：

uv run ruff format .
uv run ruff check . --fix

要运行所有单元测试：

python -m pytest

API 端点

FastAPI 服务器提供以下主要端点：

• POST /auth/auth-with-github - 使用访问代码完成 GitHub OAuth 流程
• POST /auth/verify-email - 发送邮件验证码
• POST /auth/redeem-email-code - 验证邮件验证码
• POST /auth/invite-people - 发送团队邀请
• POST /auth/redeem-invite-code - 验证邀请码
• POST /github/handle-github-events - 处理 GitHub webhook 事件（issues、PR、push）
• POST /github/submit-review - 提交代码审查（批准/请求更改）
• POST /task/schedule-job - 调度任务执行任务（研究、执行、修改、索引）
• WebSocket /task/chat - 与 AI agent 的实时任务通信
• POST /onboarding/onboard-github - 完成 GitHub App 安装和仓库设置
• POST /payment/create-checkout-session - 创建 Stripe 结账用于订阅
• POST /payment/create-portal-session - 访问客户计费门户
• POST /payment/handle-stripe-events - 处理 Stripe webhook 事件
• POST /support/handle-contact-us - 提交联系表单并创建线索

Google Cloud Run 任务

系统使用隔离的 Google Cloud Run 任务来处理任务：

execute-task - 使用 Claude Code 的主要任务执行

• 克隆仓库到特性分支
• 使用 Claude Code 规划模式将任务分解为子任务
• 将每个子任务作为单独的提交执行
• 完成后开启 pull request

research-task - 代码库分析和需求收集

• 分析仓库结构和上下文
• 为模糊需求生成澄清问题
• 为执行创建结构化的任务摘要

revise-task - 处理代码审查反馈

• 处理审查评论和请求的更改
• 创建新子任务以处理反馈
• 使用更新的需求重新执行

index-project - 仓库索引和设置

• 分析项目结构和编程语言
• 为任务执行设置项目元数据
• 为 AI agent 分析准备仓库

每个任务在隔离的环境中运行，仓库已克隆且所有必要依赖已安装。

要求

• Google Cloud Platform 账户，已启用 Cloud Run
• 带有 Firestore 的 Firebase 项目
• 为你的组织配置的 GitHub App
• 用于支付处理的 Stripe 账户

环境变量

在生产环境中配置以下变量：

• ANTHROPIC_API_KEY - Claude API 访问
• OPENAI_API_KEY - OpenAI API 访问
• GOOGLE_API_KEY - Google AI API 访问
• STRIPE_SECRET_KEY - Stripe 支付处理
• GITHUB_WEBHOOK_SECRET - GitHub webhook 验证
• DB_URI - 数据库连接字符串

该应用程序设计为在 Google Cloud Run 上运行，具有自动扩展和隔离的任务执行。

贡献

创建特性分支（git checkout -b feature/amazing-feature）

运行测试和 linting

提交你的更改（git commit -m 'Add amazing feature'）

推送到分支（git push origin feature/amazing-feature）

请确保你的代码遵循现有风格并通过所有测试。

License

该项目在 MIT License 下许可 - 详见 LICENSE 文件。

有问题或疑问，请开启 GitHub issue 或联系团队。

为了解他们的代码库的资深开发者而构建。Async 是你需要的最后一个工具，用来打造伟大的东西。