Wits Code

Dựng một dự án mới

Dùng khi bạn chưa có mã nguồn. Bạn mô tả bằng lời, Wits viết bản thiết kế, bạn duyệt, rồi Wits dựng.

Màn trống có hai lối vào: “Liên kết dự án có sẵn” và “Bắt đầu dự án mới”.

1. Bấm Task mới ở cột trái. Mở một phiên sạch, ô chat sẵn sàng nhận mô tả dự án mới.
2. Gõ mô tả rồi bấm Dự án mới. Nên nói rõ ai dùng app, làm được những việc gì, có những vai trò nào.
3. Đính kèm ảnh mẫu hoặc tệp nếu có. Dán ảnh thẳng vào ô chat, kéo thả vào khung, hoặc bấm nút ghim. Tối đa 6 mục; ảnh tối đa 3 MB, tệp chữ tối đa 200 KB; chỉ dùng cho lần dựng đang gửi.

Duyệt bản thiết kế (Cổng duyệt Spec)

Cổng hiện tên dự án, loại dự án, các vai trò người dùng và danh sách tính năng theo nhóm P1, P2, P3.

Phía dưới có phần phân tích (độ phủ, số cảnh báo) và ước lượng số Wits cho cả lần dựng, sai lệch khoảng 30%. Số Wits thật chỉ trừ theo lượng dùng khi dựng.

1. Bấm Xem landing hoặc Xem giao diện app. Xem trang giao diện dựng từ spec, hoặc màn đăng nhập, bảng điều khiển từng vai trò và màn tính năng, trước khi dựng thật.
2. Ghi yêu cầu sửa spec ở ô chat nếu chưa ưng. Lúc này ô chat là ô sửa spec. Wits sửa phần bạn yêu cầu, giữ phần còn lại, mất khoảng 1 đến 2 phút rồi mở lại cổng duyệt.
3. Bấm Duyệt & Build để dựng, hoặc Huỷ để bỏ. Trong lúc Wits đang sửa spec, nút Duyệt & Build bị khoá và nút Huỷ đổi thành Dừng sửa.

Theo dõi lúc đang dựng

Dòng việc ở giữa đi theo các bước Spec, Duyệt spec, Nền tảng, Tính năng, Kiểm cuối, Triển khai. Khi có tệp, thẻ “Đã tạo N tệp” hiện ra kèm nút Xem tất cả.

Cột thông tin bên phải có Dự án, Tiến độ, Kiểm chứng, Thay đổi, Đầu ra, Việc nền và Sự kiện gần đây. Bật hoặc tắt cột bằng nút “Ẩn cột thông tin dự án” hoặc “Hiện cột thông tin dự án” ở góc phải trên.

1. Mở ngăn Terminal nếu muốn xem chi tiết. Ngăn hiện luồng Wits đang làm, lỗi kiểm cuối và nhật ký từng pha.
2. Nhắn bổ sung ý ở ô chat. Trong lúc dựng, ô chat nhận ý kiến bổ sung. Ý kiến được lưu cho vòng bổ sung sau khi dựng xong, không phá spec đã duyệt.
3. Bấm Dừng build nếu cần dừng. Việc dừng huỷ lượt dựng đang chạy.

Liên kết dự án có sẵn

Dùng khi bạn đã có mã. Menu Liên kết dự án nằm trong ô chat và có ba cách nối: GitHub, Tải tệp .zip, Chọn thư mục trên máy.

Với dự án liên kết, Wits chỉ đọc mã để hỏi, rà soát và sửa. Wits không chạy mã trên máy bạn và không đẩy gì lên repo của bạn.

1. Chọn GitHub sau khi đã nối GitHub. Nối trước ở mục Kết nối GitHub ở cột trái (chỉ đọc). Rồi gõ repo dạng chủ/tên-repo, ví dụ congty/website, gõ nhánh nếu cần (bỏ trống là nhánh chính) và bấm Nhập dự án.
2. Chọn Tải tệp .zip. Chọn tệp .zip của dự án, tối đa 25 MB. Thư viện cài đặt, tệp build và tệp bí mật (.env) được bỏ qua. Bấm Nhập dự án.
3. Chọn Chọn thư mục trên máy. Wits lọc và đếm ngay trên máy bạn rồi hiện thẻ “N tệp · X MB”. Bấm Tải lên & mở. Mục này ẩn trên iPhone và iPad.

Hỏi, Rà soát, Sửa, Thêm tính năng trên dự án đang mở

Khi bạn mở một dự án đã có tệp từ mục Dự án, mỗi tin ở ô chat là một lượt trên chính dự án đó. Lượt này không bao giờ tạo dự án mới.

Wits đoán ý định từ câu bạn gõ và hiện ở chip phía dưới ô chat: Hỏi, Rà soát, Sửa hoặc Thêm tính năng. Bấm chip để đổi cho riêng tin đó.

