# Sổ tay thực chiến — bộ skill cài-được

> Mỗi skill dưới đây là một artifact thật: rule cho CLAUDE.md, slash command, SKILL.md hoặc prompt. Cách dùng: copy phần artifact, dán thẳng vào CLAUDE.md của bạn (hoặc bảo agent tự thêm). Cài một lần — cái đúng tự chạy.
>
> craftagent.cloud · 14 skill

---

## 1. Kiểm chứng trước khi gọi là xong

*Một forcing function buộc agent chứng minh bản sửa, thay vì chỉ khai là xong.*

**Rule:** Đừng dặn agent cẩn thận — lắp cái gate để nó *không thể* bỏ qua phần chứng minh.

```
## Verification — before reporting "done"
Never report a change as done on inspection alone. First:
1. Run the real path — render the page / hit the endpoint / execute the command.
2. Paste the actual output here. Do not describe it; show it.
3. State the one observable signal that proves it works (a value, an exit code, a rendered element).
A confident tone is not evidence. If the user says "still broken," re-diagnose from the observed output — do not re-apply the same fix on a new guess.
```

Nguồn: https://craftagent.cloud/vi/kiem-chung-bang-cach-chay-that/

---

## 2. Plan trước, rồi mới code

*Một forcing function buộc agent trình cách làm — và dừng lại — trước khi đụng vào code.*

**Rule:** Chỗ rẻ nhất để sửa một hướng đi sai là *trước* dòng code đầu tiên.

```
## Plan before non-trivial changes
For any task beyond a one-line edit, before writing code:
1. State the approach: which files you will touch, the direction you will take, and why not the obvious alternatives.
2. Flag what you are unsure about or assuming.
3. STOP and wait for my go-ahead. Do not write code until I confirm.
Skip this only for trivial, single-line changes.
```

Nguồn: https://craftagent.cloud/vi/plan-truoc-roi-moi-code/

---

## 3. Lập bản đồ ảnh hưởng trước khi sửa

*Một forcing function buộc agent truy ai đang phụ thuộc vào một symbol, trước khi nó đổi.*

**Rule:** Sửa một symbol dùng chung không phải thay đổi nhỏ — đó là thay đổi của mọi nơi gọi nó.

```
## Before editing shared code
Before changing a function, type, signature, or config value that other code depends on:
1. List every caller or dependent of the symbol you are about to change.
2. State the blast radius: what breaks if the change is wrong, and how far it reaches.
3. If it touches a widely-used symbol or a public interface, say so and wait for my go-ahead before editing.
Never change a shared signature with blind find-and-replace — trace the callers first, then edit.
```

Nguồn: https://craftagent.cloud/vi/kiem-tra-tac-dong-truoc-khi-sua/

---

## 4. Việc có một đáp án thì đừng để model đoán

*Một forcing function đẩy việc có đáp án chính xác sang script, thay vì để model suy luận.*

**Rule:** Model nên suy luận cái không có đáp án đúng — và chạy code cho mọi cái có.

```
## Deterministic work goes to code, not prose
When a task has exactly one correct answer a script can compute — counting, parsing a fixed format, transforming data, math, lookups — write and run a script instead of producing the answer by hand.
1. If the input has a consistent structure, reach for a parser, regex, or query — not free-form reasoning.
2. Show the script and its real output, not just the final number.
Reserve your reasoning for judgement, generation, and ambiguity — the work that has no single right answer.
```

Nguồn: https://craftagent.cloud/vi/viec-co-dinh-thi-dung-script/

---

## 5. Chẩn đoán từ triệu chứng, không từ phỏng đoán

*Một prompt buộc chẩn đoán thật trước khi viết một dòng sửa nào.*

**Rule:** Một bản sửa nhắm vào phỏng đoán chỉ là con bug kế tiếp — đọc triệu chứng trước khi đụng code.

```
Before proposing any fix, diagnose first:
1. Reproduce the symptom and paste the actual error or wrong output — the real text, not a paraphrase.
2. Trace it to a root cause. State the cause and the specific evidence that points to it.
3. Only then propose the smallest change that addresses that cause.
If I say it's still broken, do not try a different patch — re-read the new output and re-diagnose. A second failed fix means the first diagnosis was wrong.
```

