Giao việc cho agent
Viết yêu cầu theo nghiệp vụ, để agent viết spec trước và chờ bạn duyệt, rồi làm từng phần có check sau mỗi phần.
Agent kết nối manh.run đọc được tài liệu framework qua công cụ framework_docs, nên bạn không cần dạy nó antd, Hono hay cấu trúc app/. Việc của bạn là nói rõ nghiệp vụ.
Viết yêu cầu
Một yêu cầu tốt trả lời ba câu: ai dùng app, họ làm gì theo thứ tự nào, và cần lưu thông tin gì.
Dùng manh.run, làm app "Đặt lịch spa".
Khách đặt lịch trên trang công khai: chọn dịch vụ, ngày giờ, để lại tên và số điện thoại.
Lễ tân xác nhận hoặc đổi giờ; mỗi kỹ thuật viên xem lịch của mình theo ngày.
Chủ spa xem doanh thu theo tuần và sửa bảng giá dịch vụ.
Lịch đã xác nhận thì nhắn email cho khách. Viết spec trước và chờ tôi duyệt.- Nói bằng việc thật: “lễ tân đổi giờ”, không “có chức năng quản lý lịch hẹn”.
- Nói luật nghiệp vụ bạn đã biết: ai được huỷ, huỷ trước bao lâu, số tiền nào phải có người duyệt.
- Bảng giá, danh mục, nhân viên là dữ liệu chủ app tự sửa, không viết cứng trong code. Nói rõ ai sửa chúng.
- Không cần chọn thư viện, đặt tên file hay mô tả màn hình từng nút. Agent đề xuất trong spec.
Duyệt spec trước khi có code
Với app mới, hoặc tính năng thêm đối tượng, vai hay nhóm màn hình, agent làm theo quy trình spec của manh.run. Nó viết PRD.md, ORCA.md (vai, đối tượng, quyền) và spec/01–04 (dữ liệu, vòng đời, API, màn hình) trong thư mục làm việc, rồi hỏi bạn một lần.
Lần hỏi đó gồm: vai và quyền của từng vai, luồng trạng thái của từng đối tượng, danh sách màn hình, màu thương hiệu, và các câu hỏi mở mà agent đã phải tự giả định. Trả lời từng điểm. Sửa ở bước này rẻ hơn nhiều so với sửa code.
Agent dùng ChatGPT hay Gemini trong trình duyệt thì không có thư mục làm việc trên máy bạn. Khi đó bảo agent đưa spec ngay trong chat, ngắn gọn, trước khi ghi file nào.
Làm từng phần
Sau khi bạn duyệt, agent làm theo thứ tự, mỗi phần qua check rồi mới sang phần sau:
- Dữ liệu: các bảng và
repository.ts(luật nghiệp vụ, vòng đời, quyền). - API: handler mỏng gọi repository, rồi deploy để chạy thử API.
- Thử: đưa dữ liệu mẫu qua API, chạy luồng chính của từng vai. Agent ghi các phép thử vào
spec/acceptance.json; từ đó mỗi lần deploy, manh.run chạy lại chúng trên một bản sao có database riêng. - Giao diện: layout và mọi trang, rồi deploy.
- Tạo checkpoint.
Bạn xem app trong bảng điều khiển sau mỗi phần. App xong khi luồng chính của từng vai chạy trên bản đã deploy, và bạn đã xem các màn hình chính trên điện thoại lẫn máy tính.
Yêu cầu sửa
- Một lần một việc, nói chỗ và kết quả mong muốn: “Ở danh sách đề xuất, thêm cột phòng ban và bộ lọc theo phòng ban.”
- Chỉ đúng chỗ trên màn hình: bấm Chọn phần tử trên preview, bấm vào phần cần sửa rồi Sao chép prompt. Prompt có tên file và số dòng.
- Thay đổi lớn: bảo agent tạo checkpoint trước, và sửa spec trước khi sửa code.
Cần biết
- Nói “làm hết luôn, không cần hỏi” thì agent ghi các quyết định vào spec rồi làm tiếp, không dừng ở bước duyệt.
- Agent không đọc được đoạn chat cũ của bạn. Mở chat mới thì bảo agent đọc lại spec trong thư mục làm việc, hoặc dán lại phần cần thiết.
Bước tiếp theo
- App đầu tiên — ví dụ đầy đủ với app Duyệt mua sắm.
- Đọc lỗi check — khi agent sửa vòng vòng một lỗi.
- llms.txt và bản Markdown — cho agent đọc docs khi chưa kết nối MCP.