TaskGoblin không có một nút "chạy" duy nhất. Thay vào đó, tác nhân theo dõi các công cụ mà bạn đã sử dụng sẵn và tiếp nhận công việc ngay khi bạn giao nó — cùng những thao tác mà bạn sẽ dùng để giao việc cho một đồng đội. Trang này là danh mục đầy đủ của các cách kích hoạt đó.
Dù bạn sử dụng kênh nào, tác nhân cũng bắt tay vào việc với đầy đủ ngữ cảnh và báo cáo kết quả trở lại đúng nơi đó.
Gán một issue trên Linear
Đặt tác nhân TaskGoblin làm người được gán cho một issue trên Linear. Nó sẽ đọc tiêu đề, mô tả và các bình luận của issue, thực hiện công việc, rồi liên kết merge request trở lại issue kèm theo các cập nhật trạng thái trong quá trình thực hiện. Đây là cách kích hoạt phổ biến nhất và cũng là cách được dùng trong hướng dẫn nhanh.
Để yêu cầu nó thực hiện thêm một vòng nữa, hãy để lại bình luận trên issue mô tả thay đổi cần thiết — tác nhân sẽ tiếp tục trên cùng một nhánh.
Nhắc đến nó trong merge request hoặc pull request
Để lại một bình luận nhắc đến goblin trên một MR hoặc PR đã có sẵn:
- Trên GitLab, dùng
@taskgoblintrong một ghi chú của merge request. - Trên GitHub, dùng
@taskgoblintrong bình luận của pull request hoặc issue.
Dùng cách này để lặp lại quá trình chỉnh sửa: @taskgoblin please address the review comments (vui lòng xử lý các bình luận review) hoặc @taskgoblin add tests for the edge case in the last commit (thêm test cho trường hợp biên trong commit gần nhất). Tác nhân sẽ đẩy một commit tiếp theo lên cùng nhánh đó.
Review code tự động
Khi một merge request hoặc pull request được mở hoặc cập nhật, TaskGoblin có thể tự động review nó và đăng phản hồi dưới dạng bình luận — không cần phải nhắc đến. Điều này biến tác nhân thành người review đầu tiên cho mọi thay đổi, chứ không chỉ những thay đổi do chính nó viết ra.
Kích hoạt từ một issue
Bạn không nhất thiết phải dùng Linear để bắt đầu từ một issue:
- Trên GitHub, thêm nhãn
taskgoblinvào một issue. Nhãn này chính là yếu tố kích hoạt; các lượt nhắc đến trong bình luận của issue đó sẽ tiếp tục phiên làm việc. - Trên GitLab, gán issue cho bot
@taskgoblin, hoặc nhắc đến nó trong một bình luận trên issue.
Nhờ trong Slack
Nhắc đến goblin trong một luồng (thread) trên Slack. Nó sẽ trả lời ngay trong luồng nơi cuộc trò chuyện đang diễn ra, điều này khiến Slack trở thành kênh phù hợp khi yêu cầu bắt đầu như một cuộc thảo luận thay vì một ticket chính thức. Hãy kết nối Slack trước tại Tích hợp.
Lên lịch một tác vụ định kỳ
Đối với công việc cần diễn ra theo chu kỳ thay vì theo yêu cầu, hãy tạo một loops: một chỉ dẫn dạng văn bản tự do mà tác nhân sẽ chạy vào một thời điểm cố định hoặc lặp lại định kỳ. Mỗi lần kích hoạt hoạt động hoàn toàn giống như bất kỳ lần chạy nào khác — nó tạo ra một thread và mở một merge request — vì vậy công việc theo lịch cũng chia sẻ toàn bộ lịch sử và quy trình review giống nhau. Bạn có thể quản lý các tác vụ này tại /{organisation}/loops.
Những ứng viên phù hợp: cập nhật dependency hàng tuần, soạn thảo changelog mỗi đêm, hoặc một tác vụ dọn dẹp định kỳ.
Điểm chung của mọi cách kích hoạt
- Tác nhân luôn mang theo ngữ cảnh khi bắt đầu. Nó đọc issue, thread, hoặc lịch sử bình luận trước khi bắt tay vào việc.
- Công việc diễn ra trong sandbox, trên một nhánh có tên
ai-{issue-identifier}, không bao giờ trên máy của bạn. - Kết quả được trả về đúng nơi bạn yêu cầu. Một merge request, một bình luận review, hoặc một phản hồi trên Slack — đều xuất hiện ở đúng nơi bạn đã kích hoạt.
Để biết điều gì xảy ra giữa lúc kích hoạt và khi có merge request, hãy đọc Cách tác nhân hoạt động.