Tiến độ sẽ không được lưu. Trình duyệt đang chặn lưu dữ liệu (thường do chế độ ẩn danh). Bạn vẫn học bình thường, nhưng đóng tab là mất tiến độ.
Phần luyện tập cần bật JavaScript. Bài đọc vẫn xem được bình thường.Về bài đọc
| Vai | Công cụ | Điểm đặc biệt |
|---|---|---|
| reviewer | Read, Grep, Glob, Bash | memory: project: nhớ quy ước của team qua các phiên |
| tester | Read, Grep, Glob, Bash | model: haiku: rẻ, nhanh, chỉ báo test lỗi |
| debugger | Read, Edit, Bash, Grep, Glob | isolation: worktree: sửa trên bản sao riêng của repo |
Nguyên tắc chung: mỗi vai chỉ có đúng những gì nó cần. Reviewer không cần sửa file nên không có Edit hay Write. Tester chỉ chạy lệnh và đọc kết quả. Chỉ debugger được sửa code, và nó sửa ở chỗ riêng.
Cả ba file đặt trong .claude/agents/ của todo-api và commit để cả team dùng chung.
---
name: reviewer
description: Reviews the current branch against main for todo-api. Use when the user asks for a code review or before opening a pull request.
tools: Read, Grep, Glob, Bash
model: inherit
memory: project
---
You review todo-api changes. Never change project files; the only files you may write are in your memory directory.
1. Check your memory for the team's preferences and past findings
2. Run git diff main...HEAD and read the changed files in full
3. Report by priority: must fix, should fix, consider. Give file:line and a suggested fix for each
4. Save new team preferences or recurring problems to your memory, one short line eachmodel: inherit nghĩa là dùng model của hội thoại chính, vì review cần suy luận tốt.
Trường memory cho subagent một thư mục nhớ lâu dài. Với project, thư mục là .claude/agent-memory/reviewer/, commit được để cả team cùng hưởng. Ngoài ra có user (~/.claude/agent-memory/, dùng cho mọi dự án) và local (.claude/agent-memory-local/, không commit). Docs khuyên dùng project. Mỗi lần chạy, subagent đọc phần đầu file MEMORY.md trong thư mục đó.
Khi thử, chúng tôi bảo reviewer: "team mình thích return sớm và không bao giờ log trong route handler". Nó chỉ ra dòng console.log trong route là lỗi phải sửa, rồi tự tạo MEMORY.md cùng một file ghi hai quy ước đó. Lần review sau, nó bắt đầu từ những gì đã biết.
Cái bẫy: bật memory thì Claude Code tự cấp Read, Write và Edit cho subagent để nó ghi file nhớ, dù tools không có Write. Reviewer của chúng tôi đã dùng Write để ghi trí nhớ. Nó không còn "chỉ đọc" theo nghĩa kỹ thuật. Vì vậy prompt phải nói rõ chỉ được ghi vào thư mục nhớ. Nếu cần chặn cứng, dùng hook ở cấp 6.
Bash cũng là một cửa ngõ: reviewer cần git diff, nhưng Bash chạy được mọi lệnh. Lệnh nguy hiểm thì chặn bằng luật deny trong cài đặt, như bài 4.2.
---
name: tester
description: Runs the todo-api test suite and reports only what failed. Use after code changes or when asked whether the tests pass.
tools: Read, Grep, Glob, Bash
model: haiku
---
Run npm test. Do not edit any file.
If everything passes, reply with one line: the number of tests that passed.
If anything fails, reply with, for each failing test: its name, the assertion that failed (expected vs actual) and the file:line of the test. Nothing else.Đây là mẫu "cô lập việc nhiều output" của bài 4.1, đóng gói lại thành file. Chạy test không cần suy luận sâu, nên model: haiku là đủ, nhanh và rẻ hơn. Khi thử, tester chạy đúng trên Haiku 5.5 và chỉ gọi npm test một lần.
Phần đáng giá nhất là định dạng báo cáo. "Nothing else" giữ cho hội thoại chính chỉ nhận vài dòng, dù bộ test in ra hàng trăm dòng. Tester khác test-writer ở bài 4.2: một bên chạy, một bên viết. Tách ra thì vai nào cũng rõ việc.
---
name: debugger
description: Finds the root cause of a bug or failing test in todo-api and fixes it. Use when a test fails or the API behaves unexpectedly.
tools: Read, Edit, Bash, Grep, Glob
isolation: worktree
---
You fix bugs in todo-api.
1. Reproduce the problem with a failing test in test/todos.test.js
2. Find the root cause; explain it in two or three sentences with file:line
3. Make the smallest fix in src/ that makes the test pass
4. Run npm test; every test must pass
5. Commit the test and the fix on your current branch, then report the cause, the fix and the branch nameisolation: worktree cho debugger một git worktree (một bản checkout thứ hai của cùng repo, nằm ở .claude/worktrees/). Nó sửa ở đó, còn thư mục bạn đang làm không bị đụng tới. Nếu nó không thay đổi gì, worktree tự bị xóa.
Ba điều chúng tôi học được khi chạy thật:
- Worktree bắt đầu từ nhánh mặc định trên remote (thường là
origin/main), không phải từ chỗ bạn đang đứng. Lần thử đầu, debugger không thấy commit cục bộ chưa push của chúng tôi. Muốn nó bắt đầu từ HEAD hiện tại, đặt"worktree": {"baseRef": "head"}trong cài đặt. Thay đổi chưa commit thì vẫn không đi theo. - Lời giao việc thắng file agent. Chúng tôi chỉ nói "sửa lỗi này". Claude viết lời giao việc kèm câu "Do NOT commit or push" vì bạn chưa hề nhắc tới commit, và debugger làm theo câu đó thay vì bước 5. Thêm vào yêu cầu: "let it commit the fix on its own branch". Lần sau, nó commit và báo tên nhánh.
- Lấy kết quả về bằng git. Debugger báo tên nhánh, ví dụ
fix/double-delete-404. Ở thư mục chính, chạygit merge fix/double-delete-404, kiểm tranpm test, rồigit worktree removeđể dọn. Thêm.claude/worktrees/vào.gitignore.
Worktree là bản checkout mới nên không có file bị ignore như .env. Liệt kê những file cần chép sang trong file .worktreeinclude ở gốc repo, cú pháp giống .gitignore.
Ba vai mạnh nhất khi chạy nối tiếp. Một câu là đủ:
First use the tester agent to check whether the tests pass.
Then use the debugger agent to fix what fails, and let it commit
the fix on its own branch.Claude gọi tester trước, đưa kết quả cho debugger, rồi tổng hợp lại cho bạn. Cuối cùng gọi reviewer xem lại nhánh của debugger trước khi merge.
Hai điều nên biết thêm:
- Mỗi lần gọi tạo một subagent mới. Muốn nó làm tiếp với đầy đủ những gì đã biết, nhờ Claude làm tiếp: "Continue that review and now check the tests too". Claude resume đúng subagent đó với toàn bộ lịch sử của nó.
- Muốn tạm cấm một vai, thêm
Agent(debugger)vàopermissions.denytrong cài đặt. Cách này dùng được cho cả subagent có sẵn nhưAgent(Explore).
Nhiệm vụ của bài ráp cả ba vai trên todo-api:
- Tạo ba file trong
.claude/agents/như trên. - Gây một lỗi có chủ đích: trong
POST /todos, đổistatus(201)thànhstatus(200)rồi commit. Thêm một dòngconsole.logvào một route. - Gọi reviewer, kèm quy ước "never log from route handlers". Mở
.claude/agent-memory/reviewer/xem nó đã ghi gì. - Gọi tester rồi debugger bằng câu nối ở trên. Merge nhánh debugger báo về và chạy lại
npm test.
Khi đã quen, bạn sẽ thấy việc chia vai giống chia việc trong một team thật: mỗi người một việc rõ ràng, có đúng quyền họ cần, và báo lại ngắn gọn. Cấp sau rời khỏi repo: nối Claude Code với công cụ bên ngoài qua MCP.