Programming (Chuẩn code đa ngôn ngữ)

Skill này làm gì

Đây là "sổ tay kỹ sư senior" tự kích hoạt khi Claude tạo hoặc sửa file .py, .rs, .ts/.tsx, .go.

• Cổng ngôn ngữ: bắt buộc đọc tài liệu trong references/ của đúng ngôn ngữ TRƯỚC khi viết dòng code đầu tiên.
• 7 tiên đề chung: code tốt nhất là code không cần viết (YAGNI), dùng type system như hệ thống chứng minh, parse-don't-validate (chỉ kiểm tra ở biên), branded types (UserId ≠ string), match đầy đủ mọi biến thể, không thêm lớp phòng vệ vô nghĩa, và TDD.
• Stack cố định: Pydantic v2/FastAPI, serde+thiserror/axum, Zod/Hono, gin+sqlc+pgx+slog... theo bảng thư viện chuẩn cho từng lĩnh vực.
• Toolchain cố định: uv+basedpyright+ruff, cargo+clippy+miri, Bun+Biome+tsc, gofumpt+golangci-lint v2+nilaway.
• Kỷ luật TDD: thứ tự red→green→refactor, cấu trúc Given/When/Then, tỷ lệ unit/integration/E2E, thứ tự ưu tiên thay thế mock, và bảng anti-pattern (ví dụ: cấm test khẳng định nội dung văn bản prompt).
• Code smell & vòng review sau khi viết: file vượt 250 dòng thuần là lỗi, hàm quá 3 tham số, kiểm tra lại sau khi xóa, tên dạng phủ định. Kết thúc phiên phải tự trả lời 9 câu hỏi kiểm tra kiến trúc.

Phù hợp với ai

• Dev làm việc cùng lúc nhiều ngôn ngữ và mệt vì AI sinh code không nhất quán
• Team lead muốn loại bỏ any, unwrap, except Exception khỏi codebase
• Người muốn thực sự thi hành TDD (test trước, ít mock, bắt buộc có E2E)
• Người khởi tạo dự án mới và muốn chốt toolchain một lần cho xong

Ví dụ sử dụng

1. Thêm endpoint FastAPI: yêu cầu "tạo endpoint nhận webhook thanh toán" → Claude parse input bằng Pydantic v2 ở biên, dùng NewType cho ID, async qua anyio, và viết test pytest thất bại trước.
2. Refactor server Go: mở file handler 400 dòng → skill coi việc vượt 250 LOC là defect, đề xuất tách theo trách nhiệm, chuyển sang error có kiểu với %w / errors.Is và logging cấu trúc bằng log/slog.
3. Rà soát unsafe Rust: khi thấy *mut hoặc MaybeUninit, skill nạp thêm tài liệu rust-ub và soi code theo tiêu chuẩn miri/UB.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục packages/shared-skills/skills/programming từ repo GitHub code-yeongyu/oh-my-openagent vào ~/.claude/skills/programming/ 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.