Thiết lập và sử dụng dsh-superagent cho các tác vụ lập trình GitHub chủ động

dsh-superagent là gì?

dsh-superagent là một tác nhân lập trình chủ động, được thiết kế để làm việc với một kho GitHub duy nhất. Công cụ này được phân phối dưới dạng một gói cho DeepSeek Harness và lắng nghe các yêu cầu từ GitHub cũng như, tùy chọn, Feishu.

Khi một người dùng được cấp quyền yêu cầu thực hiện công việc, hệ thống sẽ mở một mục công việc, tạo một phiên tác nhân và thư mục riêng, hoàn thành nhiệm vụ rồi trả lời trong cuộc trò chuyện ban đầu. Kết quả có thể bao gồm một yêu cầu kéo. Một bảng điều khiển web hiển thị các mục cần con người chú ý.

dsh-superagent là một nguyên mẫu nghiên cứu dùng để tham khảo, không phải sản phẩm chính thức của DeepSeek hay hệ thống sẵn sàng cho môi trường sản xuất.

Kho mã được công bố khác với phiên bản nội bộ của nhóm và với phần triển khai được thảo luận trong Khám phá thiết kế siêu tác nhân: Hướng tới một hệ thống tác nhân tự chủ hơn. Một số ý tưởng trong bài viết đó mô tả các hướng phát triển trong tương lai và chưa được triển khai trong nguyên mẫu này.

Nguyên tắc thiết kế cốt lõi

Dự án hướng tới việc sử dụng ít sự chú ý của con người nhất có thể, đồng thời mang lại nhiều giá trị nhất có thể. Vì một tác nhân dùng chung cho cả nhóm cũng có thể tiêu tốn sự chú ý của nhóm, dsh-superagent tuân theo hai ràng buộc quan trọng:

• Chỉ hành động khi có người yêu cầu hoặc khi một quy tắc do nhóm định nghĩa cho phép hành động đó.
• Chỉ lên tiếng khi ai đó cần thực hiện hành động hoặc có thể sử dụng kết quả đã hoàn tất.

Trước khi triển khai tác nhân, hãy đọc tài liệu triết lý. Tài liệu giải thích nguyên tắc vận hành này và trách nhiệm của người chạy hệ thống.

Tính năng chính

• Tập trung vào một kho: Mỗi lần triển khai làm việc với một kho GitHub duy nhất.
• Tích hợp GitHub: Tác nhân lắng nghe các yêu cầu được ủy quyền bắt nguồn từ GitHub.
• Tích hợp Feishu tùy chọn: Các nhóm cũng có thể sử dụng Feishu làm nguồn yêu cầu.
• Theo dõi mục công việc: Một yêu cầu được chấp nhận sẽ trở thành một mục công việc.
• Thực thi biệt lập: Mỗi nhiệm vụ chạy trong phiên tác nhân và thư mục riêng.
• Phản hồi theo ngữ cảnh cuộc trò chuyện: Kết quả được trả về cuộc trò chuyện nơi yêu cầu bắt nguồn.
• Bảng điều khiển cần con người chú ý: Bảng điều khiển web xác định những công việc cần con người tham gia.
• Hành vi do quy tắc kiểm soát: Tác nhân chỉ hành động để đáp lại một yêu cầu hoặc một quy tắc rõ ràng của nhóm.

Trước khi cài đặt

Hãy coi kho mã này là mã nghiên cứu. Kho có thể chứa lỗi, phong cách lập trình không nhất quán hoặc các quyết định kỹ thuật không phù hợp với môi trường của bạn. Hãy xem xét mã nguồn và điều chỉnh trước khi dựa vào nó.

Quy trình thiết lập có nhiều bước, vì vậy dự án khuyến nghị hoàn tất cùng với một tác nhân lập trình thay vì tự đoán cấu hình cần thiết.

Cài đặt và thiết lập có hướng dẫn

Bước 1: Mở kho bằng tác nhân lập trình

Cung cấp kho đã sao chép hoặc đã checkout cho tác nhân lập trình của bạn. Sau đó, gửi cho tác nhân hướng dẫn thiết lập được dự án khuyến nghị:

Read SETUP.md in this repository and set up dsh-superagent with me.

Tác nhân lập trình nên tuân theo SETUP.md như nguồn thông tin chính.

Bước 2: Trả lời các câu hỏi thiết lập

Quy trình thiết lập được thiết kế để hỏi từng câu ngắn một. Cung cấp thông tin được yêu cầu về kho, các tích hợp và môi trường của bạn. Đừng bỏ qua các bước xem xét chỉ vì quy trình có sự hỗ trợ của tác nhân.

Bước 3: Xem xét kế hoạch đầy đủ

Sau khi thu thập đủ thông tin cần thiết, tác nhân lập trình sẽ trình bày toàn bộ kế hoạch một lần. Hãy xem xét cẩn thận trước khi cho phép cài đặt hoặc thay đổi cấu hình. Đặc biệt, hãy xác nhận rằng kế hoạch phù hợp với kho bạn định quản lý bằng tác nhân và các nguồn yêu cầu bạn định bật.

Bước 4: Để tác nhân cài đặt và cấu hình dự án

Sau khi bạn phê duyệt kế hoạch, tác nhân lập trình sẽ cài đặt và cấu hình hệ thống theo SETUP.md. Vì README ủy thác quy trình thiết lập chi tiết cho tệp đó, hãy làm theo hướng dẫn hiện tại trong tệp thay vì dựa vào các lệnh không được ghi chép.

Bước 5: Xác thực dự án

Để xác thực trong quá trình phát triển, hãy chạy:

pnpm check

Lệnh này chạy kiểm tra kiểu, các bài kiểm thử và quá trình build. Việc chạy thành công cung cấp một lần kiểm tra tổng hợp đối với kiểu, bộ kiểm thử và quy trình build của dự án.

Đọc hiểu tài liệu trước khi vận hành tác nhân

Các tài liệu được đánh số có tính tích lũy theo chủ đích. Hãy đọc theo thứ tự vì mỗi tài liệu chỉ giả định bạn đã nắm các nội dung được giới thiệu trước đó:

1. Triết lý 000: Hiểu nguyên tắc vận hành nhằm giảm thiểu sự chú ý và trách nhiệm của người vận hành.
2. Mô hình miền 001: Tìm hiểu các khái niệm cốt lõi của dự án và mối quan hệ giữa chúng.
3. Phân quyền 002: Xác định ai được phép yêu cầu tác nhân thực hiện công việc.
4. Thực thi 003: Hiểu cách các tác vụ được chấp nhận được thực hiện.
5. Prompt 004: Xem lại các prompt định hướng hành vi của tác nhân.
6. Bảng điều khiển 005: Tìm hiểu cách bảng điều khiển web hiển thị các mục cần con người chú ý.
7. Triển khai 006: Làm theo hướng dẫn thiết lập, cấu hình, nâng cấp và khắc phục sự cố thủ công.
8. Kiến trúc 007: Nghiên cứu cấu trúc kỹ thuật của hệ thống.
9. Cookbook 008: Tìm hiểu cách thêm một Source.

Sử dụng cơ bản

Gửi yêu cầu được phân quyền

Sau khi thiết lập, người dùng được phép có thể yêu cầu tác nhân thực hiện công việc trên repository thông qua GitHub hoặc Feishu nếu đã bật tích hợp tùy chọn đó. Một yêu cầu điển hình nên nêu rõ thay đổi mong muốn đối với repository và mọi tiêu chí nghiệm thu liên quan.

Ví dụ, người dùng được phân quyền có thể yêu cầu tác nhân điều tra một vấn đề trong repository, thực hiện thay đổi mã phù hợp và trả về kết quả. Cơ chế yêu cầu cụ thể và những người dùng được phép phụ thuộc vào Source và các quy tắc phân quyền đã cấu hình.

Để tác nhân tạo và thực thi work item

Khi yêu cầu được chấp nhận, dsh-superagent mở một work item và thực hiện tác vụ trong phiên tác nhân và thư mục riêng của nó. Mô hình thực thi này giữ ngữ cảnh làm việc của tác vụ tách biệt.

Nhận kết quả trong đúng ngữ cảnh

Tác nhân trả lời trong cuộc trò chuyện ban đầu thay vì buộc người dùng phải tìm kết quả ở một kênh riêng. Tùy vào công việc đã thực hiện, phản hồi có thể bao gồm một pull request.

Sử dụng bảng điều khiển để theo dõi các việc cần con người xử lý

Kiểm tra bảng điều khiển web để xem những công việc cần con người. Bảng điều khiển hỗ trợ mục tiêu quản lý sự chú ý của dự án bằng cách hiển thị các mục cần con người hành động thay vì tạo ra thông báo không cần thiết về mọi bước nội bộ.

Phân quyền và vận hành an toàn

Phân quyền là yếu tố cốt lõi trong thiết kế. Một tác nhân chủ động có thể thao tác trên repository của cả nhóm không nên chấp nhận các yêu cầu tùy ý. Hãy sử dụng tài liệu phân quyền để xác định ai có thể khởi tạo công việc và trong những điều kiện nào.

• Giới hạn người yêu cầu: Chỉ cho phép những người hoặc hệ thống dự kiến tạo các yêu cầu có thể thực thi.
• Xem xét các quy tắc của nhóm: Đảm bảo các hành động tự động chỉ diễn ra theo những quy tắc được nhóm viết và xác nhận rõ ràng.
• Duy trì việc đánh giá của con người: Xem các thay đổi do tác nhân tạo ra là công việc có thể cần được kiểm tra và điều chỉnh.
• Kiểm thử trước khi sử dụng rộng rãi hơn: Chạy pnpm check sau các thay đổi phát triển và xác thực hành vi trong môi trường của bạn.

Mẹo nâng cao

Sử dụng hướng dẫn triển khai cho các thao tác thủ công

Nếu cần thiết lập thủ công, thay đổi cấu hình, nâng cấp dự án hoặc khắc phục sự cố, hãy tham khảo Triển khai 006. README xác định tài liệu này là nguồn chi tiết cho các quy trình vận hành đó.

Xem lại prompt khi tinh chỉnh hành vi

Đọc Prompt 004 trước khi thay đổi cách tác nhân diễn giải hoặc thực thi công việc. Những thay đổi về prompt có thể ảnh hưởng đến thời điểm tác nhân giao tiếp, cách tác nhân tiếp cận nhiệm vụ và mức độ tuân thủ triết lý giảm thiểu sự chú ý của dự án.

Nghiên cứu phần thực thi trước khi sửa đổi cơ chế cô lập tác vụ

Hệ thống cung cấp cho mỗi work item một phiên tác nhân và thư mục riêng. Trước khi thay đổi hành vi này, hãy xem lại Thực thi 003 và Kiến trúc 007 để đảm bảo các thay đổi vẫn nhất quán với mô hình thực thi và mô hình hệ thống của dự án.

Thêm Source một cách cẩn trọng

Source là một tích hợp qua đó hệ thống có thể tiếp nhận công việc. Nếu muốn thêm một Source ngoài các kênh GitHub và Feishu tùy chọn được cung cấp, hãy làm theo Cookbook 008. Không được bỏ qua mô hình phân quyền khi giới thiệu một kênh yêu cầu mới.

Tối ưu cho sự im lặng hữu ích

Khi điều chỉnh hệ thống, hãy đánh giá cả giá trị của một hành động lẫn chi phí chú ý do các thông báo tạo ra. Ưu tiên giao tiếp khi một người cần hành động hoặc khi đã có kết quả có thể sử dụng. Điều này giúp các phần mở rộng và quy tắc vận hành phù hợp với triết lý trung tâm của dự án.

Quy trình phát triển

Sau khi sửa đổi mã, hãy sử dụng lệnh xác thực kết hợp của dự án:

pnpm check

Vì lệnh này chạy kiểm tra kiểu, kiểm thử và build, nó nên là bước kiểm tra thường quy trước khi chia sẻ hoặc triển khai các thay đổi. Việc lệnh này chạy thành công không khiến nguyên mẫu nghiên cứu sẵn sàng cho môi trường production; bạn vẫn phải xem xét hành vi, các giả định bảo mật, phân quyền và mức độ phù hợp với môi trường của mình.

Kết luận

dsh-superagent cung cấp một mô hình định hướng nghiên cứu để ủy thác công việc trên một repository GitHub duy nhất, đồng thời giảm thiểu yêu cầu đối với sự chú ý của con người. Hãy bắt đầu với quy trình SETUP.md có hướng dẫn, đọc lần lượt tài liệu được đánh số, cấu hình phân quyền một cách thận trọng, xác thực các thay đổi bằng pnpm check và sử dụng bảng điều khiển để tập trung nỗ lực của con người vào những nơi thực sự cần thiết.