godchi
Toolkit Claude Code cá nhân (private) của toilact — dùng cho
mọi dự án cá nhân về sau, không bó vào một dự án nào. Nó gói: house-rules + cổng kiểm soát hành vi,
bộ guard ML-governance, một skill workflow AI engineer, cụm skill agentic/engineering, và một thư viện
gọi-theo-yêu-cầu (/gc-lib). Mục tiêu: nạp gọn (lean) — chỉ ~1,370 token/session luôn nạp.
Mục lục
- Mô hình hoạt động (đọc cái này trước)
- Cài đặt & dependency
- 3 cách "gọi" trong godchi
- Skills auto-activate — làm gì, khi nào chạy
- Commands:
/gc-ship, /gc-lib
- Subagent:
gc-explorer
- Thư viện on-demand (
/gc-lib)
- Dependency: superpowers
- Quy trình điển hình (ví dụ chạy thật)
- Bảo trì & mở rộng
- Cấu trúc thư mục
1. Mô hình hoạt động
godchi chia nội dung làm 2 tầng để tiết kiệm context:
| Tầng | Nằm ở | Nạp khi nào | Chi phí token |
|---|
| Auto-activate | skills/ | Claude tự kích hoạt khi task khớp description của skill | Mỗi skill ~40–110 tok luôn nạp (chỉ phần mô tả; thân skill chỉ nạp khi dùng) |
| On-demand | library/ | Chỉ khi bạn gọi /gc-lib | 0 token khi không dùng |
→ Vì thế: thứ cần "luôn nhắc Claude" (house rules, guard ML, kỷ luật) thì auto; thứ tra-cứu-khi-cần
(pattern theo framework, tài liệu vòng đời, workflow ad-hoc) thì để trong library/.
Xem nhanh ngân sách token: claude plugin details godchi.
2. Cài đặt & dependency
# Cài (đọc thẳng từ repo local — sửa repo là có hiệu lực ở session sau)
claude plugin marketplace add /Users/chithanhdaica/Documents/Projects/godchi
claude plugin install godchi@godchi
Dependency bắt buộc — superpowers (godchi không copy mà trỏ sang, xem mục 8):
claude plugin install superpowers@claude-plugins-official
Sau khi cài — dedup (tránh skill trùng kích hoạt 2 lần): godchi đã bundle karpathy-guidelines và
improve-codebase-architecture. Nếu bạn đang có bản personal/plugin trùng thì gỡ:
claude plugin uninstall andrej-karpathy-skills@karpathy-skills # godchi đã có karpathy-guidelines
(to-prd/to-issues/grill-with-docs/eval-harness đã nằm trong library/ nên không gây trùng auto.)
Đa nền tảng: hook SessionStart tự nhận diện Cursor / Copilot CLI / Claude Code và xuất đúng định
dạng → toolkit hoạt động ở cả 3.
Gỡ toolkit: claude plugin uninstall godchi@godchi.
3. Ba cách "gọi"
| Cách | Dùng cho | Ví dụ |
|---|
| Tự động (không làm gì) | Skills trong skills/ — Claude tự bật khi task khớp | Bạn sửa feature builder có shift(-1) → ml-data-leakage-guard tự nhắc |
| Slash command | Hành động chủ động | /gc-ship, /gc-lib fastapi-patterns |
| Gọi tên / nhờ subagent | Khi muốn ép một skill/subagent cụ thể | "dùng gc-explorer khảo sát module auth", "áp dụng skill codebase-onboarding" |
4. Skills auto-activate
Những skill dưới đây tự chạy khi ngữ cảnh khớp — bạn không cần gõ gì. Muốn ép chạy thì nhắc tên.
🏠 House rules & hành vi
| Skill | Dùng để làm gì | Tự chạy khi |
|---|
godchi | "Gu" làm việc của bạn: cổng hành vi (hỏi trước khi đổi lựa chọn đã chốt · brainstorm→plan→implement→review · verify trước khi báo xong), code style, giao tiếp tiếng Việt, index thư viện | Bắt đầu bất kỳ task code/ML nào trong dự án của bạn |
karpathy-guidelines | Chống over-engineer, sửa surgical, không tự ý mở rộng phạm vi | Khi viết / review / refactor code |
🤖 ML-governance (nguyên tắc ML tổng quát — đúng cho mọi dự án ML)
| Skill | Bắt lỗi gì | Tự chạy khi |
|---|
ai-ml-workflow | Bản đồ vòng đời AI engineer (EDA→feature→preprocess→train→tune→loop→integrate→deploy); trỏ tới library/ml-lifecycle/* | Bắt đầu/lập kế hoạch một task ML |
ml-data-leakage-guard | Rò rỉ dữ liệu tương lai (lookahead/target leak, shift(-1), fit-trên-toàn-bộ-data) | Sửa feature engineering, tạo label, scaler/encoder, pipeline train/serve |
walk-forward-guard | Chia data sai cho time-series (random split/k-fold/thiếu embargo) | Split train/val, viết backtest, tính CV, đánh giá model time-series |
model-feature-versioning | Train/serve skew, feature schema trôi giữa notebook và API | Lưu/nạp/serve model, đổi preprocessing, định nghĩa feature set chung |
