ship-tasks là quy trình CyberOS duy nhất đưa mọi đơn vị công việc từ đặc tả đến bàn giao. Không có quy trình riêng cho tính năng mới so với củng cố hay sửa lỗi — mọi công việc đều đi qua cùng một hệ thống. Một nhiệm vụ class: product và một nhiệm vụ class: improvement tuân theo các quy tắc vòng đời giống hệt nhau, chia sẻ một BACKLOG.md, và cả hai đều yêu cầu cùng hai gate chấp nhận bắt buộc của con người. Quy trình nằm trong .cyberos/cuo/ship-tasks.md bên trong bất kỳ kho mã đã khởi tạo CyberOS nào và cũng được đóng gói bên trong kỹ năng plugin /ship-tasks.
10 trạng thái nhiệm vụ
Một nhiệm vụ mang chính xác một trạng thái tại bất kỳ thời điểm nào. Các trạng thái tạo thành một vòng đời tuyến tính đơn với hai lối thoát.
Định nghĩa có thẩm quyền của tất cả các trạng thái nằm trong
.cyberos/cuo/STATUS-REFERENCE.md.
Chỉ mục BACKLOG.md
docs/tasks/BACKLOG.md là chỉ mục duy nhất cho mọi công việc. Một file bao trùm mọi module và mọi lớp nhiệm vụ — không bao giờ có file backlog thứ hai.
Để thêm một nhiệm vụ, thêm một dòng vào phần module của bạn:
class: improvement, thêm tag (improvement):
status: của file nhiệm vụ là bản ghi chính thức. BACKLOG.md là chỉ mục được giữ đồng bộ với nó. Không bao giờ cập nhật một mà không cập nhật cái kia.
Cách agent chọn nhiệm vụ
Khi bạn kích hoạtship-tasks, agent:
- Đọc
BACKLOG.mdvà tìm tất cả các nhiệm vụ cóstatus: ready_to_implement - Lọc bỏ các nhiệm vụ có danh sách
depends_onchứa bất kỳ nhiệm vụ nào chưa ở trạng tháidone - Chọn nhiệm vụ đủ điều kiện đầu tiên (theo thứ tự trong
BACKLOG.md) - Chuyển sang
implementingvà bắt đầu công việc
depends_on và trạng thái của các nhiệm vụ phụ thuộc nếu điều này xảy ra.
Thất bại và trả lại
Không có trạng thái thất bại cuối cùng trong vòng đời CyberOS. Khi một nhiệm vụ thất bại ở bất kỳ bước nào trong chu trình, quy trình sẽ trả lại:- Trạng thái nhiệm vụ trở về
ready_to_implement routed_back_counttrong frontmatter nhiệm vụ tăng thêm 1- Lý do được ghi trong một dòng kiểm toán
ship-tasks tiếp theo, nhiệm vụ được lấy lại từ đầu. Trường routed_back_count là tín hiệu cho bạn rằng một nhiệm vụ đã lặp lại — nếu con số cao, đặc tả hoặc cách tiếp cận triển khai có thể cần xem xét lại.
Gates
Gates là lớp xác minh máy giữa triển khai và xem xét của con người. Chúng phải xanh trước khi agent có thể yêu cầu bạn xem xét tại một trong hai human gate. Các lệnh gate của kho mã được lưu trong.cyberos/gates.env và chạy bằng:
gates.env. Chỉnh sửa file đó nếu các lệnh được tự động phát hiện là sai. Một gates.env chuẩn trông như sau:
ship-tasks. Bạn cũng có thể chạy chúng thủ công bất kỳ lúc nào để kiểm tra sức khỏe kho mã.
ship-tasks là độc lập với agent — cùng một quy trình, cùng bộ chạy gate, và cùng hai human gate hoạt động với Claude, Codex, Cursor, Gemini, Grok, hoặc bất kỳ agent nào có thể đọc file và chạy lệnh shell. Trỏ agent đến AGENTS.md hoặc .cyberos/AGENT-ENTRY.md và nó sẽ điều khiển quy trình đúng cách.Human Gates
Hiểu chính xác cần kiểm tra gì tại Gate 1 và Gate 2, và cách phê duyệt hoặc trả lại.
Ship Your First Task
Hướng dẫn từng bước từ viết file nhiệm vụ đến hoàn thiện thay đổi.