本快速入门指南将带你从一个全新的账户走到由智能体编写的第一个合并请求。整个过程只需几分钟——其中大部分时间是在等待智能体工作，而不是点击配置界面。
开始之前
你需要拥有某个 GitLab 群组或 GitHub 组织的管理员权限（智能体将在其代码仓库上工作），并且——为了获得最顺畅的首次运行体验——最好有一个 Linear 工作区。仅此而已：无需在本地安装任何东西，也无需来回复制密钥。
第一步 —— 登录
前往登录页面，使用 GitLab 或 GitHub 登录。这一次授权同时完成登录和组织的创建：TaskGoblin 会为你的每个远程群组（GitLab）或应用安装（GitHub）创建一个组织，因此你一登录，代码仓库就已连接完毕。
对于 GitHub，你需要在目标组织上安装 TaskGoblin 的 GitHub App；该应用的安装令牌就是以 taskgoblin[bot] 身份发帖的机器人身份。对于 GitLab，OAuth 授权会枚举你的群组并将其连接。
第二步 —— 连接你的问题跟踪工具
从组织菜单打开集成，连接 Linear。这是一个一键完成的 OAuth 授权，让 TaskGoblin 能够查看分配给它的 issue，并将更新回传。如果你的团队在 Slack 上协作，也可以在这里连接 Slack——之后你就可以在任意话题中提及这个小妖精了。
请参阅连接你的集成，了解完整列表以及每一项能解锁的功能。
第三步 —— 为智能体分配任务
现在，交出一些工作。最简单的第一个任务是一个小而描述清晰的改动——一个文案修正、一个小重构，或者补一个缺失的测试。
- 在 Linear 中： 打开一个 issue，清楚地描述改动内容，并将受理人设置为 TaskGoblin。
- 在 GitHub 上： 给 issue 添加
taskgoblin标签。 - 在 GitLab 上： 将 issue 分配给
@taskgoblin机器人。
TaskGoblin 会自动接手任务——分配或标签本身就是触发条件。没有队列需要盯着，也没有按钮需要按下。
第四步 —— 观察它工作
智能体会启动一个沙盒，克隆代码仓库，并开始在名为 ai-{issue-identifier} 的分支上工作。它会在推进过程中不断把进度回传到 issue，因此你无需打开任何新页面就能跟进。完成后，它会提交代码、推送，并开启一个关联回该 issue 的合并请求（或拉取请求）。
第五步 —— 审查并迭代
像审查同事的代码一样审查这个合并请求。如果有需要修改的地方，不必重新打开一个聊天窗口——只需留下一条审查评论并 @taskgoblin，或者直接在 issue 上回复。智能体会在同一分支上恢复工作，带着到目前为止运行的完整上下文，推送一个后续提交。查看为智能体分配工作了解所有可以把任务交回给它的方式。
你刚刚完成了什么
你连接好了工具，通过团队已经在用的界面委派了一项任务，并拿到了一个可供审查的合并请求——整个过程中智能体从未碰过你的笔记本电脑。这就是完整的闭环。这些文档中的其余内容，都是在此基础上的细节补充。