Lượt Rà soát trả về “Báo cáo rà soát” với số phát hiện, chia theo bốn mức: Nghiêm trọng, Cao, Trung bình, Thấp. Mỗi phát hiện có tiêu đề, loại, vị trí tệp:dòng, phần “Vì sao” và phần “Đề xuất”. Báo cáo không có phát hiện thì hiện “Không thấy vấn đề nào trong các mục đã rà.”

1. Mở dự án ở mục Dự án. Ô nhập đổi thành “Hỏi, rà soát, sửa hoặc thêm tính năng cho dự án này”, kèm số tệp.
2. Gõ yêu cầu rồi kiểm chip ý định. Ví dụ gõ “rà soát lỗ hổng, code chết và bảo mật” thì chip tự nhận Rà soát. Enter để gửi, Shift+Enter để xuống dòng.
3. Bấm Gửi cho dự án này. Câu của bạn hiện bên phải, Wits trả lời bên trái. Lượt đang chạy hiện trạng thái “Đang rà soát dự án…” hoặc tương tự.
4. Bấm vào tên tệp:dòng trong câu trả lời. Tên tệp kèm số dòng mà Wits nhắc tới bấm được. Ngăn Tệp mở đúng tệp và tô đúng dòng. Vị trí tệp:dòng trong báo cáo rà soát cũng bấm được.
5. Bấm Sửa mục này ở một phát hiện trong báo cáo. Câu yêu cầu sửa được đưa sẵn vào ô chat với ý định Sửa. Wits không tự gửi. Bạn đọc, chỉnh nếu muốn rồi bấm Gửi cho dự án này.

Khám dự án

Mục Khám dự án ở cột trái chỉ hiện khi dự án đang mở đã có tệp. Wits chỉ đọc mã, không chạy mã của bạn.

Báo cáo hiện công nghệ dùng, số phát hiện theo mức Cao, Vừa, Thấp, và từng phát hiện thuộc nhóm Bảo mật, Thư viện, Lỗi kiểu hoặc Chất lượng, kèm “Cách sửa”.

1. Bấm Khám dự án ở cột trái. Lần đầu Wits khám luôn. Lần sau hiện báo cáo cũ, bấm Khám lại để khám mới.
2. Bấm Sửa theo kết quả khám. Nút ghi số mục sẽ sửa. Bấm nghĩa là bạn đồng ý chạy một lượt sửa, tính như một lượt sửa thường. Wits vá rồi kiểm lại.

Xem thử, gửi link test và triển khai

Góc phải trên có hai nhóm ngăn. Nhóm chính: Terminal, Thay đổi, Xem trước, Tệp. Nhóm dự án: Spec, Kiểm thử, Deploy. Bấm lại ngăn đang mở để đóng.

1. Mở ngăn Xem trước. Có bốn hàng: Giao diện, Bản chạy thử, Link chia sẻ 7 ngày, Bản triển khai. Hàng nào chưa có thì mờ đi.
2. Mở ngăn Kiểm thử, bấm Chạy thử toàn app (tab mới). Ngăn còn hiện “Kiểm chất lượng: N/M đạt” và trạng thái đạt hay chưa đạt từng việc.
3. Mở ngăn Deploy, bấm Tạo link test 7 ngày. Link không cần đăng nhập, gửi khách test thật, tự hết hạn sau 1 tuần. Ngăn hiện cả link chính và link dự phòng cùng nội dung.
4. Bấm Deploy Zeni Cloud rồi Xác nhận deploy. Nút chỉ bấm được khi bản dựng đã đạt kiểm chứng. Hộp xác nhận nhắc bạn chỉ deploy khi đã chạy thử ưng ý.

Gu, Skills và Dữ liệu của riêng bạn

Ba mục này được lưu và áp cho mọi lần dựng sau, bạn không phải nhập lại.

1. Bấm chip Gu ở ô chat. Gu mặc định là “WitsAGI” (hiện đại, tông cobalt, gọn sạch). Bạn mô tả gu bằng chữ (tối đa 2.000 ký tự), hoặc dán URL web mẫu rồi bấm Đọc gu, hoặc kéo thả ảnh chụp hay tệp .html. Wits nâng cấp từ gu mẫu, không sao chép nguyên trang. Bấm Lưu gu.
2. Mở Skills ở cột trái. Mỗi dòng một kỹ năng chuyên môn riêng, tối đa 3.000 ký tự. Bấm Lưu. Nếu có mục “Skill có điều kiện”, bấm Thêm skill có điều kiện để đặt tên, giai đoạn áp dụng và nội dung. Bật, tắt hoặc xoá từng skill; mỗi lượt dựng Wits chọn tối đa 3 skill hợp việc.
3. Mở Dữ liệu ở cột trái. Dán ghi chú dùng lặp lại cho mọi app (bảng giá, quy trình, thuật ngữ ngành), tối đa 6.000 ký tự. Khác với đính kèm trong ô chat, ghi chú ở đây lần dựng nào cũng được dùng.