4 Skills Claude Code của Quỳnh

git diff hiển thị phần khác nhau giữa trạng thái hiện tại và mốc Git trước đó. Kết quả được dùng để đặt conventional commit (quy ước đặt tên commit bằng tiền tố như feat, fix, docs hoặc chore).

plans/task-log.md được cập nhật trước commit: mục công việc chuyển sang done, có giờ kết thúc, thời gian thực hiện và kết quả. Cách này đưa thay đổi của task-log vào cùng commit với mã nguồn.

git add chọn thay đổi; git commit lưu mốc. Pre-commit hook (bước kiểm tra tự chạy trước khi tạo commit) có quyền từ chối. skill không dùng --no-verify để vượt qua hook và không đưa nhắc đến AI vào nội dung commit.

vibe-history là kho lưu lại các phiên làm việc với AI. Khi biến $CK_SESSION_ID có giá trị, skill gửi một gói JSON (định dạng dữ liệu dạng cặp tên–giá trị) gồm mã phiên, thư mục làm việc và đường dẫn bản ghi tới vibe-history-capture.cjs. Script là chương trình nhỏ chạy tự động; script này luôn trả mã thành công để lỗi lưu lịch sử không chặn việc chốt đầu việc.

GitHub issue là mục theo dõi công việc trên GitHub. skill hỏi xác nhận trước khi chạy gh issue create hoặc gh issue close. Tiêu đề, nội dung Vấn đề → Phương án → Quyết định và nhãn tuân theo quy ước dự án.

extract.py quét các file task-log.md dưới ~/Documents/EGANY, tách từng mục ### Task và lọc ngày từ dòng - Time:. Nếu dòng này không có ngày, script dùng ngày ở tiêu đề ## Session.

Script đọc cả dạng 2h30 và 15', cộng trường thời gian rồi xuất JSON đã nhóm theo dự án. Phần trình bày dùng trực tiếp kết quả đó thay vì tự tính lại.

extract-vault-tasks.py đọc tasks/*.md trong Obsidian vault. Frontmatter là khối thông tin ở đầu file; script lấy các trường date, done, project và spent_time từ đó bằng bộ đọc có sẵn, không cần PyYAML.

Cờ --overdue lấy các việc có done: false và quá hạn trong 7 ngày để bổ sung cho mục Vướng mắc.

Registry đọc trường repo: trong các ghi chú projects/*.md. Cách longest-prefix chọn đường dẫn đã khai dài nhất khớp với đường dẫn hiện tại, vì vậy thư mục con vẫn thuộc dự án cha phù hợp.

Mô hình ngôn ngữ nhóm các mục cùng hướng, giới hạn 2–3 ý cho mỗi mảng và trình bày theo vấn đề → kết quả. Thuật ngữ nghiệp vụ cần thiết như CRO hoặc checkout được giữ lại; chi tiết lập trình như tên biến, bảng dữ liệu hoặc webhook (địa chỉ nhận thông báo tự động từ hệ thống khác) được bỏ khi không giúp người đọc hiểu kết quả.

Confirmation gate là bước bắt buộc phải có xác nhận của người dùng. Ngay cả khi đã có việc trong kho ghi chú, yêu cầu “chạy daily report” vẫn không được hiểu là cho phép ghi ngay.

Báo cáo được ghi vào journal/reports/<hôm-nay>.md. BBCode là cú pháp định dạng của Bitrix24; file có ba mục HÔM QUA, HÔM NAY, VƯỚNG MẮC và có frontmatter để tra cứu. Nếu file của ngày đó đã tồn tại, skill hỏi trước khi ghi đè.

Việc ngoài mã nguồn đã xong được ghi vào tasks/*.md với done: true; kế hoạch mã nguồn và ngoài mã nguồn dùng done: false. Mục trùng tên được cập nhật thay vì tạo bản thứ hai. Task-log chỉ được đọc.

Session transcript là bản ghi tuần tự của một phiên làm việc. Các phiên cũ nằm ở ~/.claude/projects/<đường-dẫn-mã-hoá>/*.jsonl; nếu retrospective chạy ngay trong phiên vừa xây dựng dự án, nó dùng trực tiếp phiên hiện tại.

Semantic search là tìm theo ý nghĩa thay vì chỉ khớp từ giống hệt. skill kiểm tra công cụ qmd bằng shutil.which, rồi cho biết có thể gọi vibe-history-search để tìm trong chỉ mục hay không.

Mỗi mục trong task-log có bối cảnh Vấn đề → Phương án → Quyết định và mốc thời gian. Retrospective dùng dữ liệu này cho phần dòng thời gian và phần lý do quyết định trong tài liệu.

skill đọc commit message (mô tả của một mốc Git), pull request hay PR (đề nghị đưa một nhánh thay đổi vào nhánh chính) và issue khi có công cụ gh. Với dự án cũ, đây có thể là nguồn duy nhất còn lại để xác định thứ tự thay đổi.

collect_sources.py kiểm tra bốn nguồn và trả mức High, Medium hoặc Low. Mức này giới hạn phần nội dung có thể dựng lại. Đường dẫn phiên được chuyển thành dạng an toàn bằng biểu thức re.sub([^A-Za-z0-9] → -).

Tài liệu theo cấu trúc 12 mục trong references/template.md và quy tắc ở authoring-rules.md. ADR là bản ghi một quyết định kiến trúc; nhận định thiếu bằng chứng trực tiếp được gắn (Inferred). skill không thêm phương pháp chưa từng được áp dụng.

Bot token là mã bí mật cho phép script dùng bot; chat ID là mã nơi nhận. send.sh đọc hai giá trị này từ ~/.config/telegram-send/config.env.

File cấu hình nằm ngoài kho mã nguồn và dùng quyền chmod 600, nghĩa là chỉ tài khoản của mình được đọc và sửa. Thiếu cấu hình thì script trả exit 1 và dừng.

CLI args là các tham số đặt sau tên lệnh. Vòng lặp đọc --chat để đổi nơi nhận, -c để thêm chú thích và -f để bắt đầu danh sách file; phần còn lại được ghép thành nội dung chữ.

Sau -f, mọi tham số không bắt đầu bằng dấu gạch được xem là đường dẫn file. Vì vậy nội dung chữ phải đặt trước -f.

Telegram Bot API là giao diện để chương trình gửi yêu cầu tới Telegram. curl gọi endpoint (địa chỉ dành cho một thao tác của API) tại https://api.telegram.org/bot<token>.

Mỗi file dùng thao tác sendDocument, còn phần chữ dùng sendMessage. Nội dung chữ không được phân tích như Markdown nên các ký tự định dạng không gây lỗi.

Script shell tìm "ok":true trong phản hồi JSON; nếu không có, sed lấy trường "description" để in FAIL: <lý do>.

Exit code là mã kết thúc của lệnh. Bất kỳ lần gửi nào lỗi đều khiến mã khác 0; nếu chỉ một file trong nhiều file lỗi, từng kết quả vẫn được báo riêng.