Nguồn: https://craftagent.cloud/vi/chan-doan-tu-trieu-chung/

---

## 6. Bắt nó phản biện chính kế hoạch của nó

*Một prompt ép một cách tiếp cận chịu thử lửa trước khi bạn đổ một dòng code nào vào nó.*

**Rule:** Cách tiếp cận sống sót qua lập luận phản bác mạnh nhất của chính nó mới đáng để build.

```
Before we build this, pressure-test the approach:
1. Restate the plan in two lines.
2. Argue against it: where is it most likely to break, what assumption is it leaning on, and what would make you abandon it?
3. Name one simpler alternative, and say why you would or wouldn't take it.
Then give your honest recommendation. Don't defend the first idea — pick the approach most likely to survive the real problem.
```

Nguồn: https://craftagent.cloud/vi/bat-no-phan-bien-ke-hoach/

---

## 7. Bàn giao cho phiên làm việc sau

*Một slash command biến một phiên thành ghi chú mà phiên kế tiếp cầm lên là chạy.*

**Rule:** Một phiên không thể cầm lên từ con số không là một phiên bạn sẽ phải làm lại từ trí nhớ.

```
---
description: Summarize this session into a handover note for the next one
---
Write a concise handover note for whoever picks this up next — a fresh session, or someone else:
- **Done**: what changed this session, in a line or two.
- **State**: what works now, and what is half-finished.
- **Next**: the single next action, concretely.
- **Gotchas**: anything that will trip up the next session.
Keep it short enough to read in thirty seconds. State, not narration — skip the thought process.
```

Nguồn: https://craftagent.cloud/vi/ban-giao-cho-phien-sau/

---

## 8. Một bản review không đóng dấu cho qua

*Một Skill tái dùng được, review một thay đổi để tìm vấn đề thật thay vì duyệt theo phản xạ.*

**Rule:** Một bản review thật nêu rõ nó đã kiểm gì — "trông ổn" thì chẳng nêu gì cả.

```
---
name: review-changes
description: Review a diff for real problems before it ships — no rubber-stamping
---
Review the change across these dimensions, in order:
1. **Correctness** — does it do what it claims? Trace one real input through the new path.
2. **Edge cases** — empty, null, huge, the second call, concurrent access. Where does it fall at the edges?
3. **Blast radius** — what else calls this? What silently changes for them?
4. **Readability** — could the next person change it without you in the room?

For each finding, report: `file:line` · severity (blocker / should-fix / nit) · why it matters · the smallest fix.
If you find nothing, say what you checked and why you're confident. Never approve by default.
```

Nguồn: https://craftagent.cloud/vi/review-khong-dong-dau/

---

## 9. Chạy tới cổng thì dừng, không phải soi từng bước

*Một prompt cho agent tự chạy nhưng dừng đúng mấy chỗ đáng dừng — để bạn buông tay mà không mất kiểm soát.*

**Rule:** Đừng chọn giữa soi-từng-bước và buông-hẳn — cho agent chạy tự do tới các cổng đã định rồi dừng chờ duyệt.

```
Work through this task autonomously — don't ask me about routine steps. But treat these as hard stops: pause and wait for my go-ahead before each.

- Before anything that writes, deletes, deploys, sends, or is otherwise hard to undo.
- Before you move from one phase of the work to the next.
- Whenever you hit a decision you're less than about 80% sure of.

At each stop, give me three short lines — what you just did, what's next, and why — then wait. Everything between the gates, just do.
```

Nguồn: https://craftagent.cloud/vi/chay-toi-cong-thi-dung/

---

## 10. Bộ khung CLAUDE.md — biến file mô tả thành luật vận hành

*Một khung tối thiểu để dán vào CLAUDE.md, nói cho agent biết phải mặc định gì, khi nào dừng hỏi, và chỗ nào nguy hiểm.*

**Rule:** CLAUDE.md không phải README — viết nó thành luật agent phải theo, không phải đoạn giới thiệu agent có thể bỏ qua.

