Cho trợ lý AI đọc và cập nhật bảng công việc của nhóm

Khi đã sửa xong code mà thông tin trên phiếu công việc (ticket) chưa được cập nhật, người mở ticket sau đó vẫn chỉ thấy phần mô tả ban đầu và phải hỏi lại chuyện gì đã thay đổi, dù ảnh chụp màn hình kết quả đã được lưu sẵn đâu đó. Khi một agent lập trình, tức trợ lý AI có thể đọc và sửa code, làm một phần công việc ấy, agent cũng cần để lại lời giải thích, nghĩa là phải vào được đúng hệ thống mà cả nhóm dùng để theo dõi công việc. Với những nhóm mình nghĩ đến khi làm công cụ này, hệ thống đó là Jira Server do nhóm tự vận hành.

Mình tạo ra Jira CLI để những thao tác thường ngày với ticket có thể làm ngay trong cửa sổ dòng lệnh (terminal), nơi việc sửa code vốn đang diễn ra. Có Jira CLI, mình hoặc agent làm cùng mình có thể đọc nội dung một công việc trên Jira (issue), xem issue đang ở trạng thái nào, rồi chuẩn bị bình luận hoặc đính kèm kết quả kiểm tra. Các lệnh trả về kết quả có cấu trúc để agent đọc được, và mỗi lệnh gọi thẳng đến Jira rồi thoát, nên agent dùng được ngay mà không phải khởi động trước một máy chủ MCP, tức tiến trình kết nối chạy riêng mà nhiều hệ thống agent vẫn dùng cho kiểu truy cập này.

Nói đơn giản, Jira CLI là một nhóm lệnh ngắn gọn cho việc xử lý ticket: mine tìm các issue của bạn, show mở nội dung một issue, còn comment chuẩn bị một cập nhật. Quanh mấy lệnh đó có vài phần hỗ trợ. Các hồ sơ kết nối (profile) có tên giữ thông tin cho từng kết nối, với thông tin đăng nhập mặc định nằm trong keychain của hệ điều hành; các thay đổi mặc định chỉ chạy thử, nên chưa có gì được ghi lên Jira cho đến khi bạn yêu cầu; và một bộ hướng dẫn tùy chọn cho agent (skill) giúp agent biết cách thiết lập và làm theo quy trình. Đây là dự án độc lập, dành cho các nhóm dùng Jira Server tự vận hành.

Lúc agent nhận ticket

Trước khi sửa code, agent cần đọc xem ticket yêu cầu gì. mine liệt kê các issue chưa được giải quyết của bạn, còn show mở nội dung một issue, nên agent nắm được việc cần làm trước khi đụng vào code hay ghi bất cứ điều gì lên Jira.

Lúc chuẩn bị gửi cập nhật

Sửa xong, agent soạn lời giải thích bằng comment. Vì các thay đổi mặc định chỉ chạy thử, lệnh này hiện bình luận ra cho bạn xem chứ chưa đăng lên, nhờ vậy bạn kiểm tra được đó có đúng issue cần cập nhật không và câu chữ có phản ánh đúng điều đã xảy ra không. Sau khi bạn kiểm tra bản xem trước và cho phép gửi, agent mới nên chạy lại lệnh với --perform-action để đăng bình luận. Nếu ảnh hoặc nhật ký giúp người khác lặp lại một bước kiểm tra, bạn có thể đặt chúng ngay cạnh lời giải thích, bằng cách chèn ảnh vào nội dung bình luận hoặc đính kèm dưới dạng tệp.

Lúc người tiếp theo mở ticket

Với người nhận bàn giao, biết có thể thử thay đổi ở đâu thường hữu ích hơn thêm một thông báo thành công ngắn, và bài viết về bàn giao đi sâu hơn vào chuyện một cập nhật như vậy nên có những gì.

Cách mình làm Jira CLI

Mình phụ trách chính việc phát triển Jira CLI và đặt ra quy trình agent phải theo: đọc ticket, xem trước cập nhật, rồi chỉ thực thi những thay đổi đã được người dùng cho phép. Agent lập trình đảm nhiệm một phần đáng kể việc triển khai, còn mình rà lại các chỉnh sửa trong code và tự chạy thử các lệnh để xem chúng có đi đúng quy trình đó không. Nếu bạn định làm một công cụ tương tự cho agent, mình nghĩ nên để mọi thao tác ghi mặc định chỉ là bản xem trước, còn việc gửi thật thì phải đi qua một cờ được ghi rõ.

npm install -g @khanglvm/jira-cli

jira-cli profile add work \
  --base-url https://jira.example.com \
  --username "$JIRA_USERNAME" \
  --password "$JIRA_PASSWORD" \
  --default

jira-cli mine --max-results 10

jira-cli show PROJ-123
jira-cli comment PROJ-123 --body "Investigating the login issue."

jira-cli comment PROJ-123 \
  --body "Investigating the login issue." \
  --perform-action

jira-cli search --reported --order-by "priority DESC"

npx skills add khanglvm/jira-cli --skill jira-cli -y