Di trú NanoClaw (migrate-nanoclaw)

Trích xuất các tùy biến trong fork NanoClaw thành một hướng dẫn di trú, rồi áp dụng lại trên bản upstream sạch để nâng cấp mà không gặp xung đột merge.

Lập trìnhNâng cao★ 30,471⑂ 12,865Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026

Làm được gì

Quét fork NanoClaw của bạn để tìm mọi thay đổi so với upstream (giá trị cấu hình, sửa mã nguồn, persona, skill tự thêm) và ghi lại thành hướng dẫn di trú tái sử dụng được (.nanoclaw-migrations/guide.md).
Tự đánh giá mức độ khác biệt và chọn một trong ba mức (nhẹ / chuẩn / phức tạp), dùng các sub-agent haiku để khảo sát song song.
Khi nâng cấp, thay vì git merge, skill tạo worktree checkout upstream sạch rồi áp dụng lại tùy biến theo hướng dẫn — không có gì để merge nên không có xung đột.
Tạo nhánh + tag backup trước khi thao tác, chạy build/test và cả kiểm thử thật (tin nhắn thử) trước khi thay vào cây làm việc chính.
Tuyệt đối không chạm vào dữ liệu: groups/, store/, data/, .env.

Dành cho ai

Người fork NanoClaw và tùy biến nhiều, mỗi lần upstream cập nhật lại gặp xung đột merge đau đầu.
Người muốn có tài liệu hóa tùy biến để lặp lại quy trình nâng cấp một cách nhất quán.
Người cần quy trình nâng cấp an toàn có worktree, tag backup và đường rollback rõ ràng.

Ví dụ sử dụng

"Nâng cấp fork NanoClaw của tôi lên upstream mới nhất" → skill tính mức khác biệt, chọn tier, viết guide, áp dụng lại trong worktree và kiểm tra build.
Fork đã áp dụng cả skill Telegram và Slack: skill phát hiện hai skill khai báo trùng một hằng số, ghi vào mục "Skill Interactions" và hướng dẫn cách dọn sau khi áp dụng lại.
Thay đổi đơn giản như đổi từ khóa kích hoạt @Andy thành @Bob trong src/config.ts chỉ cần một dòng mô tả; còn tích hợp phức tạp như dịch qua DeepL sẽ được ghi kèm đoạn code và đường dẫn import cụ thể.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/migrate-nanoclaw/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

Cài vào ứng dụng Claude (không cần terminal)

Tải tệp ZIP bằng nút bên dưới.
Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.

↓ Tải ZIP

Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục .claude/skills/migrate-nanoclaw từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/migrate-nanoclaw/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/migrate-nanoclaw ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Mở terminal và clone repo NanoClaw vào thư mục tạm: git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw
Tạo thư mục skill: mkdir -p ~/.claude/skills
Sao chép skill: cp -r /tmp/nanoclaw/.claude/skills/migrate-nanoclaw ~/.claude/skills/
Nếu bạn đã có fork NanoClaw, nên dùng luôn thư mục .claude/skills/migrate-nanoclaw/ trong repo (skill sẽ tự cập nhật bản mới nhất từ upstream khi chạy).
Trong thư mục fork, kiểm tra git remote -v; nếu thiếu remote upstream, chạy git remote add upstream https://github.com/nanocoai/nanoclaw.git.
Đảm bảo cây làm việc sạch (commit hoặc stash), mở Claude Code và yêu cầu: "Dùng skill migrate-nanoclaw để nâng cấp lên upstream".
Ghi lại tên tag backup mà skill tạo ra. Nếu có sự cố, hoàn tác bằng git reset --hard <tag-backup>.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT