Bạn cần Node.js 18+, JDK 17+ và dự án Java Spring Boot dùng Maven hoặc Gradle. Xem Cài đặt nếu chưa chuẩn bị môi trường.
Cách 1: Chạy trực tiếp
Không cần trình AI:
npx -y archscribe doctor /path/to/your-spring-boot-project
npx -y archscribe run /path/to/your-spring-boot-project
npx -y archscribe dashboard
doctor kiểm tra môi trường và cấu trúc dự án. run tạo đầu ra mặc định trong <project>/archscribe-output/. dashboard mở giao diện cục bộ. Nếu được yêu cầu kích hoạt, dùng npx -y archscribe login với license key hợp lệ.
Cách 2: Dùng với trình AI
npx -y archscribe setup
Chọn trình AI đã cài trên máy rồi khởi động lại trình đó. Mở dự án Spring Boot và yêu cầu: “Hãy dùng Archscribe để phân tích dự án này, tạo bản thảo tài liệu và cho tôi biết những phần cần rà soát.” Agent có thể gọi check_environment rồi analyze_project, là tool chạy pipeline đầy đủ. Chỉ dùng các tool chuyên biệt khi cần thao tác chi tiết hơn.
Nếu bạn muốn thêm cấu hình và skill Claude Code vào chính dự án:
npx -y archscribe scaffold /path/to/your-spring-boot-project
scaffold không bắt buộc cho kết nối MCP ở phạm vi người dùng đã đăng ký bằng setup.
Sau khi chạy
Đọc báo cáo, mở sơ đồ Draw.io và kiểm tra các ca sử dụng với mã nguồn thực. Xem Quy trình và đầu ra để biết file nào được tạo và những giới hạn cần lưu ý.