Xây dựng bản sao ứng dụng theo phương pháp Clean-Room với 11 kỹ năng Claude

Replica thực hiện những gì

Replica là một tập hợp gồm mười một skill Claude, giúp bạn xây dựng lại chức năng và luồng người dùng của một ứng dụng từ đầu. Quy trình bao quát việc nghiên cứu, kiến trúc, thiết kế, triển khai, dịch vụ backend, kiểm thử, so sánh, định vị, xây dựng thương hiệu, chuẩn bị ra mắt và triển khai.

Công cụ được thiết kế cho việc tái dựng trong môi trường sạch. Dự án nghiên cứu ứng dụng thực hiện những gì, chứ không phải ứng dụng sở hữu những gì. Bạn có thể tái tạo các tính năng và mẫu tương tác, nhưng không nên sao chép mã nguồn, tài sản độc quyền, logo, nhãn hiệu, văn bản, API riêng tư hoặc nội dung được bảo hộ.

Nó xây dựng lại những gì ứng dụng thực hiện, không bao giờ là những gì ứng dụng sở hữu.

Repository được cấp phép MIT, không yêu cầu đăng ký hoặc API key, đồng thời bao gồm các công cụ Python dùng thư viện chuẩn và không kết nối đến mạng bên ngoài.

Cài đặt các skill

Cài đặt thông qua Claude

Dán URL repository và hướng dẫn cài đặt vào Claude:

https://github.com/Jakeschincariol/replica-skill

install skill

Cài đặt dưới dạng plugin Claude Code

Trong Claude Code, thêm marketplace rồi cài đặt plugin:

/plugin marketplace add Jakeschincariol/replica-skill
/plugin install replica-skill@replica-skill

Khi được cài đặt dưới dạng plugin, Claude Code thêm namespace cho các skill. Ví dụ, skill recon sẽ xuất hiện dưới dạng /replica-skill:replica-recon.

Sao chép các thư mục thủ công

Để sử dụng các tên skill ngắn như /replica-recon, hãy clone repository rồi sao chép các thư mục skill vào thư mục skill Claude dùng chung:

git clone https://github.com/Jakeschincariol/replica-skill.git
cp -r replica-skill/replica-* ~/.claude/skills/

Đối với skill chỉ dùng trong dự án, hãy sao chép các thư mục tương tự vào thư mục .claude/skills/ của repository. Bạn cũng có thể dán từng tệp SKILL.md vào một cuộc trò chuyện Claude để chạy tệp đó như một chế độ, dù cách này không bao gồm các công cụ Python.

Các công cụ yêu cầu Python 3.8 trở lên. Không cần cài đặt package nào bằng pip.

Tìm hiểu quy trình gồm mười một skill

Quy trình được khuyến nghị chạy các skill theo thứ tự. Mỗi skill đọc các artifact do skill trước đó ghi vào thư mục replica/ của dự án.

recon -> architect -> design -> build -> backend -> test -> diff -> entrepreneur -> brand -> launch -> deploy

• /replica-recon phân tích ngược màn hình, luồng, component và mô hình dữ liệu được suy luận từ các nguồn được phép.
• /replica-architect lập kế hoạch cho công nghệ, schema cơ sở dữ liệu, API và thứ tự triển khai.
• /replica-design chuyển các quan sát trực quan thành design token cho màu sắc, kiểu chữ, khoảng cách và component bằng tài sản của riêng bạn.
• /replica-build triển khai ứng dụng theo từng màn hình dựa trên bản đồ recon.
• /replica-backend bổ sung tính năng xác thực, cơ sở dữ liệu, thanh toán và tích hợp.
• /replica-test kiểm thử luồng người dùng, trường hợp biên và lỗi.
• /replica-diff so sánh bản tái dựng với bản gốc và báo cáo mức độ tương đồng cùng các chức năng còn thiếu.
• /replica-entrepreneur phân tích đánh giá thực tế của người dùng để xác định khiếu nại, cơ hội sản phẩm và hướng định vị.
• /replica-brand tạo tên, nhận diện hình ảnh và giọng thương hiệu riêng, sau đó kiểm tra codebase để tìm dấu vết còn sót lại của thương hiệu gốc.
• /replica-launch chuẩn bị landing page, bảng giá và thông tin đăng tải trên App Store hoặc Google Play.
• /replica-deploy thực hiện đánh giá trước khi phát hành và hỗ trợ đưa sản phẩm lên domain riêng.

Thực hiện một dự án hoàn chỉnh

1. Recon ứng dụng mục tiêu

