Back to search
game-feel
SkillWorks with Claude CodeGitHub
Quy cảm giác chơi thành số trước khi sửa code (nhảy, juice, độ khó, hiệu năng, âm thanh) và kiểm bằng máy: bot chơi, kiểm ảnh, ngân sách ms. Dùng khi dựng hoặc tinh chỉnh gameplay, game chơi thấy sai. Không dùng cho thiết kế màn hình hay thẩm mỹ UI.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/sefxvn16--game-feel)HTML
<a href="/listings/sefxvn16--game-feel"><img src="/api/listings/sefxvn16--game-feel/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 117 lines
- ---
- name: game-feel
- description: Quy cảm giác chơi thành số trước khi sửa code (nhảy, juice, độ khó, hiệu năng, âm thanh) và kiểm bằng máy: bot chơi, kiểm ảnh, ngân sách ms. Dùng khi dựng hoặc tinh chỉnh gameplay, game chơi thấy sai. Không dùng cho thiết kế màn hình hay thẩm mỹ UI.
- license: MIT
- ---
- # Game feel
- Skill này quyết định **chơi có đúng cảm giác không** và **làm sao biết được**. Skill không quyết định game có những màn nào, cũng không quyết định bố cục hay thẩm mỹ giao diện.
- Ranh giới với skill khác: `blueprint` đặt cổng giai đoạn ("người mới hiểu cần làm gì trong 2 phút đầu", "≥3 buổi chơi thử", "không chỗ nào quá nửa người chơi bị kẹt"); skill này cho cách vượt những cổng đó bằng số đo. `ui-design-principles` lo bố cục và thẩm mỹ. `plan-tracker` lo `PLAN.md`.
- File tham chiếu (đọc file nào khi cần, đọc trọn file đó):
- - [references/numbers.md](references/numbers.md): bảng số khởi điểm theo 8 nhóm, mỗi dòng có nhãn nguồn.
- - [references/playtest.md](references/playtest.md): bot chơi, kiểm ảnh bằng số, quan sát người chơi, mẫu báo cáo.
- - [references/balance.md](references/balance.md): đòn bẩy có khoảng an toàn, rà lệch đường cong, chiến lược thống trị, nguồn và bể chứa tài nguyên, thử biên công thức.
- - [references/archetype-TEMPLATE.md](references/archetype-TEMPLATE.md): khuôn chốt lại một thể loại sau khi đã đo trên game thật.
- - [SOURCES.md](SOURCES.md): nguồn của các số. File dành cho người đọc, không nạp khi chạy.
- Đọc `numbers.md` khi cần đặt hoặc chỉnh **một** giá trị. Đọc `balance.md` khi rà **cả game**: độ khó, kinh tế, lựa chọn của người chơi. Đọc `playtest.md` khi cần kiểm. Đọc cả ba khi mở một vòng tinh chỉnh lớn.
- ## Quy tắc cứng
- 1. **Không có số thì không sửa.** Mỗi lần chỉnh cảm giác, viết giá trị hiện tại và giá trị đích trước khi đụng code. "Cho nặng tay hơn" không phải mục tiêu; "hit-stop từ 0 lên 50 ms" là mục tiêu.
- 2. **Không bịa số.** Số lấy từ `numbers.md` thì giữ nguyên nhãn nguồn của nó khi nói với người dùng. Không có nguồn thì nói là đang đoán, và ghi vào `numbers.md` dòng `[chưa có nguồn]` kèm giá trị đã thử.
- 3. **Lệnh chạy xong không phải bằng chứng.** Chỉ kết luận theo §5. Không bao giờ nói "đã chạy được" khi chỉ thấy lệnh không báo lỗi.
- 4. **Cảm giác là phán quyết của người chơi.** Máy chỉ kiểm được game có chạy, có qua được màn, có đúng ngân sách. Vui hay không, nặng tay hay không: người dùng quyết. Báo cáo phải tách rõ hai phần (`playtest.md`).
- 5. **Một giá trị một chỗ.** Mọi hằng số gameplay nằm trong đúng một file (§4). Không rải số vào nhiều file.
- 6. **Mỗi vòng đổi một thứ.** Đổi hai giá trị cùng lúc thì không biết cái nào có tác dụng. Chênh lệch dưới 5% so với lần đo trước coi như nhiễu, không phải cải thiện.
- 7. **Không sửa, không nới, không bỏ điều kiện pass/fail đã đặt để cho qua.** Điều kiện sai thì nói rõ vì sao và hỏi trước.
- ## 1. Chốt động từ cốt lõi
- Trước mọi thứ khác, chốt **một động từ**: ngón tay hoặc tay người chơi làm gì nhiều nhất. Nhảy. Ném. Ghép. Kéo. Bắn. Lái.
- - Một động từ, không hai. Có hai thì hỏi người dùng cái nào bỏ được ở bản đầu.
- - Người chơi mới phải hiểu động từ đó trong 2 giây đầu nhìn màn hình, không cần đọc chữ.
- - Viết động từ vào `design/gameplay.md` (nếu dự án dùng `blueprint`) hoặc vào đầu file hằng số (§4).
- Chưa chốt được động từ thì chưa đặt số. Hỏi người dùng, không tự chọn.
- ## 2. Đặt mục tiêu cảm giác thành số, dưới dạng giả thuyết
- Mỗi lần tinh chỉnh, viết đúng ba dòng trước khi sửa:
- ```
- Nếu: <đổi gì, từ giá trị nào sang giá trị nào>
- Thì: <người chơi cảm thấy gì, hoặc làm được gì>
- Biết được qua: <số đo hoặc quan sát cụ thể>
- ```
- Ví dụ: *Nếu* coyote time từ 0 lên 6 tick, *thì* người chơi không còn rớt khi nhảy ở mép bệ, *biết được qua* bot chơi vượt được đoạn 4 tile ở `playtest.md`.
- Dòng "Biết được qua" không được viết kiểu "chơi thấy mượt hơn". Phải là một số, một cờ ảnh, hoặc một quan sát đếm được (bao nhiêu người vướng ở đâu).
- Chưa viết được dòng thứ ba thì câu hỏi còn mơ hồ: đổi câu hỏi, đừng sửa code.
- ## 3. Chọn môi trường thử theo thể loại
- Trình duyệt thêm độ trễ input, nên bản HTML **nói dối về cảm giác tay**. Chọn theo cái đang thử:
- | Đang thử | Dựng bằng |
- |---|---|
- | Cảm giác tay: nhảy, lao, đánh, lái, bất cứ gì nhấn-rồi-phản hồi | Engine thật (Godot). Bản HTML chỉ dùng để xem bố cục, không dùng để kết luận cảm giác |
- | Luật chơi, kinh tế, chi phí, tỷ lệ rơi, thẻ bài | Bảng tính hoặc giấy. Nhanh hơn code và không sai |
- | Puzzle logic, idle, merge, quản lý | HTML/JS là đủ |
- | Nhiều người chơi, lưu dữ liệu, tài khoản | Engine thật, và xem `blueprint` cho phần màn hình và luồng |
- Nếu người dùng chọn môi trường khác với bảng này, nói một lần cái đánh đổi rồi làm theo họ.
- ## 4. Một nguồn sự thật cho hằng số
- Mọi số gameplay nằm trong **một** file, ví dụ `src/sim.js`, `sim.gd` hoặc `tuning.json`:
- - vật lý và tốc độ, thời gian hồi, sát thương, tỷ lệ spawn, kích thước ô, giá;
- - bố cục màn chơi và đường đi mẫu, nếu màn có đường đi;
- - không có số gameplay nào viết cứng ở chỗ khác.
- Game, bot chơi và mọi script kiểm **đọc từ file đó**, không có bản sao. Lý do: bot kiểm một bộ số, game chạy một bộ số khác thì kết quả kiểm vô nghĩa — và đó là kiểu hỏng khó thấy nhất khi vibe code.
- Khi màn chơi có đường đi, viết một script chạy thử đường đi đọc đúng file hằng số đó, chạy trước khi mở game. Nó bắt được bệ không với tới và khoảng nhảy quá xa mà không cần dựng gì.
- Mỗi lần đổi một giá trị trong file này, ghi một dòng vào nhật ký tinh chỉnh: ngày · giá trị cũ → mới · lý do · kết quả đo.
- ## 5. Giao thức xác minh
- Sáu điểm, áp theo thứ tự. Bỏ điểm nào thì nói rõ là đã bỏ.
- 1. **Mã thoát không phải bằng chứng.** Script lỗi cú pháp vẫn thoát 0; đường dẫn sai cũng thoát 0; lệnh xuất file báo thành công vẫn cho file sai. Mỗi bước kiểm phải in đúng một dòng máy đọc được, ví dụ `RESULT {"ok": true, "frames": 312, "p95_ms": 14.8}`, và phải quét log tìm lỗi. Dòng kết quả rỗng hoặc thiếu coi là thất bại.
- 2. **Kiểm ảnh bằng số trước khi nhìn bằng mắt.** Chụp ảnh rồi chạy kiểm cờ khung hỏng (toàn đen, toàn trắng, một màu, cháy sáng, tối sập, tương phản tâm ảnh thấp) theo `playtest.md`. Khung trắng toàn phần từng được duyệt là đạt, nên bước này đi trước mắt người.
- 3. **Nhìn bằng mắt sau đó, bằng ảnh ghép.** Ghép nhiều khung thành một tấm rồi mở ra xem. Chưa mở ảnh thì chưa được nói là xong.
- 4. **Test phải thấy đỏ trước khi tin.** Phá thân hàm đang kiểm, xem test có fail không, rồi phục hồi. Test chưa bao giờ đỏ là test không kiểm gì.
- 5. **Bot giỏi phải thắng, bot dở phải thua.** Hai bot cùng đọc file hằng số ở §4. Bot dở trả về không có kết quả nghĩa là đường thua chưa được kiểm, không phải là đạt.
- 6. **Báo cáo tách ba mức.** `Verified` (đã chạy, kèm số), `Assumed` (suy ra, chưa chạy), `NOT ASSESSED` (chưa kiểm). `NOT ASSESSED` xếp trên `PASS` và dưới `FAIL`; giá trị thiếu không được mặc định thành cho qua.
- ## 6. Luật cắt lỗ
- - Một prototype thử **đúng một** cơ chế, tối đa một ngày làm việc.
- - Dựng 2–3 biến thể của cùng một cơ chế rồi chọn, thay vì tinh chỉnh mãi một bản.
- - Kẹt quá 2 giờ trên cùng một câu hỏi: đổi câu hỏi, đừng đổi thêm số.
- - Ba vòng tinh chỉnh liên tiếp mà số đo không đạt mục tiêu ở §2: dừng, báo người dùng, nêu hai hướng (đổi mục tiêu, hoặc bỏ cơ chế).
- - Người dùng đổi hướng lần thứ ba trên cùng một ý tưởng: hỏi thẳng có nên bỏ không. (`blueprint` có cùng luật này ở cổng prototype.)
- ## Khi đã đo được trên game thật
- Chốt lại thành một file thể loại theo [references/archetype-TEMPLATE.md](references/archetype-TEMPLATE.md), đặt tên `references/archetype-<thể loại>.md`. Chỉ điền số đã thật sự đo trên game của người dùng, kèm điều kiện đo (thiết bị, bản engine, ngày). Số chưa đo thì để trống, không chép từ `numbers.md` sang.
- Mục **Mistakes seen** trong khuôn đó là chỗ ghi lỗi thật đã gặp và cách sửa. Ghi mỗi lần gặp, một dòng.
- ## Kết thúc mỗi lần dùng
- Nói ngắn, đúng bốn điều:
- 1. đã đổi giá trị nào, từ bao nhiêu sang bao nhiêu;
- 2. số đo được, và `Verified` / `Assumed` / `NOT ASSESSED`;
- 3. phần nào phải người dùng tự chơi mới kết luận được;
- 4. **một** việc tiếp theo.
README.md · README · 102 lines
- # Game Feel Skill
- Skill cho trợ lý AI giúp quy chuẩn hóa **cảm giác chơi (game feel)** thành các chỉ số đo lường cụ thể trước khi sửa code, đồng thời tự động hóa quy trình kiểm thử bằng máy (bot chơi, kiểm ảnh, ngân sách mili-giây).
- Dùng khi dựng gameplay mới hoặc tinh chỉnh gameplay đang có, đặc biệt khi cảm thấy game chơi "chưa đã", "sai sai" hoặc thiếu cảm giác lực nhưng chưa rõ nguyên nhân kỹ thuật.
- ---
- ## Mục tiêu và ranh giới
- Skill này trả lời hai câu hỏi cốt lõi:
- 1. **Game chơi có đúng cảm giác mong muốn không?**
- 2. **Làm sao để biết được điều đó bằng bằng chứng thực tế thay vì cảm tính?**
- ### Ranh giới với các skill khác
- - **`blueprint`**: Đặt cổng kiểm soát giai đoạn sản xuất (màn chơi cần có, luồng người chơi, điều kiện lên bản alpha/beta). `blueprint` đặt đầu bài, `game-feel` cung cấp phương pháp và số đo để vượt qua các cổng kiểm soát đó.
- - **`ui-design-principles`**: Chịu trách nhiệm về bố cục không gian, căn gióng và thẩm mỹ giao diện. Không can thiệp vào cảm giác va chạm và gameplay.
- - **`plan-tracker`**: Quản trị danh sách công việc trong `PLAN.md`.
- ---
- ## 7 quy tắc cứng
- 1. **Không có số thì không sửa:** Mỗi lần muốn chỉnh cảm giác chơi, phải ghi rõ giá trị hiện tại và giá trị đích trước khi đụng vào code. *"Cho cú đánh nặng tay hơn"* không phải là mục tiêu; *"Tăng hit-stop từ 0 lên 50 ms"* mới là mục tiêu.
- 2. **Không bịa số:** Mọi con số lấy từ tài liệu tham chiếu phải giữ nguyên nhãn nguồn (`[đã kiểm]`, `[tham khảo]`, `[suy luận]`, `[chưa có nguồn]`). Nếu chưa có nguồn thì thừa nhận là đang ước lượng và ghi chú rõ ràng.
- 3. **Lệnh chạy xong không phải bằng chứng:** Chỉ kết luận khi có bằng chứng chạy thật qua giao thức xác minh 6 điểm. Tuyệt đối không kết luận *"đã hoạt động tốt"* chỉ vì lệnh không báo lỗi console.
- 4. **Cảm giác là phán quyết của người chơi:** Máy chỉ kiểm tra được tính đúng đắn kỹ thuật (vượt qua màn, không tụt khung hình, đúng ngân sách thời gian). Trải nghiệm "vui" hay "đã tay" do con người tự trải nghiệm và quyết định.
- 5. **Một giá trị một chỗ:** Mọi hằng số gameplay phải tập trung vào đúng một file hằng số duy nhất của dự án. Không rải rác giá trị ma thuật (magic numbers) vào nhiều file logic.
- 6. **Mỗi vòng chỉ đổi một thứ:** Thay đổi hai thông số cùng lúc sẽ không thể xác định thông số nào đem lại cải thiện. Chênh lệch đo lường dưới 5% so với lần trước được tính là nhiễu, không phải là tiến bộ.
- 7. **Không nới lỏng điều kiện kiểm thử:** Tuyệt đối không tự ý sửa, nới hoặc bỏ qua điều kiện pass/fail đã cam kết để "chữa cháy" cho bài kiểm tra qua được.
- ---
- ## Cấu trúc thư mục
- ```
- game-feel/
- ├── SKILL.md # Hướng dẫn quy trình vận hành chính
- ├── SOURCES.md # Nguồn trích dẫn, khảo sát và độ tin cậy của số liệu
- ├── LICENSE # Giấy phép MIT
- ├── README.md # Tài liệu hướng dẫn sử dụng (bản tiếng Việt)
- └── references/
- ├── numbers.md # Bảng số khởi điểm cho 8 nhóm (nhảy, juice, hoạt ảnh, hiệu năng, âm thanh...)
- ├── balance.md # Cân bằng game: đòn bẩy an toàn, lệch đường cong, thử nghiệm kinh tế và biên độ
- ├── playtest.md # Kiểm thử: bot giỏi/dở, kiểm tra khung hình bằng số, quan sát người dùng
- └── archetype-TEMPLATE.md # Khung mẫu chốt thông số sau khi đo đạc trên game thực tế
- ```
- ---
- ## Chi tiết các tài liệu tham chiếu
- - **[SKILL.md](SKILL.md)**: Định nghĩa quy trình 6 bước từ chốt động từ cốt lõi, lập mục tiêu số đo, chuẩn bị môi trường chạy thử, gom hằng số tập trung, đến giao thức xác minh 6 điểm và luật cắt lỗ.
- - **[references/numbers.md](references/numbers.md)**: Tra cứu nhanh khi cần đặt hoặc chỉnh **một giá trị cụ thể** (thời gian coyote time, jump buffer, hit-stop, camera shake, âm lượng LUFS, độ trễ input, FPS mục tiêu...).
- - **[references/balance.md](references/balance.md)**: Tra cứu khi rà soát **toàn bộ hệ thống game** (độ khó theo thời gian, kiểm tra chiến lược thống trị, mô phỏng dòng tài nguyên nguồn/bể chứa, kiểm tra biên độ công thức sát thương).
- - **[references/playtest.md](references/playtest.md)**: Hướng dẫn dựng bot QA tự chơi (bot giỏi phản xạ nhanh vs bot vụng phản xạ chậm), thiết lập kiểm tra hình ảnh bằng ngưỡng số, quan sát người chơi trong im lặng và biểu mẫu báo cáo kết quả.
- - **[references/archetype-TEMPLATE.md](references/archetype-TEMPLATE.md)**: Mẫu hồ sơ đóng gói archetype sau khi đã đo đạc chính xác trên game thật của dự án.
- - **[SOURCES.md](SOURCES.md)**: Bản ghi nguồn gốc trích dẫn, phân loại giấy phép và mức độ kiểm chứng thực tế của các số liệu.
- ---
- ## Hướng dẫn cài đặt và sử dụng
- ### 1. Claude Desktop / Giao diện Web
- 1. Tải repository này về máy.
- 2. Nén toàn bộ thư mục `game-feel` thành file `game-feel.zip` (đảm bảo thư mục `game-feel` nằm ở cấp cao nhất trong file zip).
- 3. Trong Claude, chọn **Customize** → **Skills** → nhấn **+** (**Create skill**) → chọn **Upload a skill** và tải file `game-feel.zip` lên.
- ### 2. Claude Code
- Sao chép thư mục `game-feel` vào thư mục kỹ năng toàn cục hoặc thư mục riêng của dự án:
- ```bash
- # Cài đặt cho toàn bộ các dự án
- git clone https://github.com/sefxvn16/game-feel.git ~/.claude/skills/game-feel
- # Hoặc cài đặt riêng cho dự án hiện tại
- git clone https://github.com/sefxvn16/game-feel.git .claude/skills/game-feel
- ```
- ### 3. Google Antigravity & các AI Agent khác
- Đặt trực tiếp thư mục `game-feel` vào đường dẫn kỹ năng cấu hình của bạn (ví dụ: `~/.gemini/config/skills/game-feel` hoặc `.agent/skills/game-feel`).
- ---
- ## Ví dụ kích hoạt trong lúc làm việc
- Bạn có thể kích hoạt skill bằng cách nhắc tới cảm giác chơi hoặc gọi trực tiếp:
- > *"Nhân vật nhảy đang có cảm giác bị bay và trôi, hãy dùng skill game-feel rà soát lại thông số trọng lực, thời gian đạt đỉnh và rơi nhanh."*
- > *"Dựng kịch bản bot chơi giỏi và bot chơi dở theo `playtest.md` để kiểm tra độ khó của màn 3."*
- > *"Rà lại hệ thống kinh tế trong game xem có nguy cơ vỡ bể tài nguyên vô hạn không theo `balance.md`."*
- ---
- ## Giới thiệu & Tác giả
- Được phát triển và duy trì bởi **[Seafox (sefxvn16)](https://github.com/sefxvn16)**.
- ## Giấy phép
- Phát hành theo giấy phép mã nguồn mở **[MIT](LICENSE)**. Bản quyền © 2026 Seafox (sefxvn16).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.