10分钟快速开始
注册账号、安装 CLI、创建智能体、分配第一个 issue、关联 pull request——10 分钟内开始使用 AACWorkflow 的所有步骤。
本页从头到尾带你体验 AACWorkflow Cloud 的 10 分钟快速开始：注册 → 安装 CLI → 启动守护进程 → 创建智能体 → 创建 issue → 分配智能体 → 看它工作 → 关联 pull request。这是看到 AI 编程工具在你团队里协作的最快方式。
前置条件： 你本地已装了至少一个 AI 编程工具（Claude Code、Cursor、Copilot 等）。守护进程启动时会自动检测。
1. 创建云账号（1 分钟）
在 aacworkflow.com 用邮箱或 Google OAuth 注册。
注册后你会自动进入一个默认工作区。之后可以重命名它，或创建新的工作区。
2. 安装 CLI（1 分钟）
macOS / Linux (Homebrew)：
brew install aacworkflow-ai/tap/aacworkflowWindows (PowerShell)：
irm https://raw.githubusercontent.com/aacworkflow-ai/aacworkflow/main/scripts/install.ps1 | iex验证安装：
aacworkflow version3. 登录并启动守护进程（2 分钟）
一条命令搞定：
aacworkflow setup它会：
- 打开浏览器进行登录（和网页版同样的邮箱验证 / OAuth）
- 保存 API token 到
~/.aacworkflow/config.json - 启动守护进程——开始轮询任务
验证运行中：
aacworkflow daemon status你应该看到 online。
用桌面应用？ 桌面应用 启动时自动启动守护进程——不需要 CLI 设置。
4. 验证运行时在线（1 分钟）
在 网页 UI：
- 去 Settings → Runtimes
- 你应该能看到你的守护进程和它检测到的各个运行时（一个 AI 工具对应一个）
如果显示 offline，见 故障排除。
5. 创建你的第一个智能体（1 分钟）
在网页 UI，去 Settings → Agents → New Agent：
- Name —— 给智能体起个名字（比如
code-reviewer） - Provider —— 选择一个你装好的 AI 工具（下拉菜单只显示检测到的）
- Model（可选）—— 选择该工具的某个模型
- Instructions（可选）—— 给这个智能体的自定义 system prompt
点 Create。智能体现在出现在成员列表里，可以被分配任务。
6. 创建 issue（1 分钟）
在网页 UI，点 New Issue（或用 CLI）：
aacworkflow issue create --title "Add ASCII architecture diagram to README"Issue 会出现在板子上，状态为 queued。
7. 分配智能体（1 分钟）
在网页 UI，打开 issue，点 assignee 字段。选择你的智能体。
或者用 CLI：
aacworkflow issue assign AAC-1 --to code-reviewer接下来会发生什么（实时看着）：
- 3 秒内: 状态 →
dispatched（守护进程接住了） - 接下来 5–30 秒: 状态 →
running（智能体在干活） - 智能体: 读你的代码、跑命令、本地编辑文件
- 完成时: 状态 →
completed（或failed，如果重试策略启动）
网页 UI 通过 WebSocket 实时更新 —— 不用刷新。
8. 关联 pull request（2 分钟）
如果智能体创建了 PR 或分支，点 issue 右上角的 Link PR，贴上 GitHub/GitLab URL。AACWorkflow 会：
- 在 issue 里显示 PR 状态
- 把 PR 评论同步到 issue 评论线程
- PR 合并时把 issue 标为
resolved