Bắt đầu với /replica-recon và cung cấp URL của ứng dụng hoặc các nguồn nghiên cứu được phép khác. Skill này có thể sử dụng các trang công khai, trung tâm trợ giúp, trang giá, thông tin trên cửa hàng ứng dụng, hướng dẫn công khai, ảnh chụp màn hình và tài khoản của chính bạn. Công cụ tạo ra các tệp như replica/recon.md và features.csv.

Đầu ra của recon ghi lại màn hình, luồng người dùng, component và mô hình dữ liệu được suy luận. Nó cũng phân tách các tính năng có thể xây dựng lại khỏi những tài nguyên thuộc về công ty gốc, chẳng hạn như mạng riêng hoặc danh mục độc quyền.

2. Lập kế hoạch kiến trúc

Chạy /replica-architect để chuyển kết quả recon thành kế hoạch triển khai. Skill này lựa chọn hoặc đề xuất stack, định nghĩa schema cơ sở dữ liệu và API, đồng thời sắp xếp quá trình phát triển xoay quanh luồng end-to-end quan trọng nhất.

Ví dụ, một sản phẩm đặt lịch có thể cần người dùng, loại sự kiện, thời gian rảnh và lịch đặt. Kiến trúc cũng cần tính đến các ràng buộc riêng của lĩnh vực, chẳng hạn như ngăn hai khách đặt cùng một khung giờ.

3. Xây dựng lại design system

Sử dụng /replica-design để mô tả giao diện đã quan sát dưới dạng design token thay vì sao chép tài sản của bản gốc. Đầu ra có thể bao quát vai trò màu sắc, kiểu chữ, khoảng cách, control và đặc tả component. Thay thế icon, font, từ ngữ và hình ảnh gốc bằng các tài sản mà bạn được phép sử dụng.

4. Triển khai ứng dụng

/replica-build xử lý ứng dụng theo từng màn hình. Một thứ tự thực tế là xây dựng khung ứng dụng, triển khai luồng chính, sau đó hoàn thiện các màn hình và trạng thái phụ. Ma trận tính năng giúp theo dõi những phần đã hoàn tất.

5. Bổ sung khả năng backend

Chạy /replica-backend để xử lý xác thực, hành vi cơ sở dữ liệu, thanh toán và các tích hợp. Sử dụng thông tin xác thực của riêng bạn và API chính thức của mọi dịch vụ bạn kết nối. Ví dụ, một bản sao ứng dụng lập lịch có thể sử dụng API riêng của Google để tích hợp lịch, Stripe cho các lượt đặt chỗ có tính phí và một nhà cung cấp email để gửi lời nhắc.

6. Kiểm thử mọi luồng

/replica-test tạo kế hoạch kiểm thử từ danh sách luồng do quá trình trinh sát lập ra và có thể định nghĩa các bài kiểm thử đầu cuối. Bao gồm cả các đường đi thành công và trường hợp biên, chẳng hạn như múi giờ, một khung giờ trở nên không khả dụng trong lúc đặt chỗ và các lần gửi trùng lặp. Tiếp tục ghi nhận và sửa lỗi cho đến khi các vấn đề nghiêm trọng và mức độ cao được xử lý.

7. Đo lường mức tương đồng

Sử dụng /replica-diff để so sánh kết quả với bản gốc. Công cụ này báo cáo điểm tương đồng và danh sách tính năng còn thiếu, giúp phân biệt những phần cố ý loại trừ với phần công việc chưa hoàn tất. Điểm thấp hơn không tự động là vấn đề nếu tính năng bị bỏ qua phụ thuộc vào mạng, danh mục hoặc giấy phép mà bạn không thể tái tạo.

8. Tìm cơ hội sản phẩm

Chạy /replica-entrepreneur khi bạn cần bằng chứng để định vị sản phẩm. Công cụ phân tích dữ liệu đánh giá bạn cung cấp, xếp hạng các phàn nàn lặp lại và giữ lại liên kết đến các hàng nguồn. Công cụ không bịa đặt trích dẫn, số liệu hoặc ý kiến khách hàng. Các chủ đề có quá ít đánh giá hoặc nguồn sẽ được đánh dấu là thiếu dữ liệu.

9. Xây dựng thương hiệu độc lập

/replica-brand phát triển tên mới, bảng màu, bản mô tả yêu cầu logo và giọng điệu thương hiệu. Công cụ cũng cung cấp các bước kiểm tra nhãn hiệu và tên miền cần thực hiện. Hoàn tất giai đoạn này trước khi ra mắt và xóa tên, tên miền, màu sắc ban đầu cùng các tham chiếu nhận diện khác khỏi mã nguồn.

