Khối tính năng
Ba công cụ blocks, block_plan và block_add để agent tìm tính năng đã kiểm thử sẵn, xem trước khối sẽ thêm gì, rồi chép nó vào app/ làm code của chính app.
Khối được chép vào app, không phải thư viện. Sau khi thêm, file thuộc về app: agent sửa cho đúng spec, và manh.run không tự nâng cấp hay gỡ khối.
Các khối có sẵn:
auth: đăng nhập và vai trò.resource: bảng, API, trang danh sách và trang chi tiết từ một danh sách trường. Thêmflowđể có luồng trạng thái và bảng kéo thả,logđể có lịch sử và ghi chú.attachments(file đính kèm),search(tìm không dấu),export-excel,numbering(đánh số chứng từ),notify(thông báo).mail(mẫu email chủ app tự sửa),email-report(báo cáo gửi email định kỳ),ai-extract.ai-assistant(bản 3.0): trợ lý AI trong app. Gồm file agentapp/assistant/assistant.agent.tsvới vài công cụ mẫu để thay bằng công cụ của app, trang chat/assistant(danh sách cuộc trò chuyện, các bước gọi công cụ hiện ngay, thẻ Duyệt / Từ chối trước khi đổi dữ liệu, nút Dừng) và các route mỏng gọimanh/agent. App đã chép bản 2.x vẫn giữ nguyên file của mình và vẫn chạy; muốn lên 3.0 thì xoá file cũ rồi thêm lại khối.tasklist: trang Việc cần làm cho người dùng của app: nhận, trả lại và hoàn tất các bước có người làm trong quy trình (.bpmn), mỗi bước có form riêng hoặc nút Duyệt / Từ chối.site: website cho cửa hàng, phòng khám, có thông tin, giờ mở cửa, form liên hệ, bảng giá.web: website theo một hướng thiết kế, kèm bộ section.
blocks
Tìm khối theo nhu cầu.
- Tham số:
q: mô tả nhu cầu, ví dụ “lịch sử thay đổi” hoặc “tải file lên”;tags: lọc theo nhãn. - Trả về: mỗi khối có
id, tóm tắt, khối phụ thuộc (requires), tham số (params) và đoạn code mẫu. - Khi nào gọi: trước khi viết một tính năng hay gặp như đăng nhập, CRUD, đính kèm file, lịch sử.
block_plan
Xem trước khi thêm một khối, không ghi gì.
- Tham số:
project;id: id khối từblocks;params: tham số của khối. - Trả về: file sẽ thêm, khối phụ thuộc đã có, file trùng đường dẫn (
conflicts), lỗi tham số và các việc nối còn lại (wire). - Khi nào gọi: trước
block_add, nhất là khi app đã có nhiều file.
block_add
Thêm khối và các khối nó cần.
- Tham số: như
block_plan. - Trả về: khối đã thêm, danh sách file, cách dùng, việc nối còn lại, kết quả check.
- Khi nào gọi: sau khi
block_plankhông báo trùng file.
Trước khi chép, manh.run lưu bản sao tự động của cây file. File của app trùng đường dẫn mà khác nội dung thì không bị ghi đè: lần thêm dừng lại và báo trùng. Khối không deploy. Check cảnh báo block.unwired tới khi agent làm xong mọi việc nối, ví dụ thêm chuông thông báo vào layout.
Bước tiếp theo
- Làm một tính năng CRUD: khi nào dùng khối
resource. - Checkpoint: quay lại bản trước khi thêm khối.
- check: cảnh báo
block.unwired.
Cập nhật