Hướng dẫn bắt đầu nhanh này sẽ đưa bạn từ một tài khoản mới đến merge request đầu tiên do agent viết. Quá trình này chỉ mất vài phút — phần lớn thời gian là chờ agent làm việc, chứ không phải nhấp chuột qua các bước thiết lập.
Trước khi bắt đầu
Bạn cần quyền quản trị đối với một nhóm GitLab hoặc một tổ chức GitHub có các repository mà bạn muốn agent làm việc trên đó, và — để lần chạy đầu tiên diễn ra suôn sẻ nhất — một không gian làm việc Linear. Chỉ cần vậy thôi: không có gì cần cài đặt cục bộ, và không có khóa nào cần sao chép qua lại.
Bước 1 — Đăng nhập
Truy cập trang đăng nhập và đăng nhập bằng GitLab hoặc GitHub. Chỉ một lần đồng ý duy nhất này vừa đăng nhập cho bạn vừa thiết lập tổ chức của bạn: TaskGoblin tạo một tổ chức cho mỗi nhóm từ xa của bạn (GitLab) hoặc cho mỗi lượt cài đặt ứng dụng (GitHub), vì vậy các repository của bạn được kết nối ngay khi bạn vào hệ thống.
Đối với GitHub, bạn cài đặt GitHub App của TaskGoblin trên tổ chức mà bạn muốn; token cài đặt của ứng dụng chính là danh tính bot đăng bài với tên taskgoblin[bot]. Đối với GitLab, sự đồng ý OAuth sẽ liệt kê các nhóm của bạn và kết nối chúng.
Bước 2 — Kết nối công cụ theo dõi issue của bạn
Mở Integrations từ menu tổ chức của bạn và kết nối Linear. Đây là một lượt đồng ý OAuth chỉ với một cú nhấp chuột, cho phép TaskGoblin nhìn thấy các issue được giao cho nó và đăng lại các cập nhật. Nếu nhóm của bạn làm việc trên Slack, hãy kết nối cả Slack ở đây — sau đó bạn có thể nhắc đến goblin trong bất kỳ luồng trò chuyện nào.
Xem Kết nối các tích hợp của bạn để biết danh sách đầy đủ và những gì mỗi tích hợp mở khóa.
Bước 3 — Giao việc cho agent
Bây giờ hãy giao một số công việc. Nhiệm vụ đầu tiên đơn giản nhất là một thay đổi nhỏ, được mô tả rõ ràng — một chỉnh sửa nội dung, một refactor nhỏ, hoặc một bài test còn thiếu.
- Trong Linear: mở một issue, mô tả rõ ràng thay đổi, và đặt assignee là TaskGoblin.
- Trên GitHub: thêm nhãn
taskgoblinvào một issue. - Trên GitLab: giao một issue cho bot
@taskgoblin.
TaskGoblin tự động nhận việc — việc giao hoặc gắn nhãn chính là yếu tố kích hoạt. Không có hàng đợi nào cần trông chừng và không có nút nào cần nhấn.
Bước 4 — Theo dõi nó làm việc
Agent khởi động một sandbox, clone repository, và bắt đầu làm việc trên một nhánh có tên ai-{issue-identifier}. Nó đăng lại tiến độ lên issue khi công việc diễn ra, vì vậy bạn có thể theo dõi mà không cần mở bất cứ thứ gì mới. Khi hoàn thành, nó sẽ commit, push, và mở một merge request (hoặc pull request) liên kết ngược lại với issue.
Bước 5 — Xem lại và lặp lại
Xem lại merge request giống hệt như cách bạn xem lại của một đồng nghiệp. Nếu có điều gì cần thay đổi, đừng mở lại một cửa sổ trò chuyện mới — chỉ cần để lại một bình luận xem xét và nhắc @taskgoblin, hoặc trả lời trên issue. Agent sẽ tiếp tục trên cùng một nhánh, với đầy đủ ngữ cảnh của lượt chạy cho đến thời điểm đó, và push một commit tiếp theo. Xem Giao việc cho agent để biết mọi cách gửi việc trở lại cho nó.
Những gì bạn vừa hoàn thành
Bạn đã kết nối các công cụ của mình, giao một nhiệm vụ thông qua kênh mà nhóm của bạn đã sử dụng, và nhận lại một merge request có thể xem xét — mà agent chưa từng chạm vào máy tính xách tay của bạn. Đó là toàn bộ vòng lặp. Mọi thứ khác trong tài liệu này chỉ là chi tiết được xây dựng thêm trên nền đó.