10. Chuẩn bị ra mắt

/replica-launch soạn trang đích, thông tin giá và nội dung đăng tải trên cửa hàng. Công cụ đăng tải kiểm tra các giới hạn của App Store và Google Play, các tuyên bố về thứ hạng, ký tự từ khóa bị lãng phí và các tham chiếu đến tên của sản phẩm ban đầu.

11. Chỉ triển khai sau khi kiểm tra trước triển khai

Cuối cùng, sử dụng /replica-deploy để chạy quy trình kiểm tra trước triển khai. Công cụ kiểm tra các bài kiểm thử, mức tương đồng, việc rà soát thương hiệu và nội dung đăng tải trên cửa hàng trước khi thiết lập môi trường sản xuất. Công cụ có thể cung cấp bản ghi DNS cho tên miền của bạn và chỉ phát hành khi bạn phê duyệt.

Sử dụng các công cụ Python đi kèm

Kho mã nguồn bao gồm sáu công cụ dòng lệnh. Chúng sử dụng thư viện chuẩn của Python và không truy cập mạng.

python3 replica-diff/imgdiff.py original.png clone.png --out diff.png
python3 replica-diff/parity.py replica/features.csv
python3 replica-entrepreneur/reviews.py replica/reviews.csv
python3 replica-design/contrast.py replica/design/tokens.json
python3 replica-brand/sweep.py . --avoid "Original App"
python3 replica-launch/listing.py replica/launch/listing.json

• imgdiff.py chuyển ảnh chụp màn hình thành bản đồ cạnh và so sánh các vùng bố cục trong khi bỏ qua khác biệt màu sắc.
• parity.py gán trọng số cho các tính năng bắt buộc, nên có và có thể có, tính mức hoàn thành một phần là một nửa và liệt kê các mục còn thiếu.
• reviews.py loại bỏ các đánh giá không có liên kết và in ra những trích dẫn gắn với các hàng nguồn bạn cung cấp.
• contrast.py kiểm tra độ tương phản WCAG cho các token thiết kế.
• sweep.py tìm kiếm trong mã nguồn, bao gồm cả mã định danh, tên, tên miền và màu sắc của sản phẩm ban đầu.
• listing.py kiểm tra giới hạn cửa hàng, tuyên bố về thứ hạng, việc sử dụng từ khóa và các tham chiếu sao chép.

Chạy bộ kiểm thử của kho mã nguồn bằng lệnh:

python3 -m unittest discover -s tests -v

Làm việc trong giới hạn của dự án

Chỉ sử dụng thông tin mà bạn được phép truy cập, chẳng hạn như các trang công khai và tài khoản của riêng bạn. Không thu thập dữ liệu phía sau màn hình đăng nhập, vượt qua tường phí, vi phạm điều khoản của một trang web hoặc truy cập tài khoản của người khác. Nếu điều khoản tài khoản cấm xây dựng sản phẩm cạnh tranh, hãy tuân thủ các điều khoản đó.

Quy trình này cũng không thể tái tạo những gì một ứng dụng sở hữu. Trình phát, danh sách phát và quy trình chia sẻ của một sản phẩm âm nhạc có thể được xây dựng lại, nhưng danh mục âm nhạc của sản phẩm đó không phải tài sản để bạn sao chép. Tương tự, không sử dụng lại nội dung độc quyền, logo, nhãn hiệu, mã nguồn hoặc tài sản số.

Trước khi bán kết quả, hãy hoàn tất các bước kiểm tra nhãn hiệu, xem xét điều khoản của mọi dịch vụ và tài sản bạn đã sử dụng, đồng thời tham vấn luật sư khi dự án liên quan đến rủi ro thương mại hoặc pháp lý đáng kể. Hướng dẫn của kho mã nguồn không phải là tư vấn pháp lý.

Kết luận

Kỹ năng Replica biến việc tái dựng ứng dụng thành một chuỗi bước được ghi chép: khảo sát các nguồn được phép, lập kế hoạch hệ thống, xây dựng lại giao diện và hành vi, kiểm thử kết quả, đo lường mức tương đồng, xác định cơ hội, đổi thương hiệu và triển khai độc lập. Hãy cài đặt các kỹ năng, lưu các sản phẩm trung gian trong replica/ và sử dụng các bước kiểm tra đi kèm để tạo ra sản phẩm lấy cảm hứng về chức năng nhưng mang bản sắc pháp lý và hình ảnh riêng.

Khám phá dự án trên GitHub và tìm hiểu thêm về tác giả tại opusjake.ai.