Hai vai trò trong mỗi bước
Trước khi bắt đầu, hãy hiểu sự phân chia:
Agent không bao giờ push, merge, deploy, hoặc đánh dấu công việc của chính nó là done.
1
Đảm bảo CyberOS đã được cài đặt
Nếu bạn chưa cài đặt CyberOS, hãy làm theo Hướng dẫn cài đặt trước. Cài đặt là thiết lập một lần cho mỗi kho mã và mất chưa đến hai phút.Để xác nhận kho mã của bạn đã sẵn sàng, chạy:Kết quả sẽ hiển thị
READY.2
Viết file nhiệm vụ
Tạo một file tại Dùng
docs/tasks/<module>/task-<MODULE>-<NNN>-<slug>.md. Bạn có thể sao chép mẫu từ .cyberos/cuo/templates/ hoặc bắt đầu từ khung này:class: product cho các năng lực mới và class: improvement cho việc củng cố, refactor, hoặc sửa lỗi.3
Thêm nhiệm vụ vào BACKLOG.md
Mở Với các nhiệm vụ
docs/tasks/BACKLOG.md và thêm một dòng trong phần module của bạn:class: improvement, thêm tag (improvement) vào dòng đó. Trường status: trong file nhiệm vụ là bản ghi chính thức; BACKLOG.md là chỉ mục được giữ đồng bộ.4
Kích hoạt agent
Với Claude plugin đã cài, gõ dòng này trong phiên làm việc với kho mã:Không có plugin, dán prompt này cho bất kỳ agent nào:Agent chọn nhiệm vụ đủ điều kiện đầu tiên (tôn trọng
depends_on), chuyển sang implementing, viết mã, chạy bash .cyberos/cuo/gates/run-gates.sh, tự xem xét đầu ra, và tiến tới reviewing — sau đó dừng lại và chờ bạn.5
Gate 1 — Chấp nhận xem xét
Agent trình bày:
- Những gì nó đã xây dựng (tóm tắt các thay đổi)
- Các phát hiện xem xét (thay đổi ánh xạ tới từng điều khoản quy phạm như thế nào)
- Bất kỳ sai lệch hoặc câu hỏi mở nào
- Để phê duyệt: nói
approved(hoặc tương đương). Agent chuyển nhiệm vụ sangready_to_test. - Để trả lại: đưa một câu giải thích điều gì sai, ví dụ: “Điều khoản 2 chưa được triển khai — endpoint trả về 400, không phải 429.” Agent đưa nhiệm vụ trở lại
ready_to_implementvàrouted_back_counttăng thêm 1.
6
Gate 2 — Chấp nhận cuối cùng
Agent trình bày:
- Bằng chứng kiểm thử — đầu ra gate, chứng minh cho mỗi tiêu chí chấp nhận
- Các gate đều xanh (build, lint, test đều đạt)
- Để phê duyệt: nói
done(hoặc tương đương). Trạng thái nhiệm vụ trở thànhdone. - Để trả lại: đưa một câu giải thích điều gì sai.
routed_back_counttăng thêm một lần nữa.
7
Hoàn thiện thay đổi
Khi bạn đã chấp nhận tại Gate 2, thay đổi là của bạn để hoàn thiện:Agent không bao giờ commit, push, merge, hoặc deploy thay bạn. Đó luôn là bước của bạn.
Khi có sự cố
Gate thất bại — agent trình bày đầu ra đỏ
Gate thất bại — agent trình bày đầu ra đỏ
Agent phải sửa các gate thất bại và chạy lại chúng trước khi có thể yêu cầu bạn xem xét ở một trong hai gate. Nếu agent yêu cầu bạn chấp nhận với đầu ra gate đỏ, hãy từ chối. Gửi trả lại với: “Các gate chưa xanh. Sửa và chạy lại trước khi yêu cầu xem xét.”
Bản thân nhiệm vụ đã sai
Bản thân nhiệm vụ đã sai
Trả lại tại một trong hai gate với một câu giải thích điều mà nhiệm vụ đã sai. Trường
routed_back_count trong frontmatter nhiệm vụ theo dõi có bao nhiêu vòng làm lại đã xảy ra. Không có giới hạn số lần bạn có thể trả lại.Không chắc một trạng thái có nghĩa là gì
Không chắc một trạng thái có nghĩa là gì
.cyberos/cuo/STATUS-REFERENCE.md định nghĩa toàn bộ 10 trạng thái, ai có thể đặt từng trạng thái, và các quy tắc chuyển đổi là gì. Khi nghi ngờ, hãy kiểm tra file đó trước.Bản thân CyberOS đã lỗi thời
Bản thân CyberOS đã lỗi thời
Chạy lại trình cài đặt để cập nhật:Trình cài đặt áp dụng các bản cập nhật cho
.cyberos/ và không bao giờ đụng đến các nhiệm vụ hiện có hoặc BACKLOG.md của bạn.