Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

clean-data-xls

Antigravity Skill: Làm sạch và chuẩn hóa dữ liệu bảng tính Excel, được Việt hóa từ bộ anthropics/financial-services.


Mô Tả

Skill này tự động phát hiện và sửa 9 loại lỗi dữ liệu phổ biến trong file Excel, với quy trình an toàn: luôn đề xuất trước, chỉ thực hiện sau khi người dùng xác nhận.

Các loại lỗi được xử lý

STT Loại lỗi Xử lý
1 Khoảng trắng thừa =TRIM() vào cột helper
2 Kiểu chữ không nhất quán =UPPER() / =LOWER() / =PROPER()
3 Số lưu dạng text =VALUE(SUBSTITUTE())
4 Định dạng ngày hỗn hợp =DATEVALUE()
5 Dòng trùng lặp Phát hiện + xác nhận xóa
6 Ô trống Forward-fill hoặc điền thủ công
7 Kiểu dữ liệu hỗn hợp Tách cột riêng
8 Lỗi encoding (mojibake) Script Python
9 Lỗi công thức Excel (#REF!, #N/A...) Thay bằng giá trị hợp lệ

Cấu Trúc Thư Mục

clean-data-xls/
├── SKILL.md                          # Hướng dẫn chính cho Antigravity Agent
├── scripts/
│   ├── clean_xlsx.py                 # Script làm sạch file .xlsx độc lập
│   └── clean_vietnamese_names.py     # Script chuẩn hóa tên người Việt
├── resources/
│   ├── requirements.txt              # Thư viện Python cần cài
│   └── report_template.md            # Template báo cáo kết quả
└── references/
    └── anthropic-skill-analysis.md   # Tài liệu kỹ thuật tham chiếu

Cài Đặt

1. Workspace-specific (khuyến nghị)

# Clone vào thư mục .agents/skills của workspace
git clone https://github.com/dotanminh/clean-data-xls.git .agents/skills/clean-data-xls

2. Global (tất cả mọi session)

# Clone vào thư mục global skills của Antigravity
git clone https://github.com/dotanminh/clean-data-xls.git "%USERPROFILE%\.gemini\config\skills\clean-data-xls"

3. Cài thư viện Python

pip install -r resources/requirements.txt

Cách Dùng

Trigger tự động (Antigravity Agent nhận diện khi bạn nói)

  • "làm sạch dữ liệu excel"
  • "chuẩn hóa file xlsx"
  • "xóa dòng trùng lặp"
  • "fix formatting"
  • "normalize this data"
  • "dữ liệu bị lộn xộn"

Chạy script Python trực tiếp

# Làm sạch file .xlsx
python scripts/clean_xlsx.py --input path/to/file.xlsx

# Xử lý vùng cụ thể
python scripts/clean_xlsx.py --input file.xlsx --sheet "Sheet1" --range "A1:F200"

# Chuẩn hóa tên người Việt (cột A)
python scripts/clean_vietnamese_names.py --input file.xlsx --col A --preview

Triết Lý Thiết Kế

Skill được xây dựng theo 4 nguyên tắc an toàn từ bản gốc Anthropic:

  1. "Propose before apply": Hiển thị kế hoạch sửa trước, không tự ý thay đổi.
  2. "Formulas over hardcodes": Dùng công thức Excel minh bạch thay vì code ẩn.
  3. "Confirm before destroy": Xóa dòng, ghi đè dữ liệu gốc phải có xác nhận.
  4. "Step-by-step confirmation": Xử lý từng nhóm lỗi, báo cáo trước/sau mỗi bước.

Điểm Việt Hóa So Với Bản Gốc

Điểm Bản gốc (Anthropic) Bản Việt hóa
Định dạng ngày MM/DD/YYYY (US) DD/MM/YYYY (VN)
Ký hiệu tiền USD ($) VND (đ hoặc VND)
Xử lý tên người =PROPER() Excel Script Python riêng (giữ đúng dấu thanh điệu)
Encoding Latin-1 / Windows-1252 UTF-8
Dấu phân cách số , hàng nghìn . hàng nghìn (chuẩn VN)

Nguồn Gốc

Port và Việt hóa từ: anthropics/financial-services: clean-data-xls/SKILL.md


License

MIT

About

Antigravity Skill: Lam sach va chuan hoa du lieu bang tinh Excel. Port va Viet hoa tu anthropics/financial-services.

Resources

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages