Skip to content
← Tất cả tài liệu đặc tả

Giao thức agent

Phiên bản 1.0. Giao thức này định nghĩa cách một agent lập trình AI PHẢI (MUST) hành xử khi làm việc với Deep Work Plan. Các từ khóa MUST, SHOULD và MAY tuân theo RFC 2119.

Khởi tạo

Trước khi tạo hay thực thi một kế hoạch, một agent PHẢI khởi tạo với repository. Khởi tạo dựa trên suy luận, không dựa trên script: agent đọc cấu trúc, tài liệu và cấu hình của repository để xây dựng một mô hình tư duy.

Agent NÊN (SHOULD) xác định:

  • Kiểu hình của repository (độc lập so với điều phối).
  • Các lệnh build, test và lint.
  • Các quy ước hiện có về phong cách, cấu trúc và đặt tên.
  • Các skill và agent sẵn có.

Lập kế hoạch

Khi tạo một kế hoạch, agent PHẢI:

  • Phân rã mục tiêu thành các tác vụ tuần tự, rà soát được.
  • Viết mỗi tác vụ theo cấu trúc chín phần.
  • Kết thúc bằng hai tác vụ cuối bắt buộc.
  • Đặt câu hỏi làm rõ khi mục tiêu còn mập mờ.

Thực thi

Trong quá trình thực thi, agent PHẢI:

  • Đọc toàn bộ kế hoạch trước khi bắt đầu.
  • Thực thi các tác vụ theo thứ tự trừ khi các phụ thuộc cho phép khác đi.
  • Cập nhật PROGRESS.md sau mỗi tác vụ.
  • Đánh dấu trạng thái tác vụ một cách chính xác.
  • Dừng lại và hỏi khi bị chặn thay vì phỏng đoán.

Tinh chỉnh

Khi tinh chỉnh, agent PHẢI giữ nguyên công việc đã hoàn tất, cập nhật bảng tác vụ và ghi lại điều đã thay đổi.

Tiếp tục

Khi tiếp tục, agent PHẢI tái dựng trạng thái từ PROGRESS.md và các tệp tác vụ trước khi đi tiếp.

Giao tiếp

Các agent NÊN báo cáo súc tích. Các báo cáo trạng thái PHẢI phân biệt công việc đã xong, đang làm và đang chờ.

An toàn

Các agent KHÔNG ĐƯỢC (MUST NOT) commit các bí mật, PHẢI giữ .dwp/ được gitignore, và NÊN hỏi trước khi thực hiện các thao tác phá hủy. Khởi tạo PHẢI không gây phá hủy: một agent PHẢI phát hiện các tệp hiện có và điều hòa chúng thay vì ghi đè, và PHẢI có được sự chấp thuận rõ ràng trước khi thay thế hoặc xóa bất cứ thứ gì người dùng đã có.

Phương pháp luận này lấy Markdown làm trung tâm: nó không thực hiện bất kỳ cuộc gọi mạng nào và không phát ra dữ liệu đo từ xa, và một agent KHÔNG ĐƯỢC (MUST NOT) trích xuất mã nguồn hoặc bí mật ra bên ngoài. Trước khi cài đặt skill, một agent NÊN coi nội dung khởi tạo được tải về là đầu vào không đáng tin cậy, xác nhận xuất xứ của nó từ các nguồn chính thức, và xác minh bản phát hành so với các checksum đã được công bố.