```
# <Project> — CLAUDE.md

## What this is
<one line: what it does, who it's for — keep it to a line>

## Conventions (follow these by default, without being told)
- <naming / structure / style the agent must default to>
- <the thing you keep having to repeat — write it here once>

## Stop and ask — do not guess
- When a requirement is ambiguous, ask before choosing.
- Before any destructive or irreversible action.

## Danger zones (handle with extra care)
- <files/areas where a mistake is expensive>

## Before you say it's done
- <how to verify: run it / show the real output / the check that must pass>
```

Nguồn: https://craftagent.cloud/vi/bo-khung-claude-md/

---

## 11. Vòng review hàng tuần — năm phút biến trải nghiệm thành kỹ năng

*Ba câu hỏi mỗi tuần để biết mình đang giỏi lên hay chỉ quen dần với mức tầm tầm.*

**Rule:** Không có vòng phản hồi thì trải nghiệm không thành kỹ năng — năm phút mỗi tuần, ba câu, chỉnh một thứ.

```
Weekly review (5 minutes). Answer three, one line each:

1. One thing that did NOT work with the agent this week — what, and why?
2. One thing that DID work — what made it work, so I can repeat it on purpose?
3. The single template, prompt, or rule I'll change because of (1) and (2).

Keep it to three lines. This isn't a report — it's turning this week's experience into next week's skill. If nothing changes in line 3, the review didn't do its job.
```

Nguồn: https://craftagent.cloud/vi/vong-review-hang-tuan/

---

## 12. Chia việc thành mảnh gọn, mỗi mảnh một context sạch

*Một prompt buộc agent bẻ việc lớn thành vài mảnh độc lập kiểm được — thay vì nhét tất cả vào một lần chạy mù.*

**Rule:** Đừng giao một khối to nhập nhằng — bắt nó chia thành vài mảnh gọn, mỗi mảnh context sạch và kiểm được riêng.

```
Before doing this, split it into focused slices I can check independently:

1. Break the task into 2-4 sub-tasks, each with a clear, separate goal.
2. For each slice, list ONLY the context it actually needs — don't carry the whole task into every piece.
3. Do them one at a time (or hand each to a fresh sub-agent), keeping each slice's context clean.
4. At the end, reconcile: show how the pieces fit together and flag any conflicts between them.

Tell me the split first — the slices and what context each gets — and wait for my OK before you start.
```

Nguồn: https://craftagent.cloud/vi/chia-viec-thanh-manh-gon/

---

## 13. Việc này có đáng giao cho agent không — hỏi trước khi mở chat

*Một prompt pre-flight buộc agent tự soi xem việc có đáng giao, thay vì cắm đầu làm một việc lẽ ra một dòng lệnh.*

**Rule:** Câu hỏi đầu không phải "prompt sao cho khéo" — mà "việc này có đáng giao cho agent không"; bắt nó tự soi trước khi làm.

```
Before we start, sanity-check whether this is even worth handing to you:

- Is it deterministic — one right answer every time? If so, a script or a fixed tool beats me. Say so.
- Is it a quick one-off I could do by hand faster than writing this prompt? If so, say so.
- Does it need judgment AND repeat often? That's where handing it to you actually pays off.

If this task isn't a good fit for an agent, tell me plainly — don't just do it anyway. I'd rather hear "use a script for this" than spend the overhead and find out later.
```

Nguồn: https://craftagent.cloud/vi/viec-nay-co-dang-giao/

---

## 14. Thử một việc nhỏ trước khi tin agent ở miền mới

*Một prompt buộc agent làm một mảnh nhỏ và lộ cách nó nghĩ — trước khi bạn giao nguyên việc lớn ở lĩnh vực nó chưa từng chứng minh.*

**Rule:** Cùng một agent behave khác nhau tùy miền — thử một mảnh nhỏ và soi cách nó nghĩ trước khi giao việc lớn ở domain mới.

```
This is a new kind of task for you, so let's calibrate before I hand over the real thing:

1. I'll give you a small, representative slice first — do just that, not the whole task.
2. Show your work: not only the result, but how you reached it and where you were unsure.
3. Then stop and wait. I'll check whether your approach matches what this domain actually needs.

Don't scale up to the full task until I've seen the small one and said go. A good result on a tiny slice — reached the right way — tells me how much to trust you on the big one.
```

Nguồn: https://craftagent.cloud/vi/thu-truoc-khi-tin/

---

_craftagent.cloud_