Ôn nhanh CCAR-F
Bảng tra cứu cô đọng từ tài liệu ôn.
- Bước bắt buộc mọi lần, sai là mất tiền (xác minh trước khi hoàn tiền) — Ép bằng code/gate/hook — không chỉ prompt hay few-shot
- Agent chọn nhầm giữa hai tool giống nhau, mô tả sơ sài, hỏi bước đầu tiên — Viết lại mô tả tool (input, ví dụ, ranh giới)
- Agent chuyển người ca dễ nhưng tự xử ca cần ngoại lệ chính sách — Tiêu chí escalation rõ ràng + few-shot trong system prompt
- Phương án dùng điểm tự tin tự khai hoặc sentiment làm ngưỡng — Thường sai — không phản ánh độ phức tạp thật
- Khách đòi gặp người — Chuyển ngay, không điều tra trước
- Tra ra nhiều khách trùng tên — Hỏi thêm thông tin định danh, không tự chọn
- "Mọi developer có ngay khi clone/pull repo" — Scope project: .claude/commands/, .claude/skills/, .mcp.json, CLAUDE.md của project
- Thành viên mới không nhận được quy ước — Quy ước nằm ở ~/.claude/CLAUDE.md của người khác → chuyển vào CLAUDE.md của project
- File test rải khắp repo, cần cùng quy ước "bất kể vị trí" — .claude/rules/ với paths glob
- Hàng chục file, quyết định ranh giới service/kiến trúc — Plan mode
- Bug một file, stack trace rõ — Làm thẳng (direct execution)
- Subagent đều chạy đúng nhưng báo cáo thiếu cả mảng; log coordinator cho thấy chia hẹp — Lỗi ở phân rã của coordinator
- Subagent timeout, coordinator cần phục hồi — Trả lỗi có cấu trúc: loại lỗi, truy vấn đã thử, kết quả dở dang, hướng thay thế
- 85% việc đơn giản, 15% phức tạp, round-trip qua coordinator tốn thời gian — Cấp tool hẹp cho ca phổ biến; ca phức tạp vẫn qua coordinator
- Job CI treo chờ input — Thêm -p (--print)
- Phương án nhắc CLAUDE_HEADLESS, --batch, .claude/config.json — Tính năng không tồn tại → loại
- Cần kết quả máy đọc được để đăng comment PR — --output-format json + --json-schema
- "Tiết kiệm 50%" cho việc chặn merge — Không dùng Batches (không có SLA độ trễ); việc qua đêm thì dùng
- Review nhiều file một lượt: chỗ kỹ chỗ sơ, nhận xét mâu thuẫn — Từng file + một lượt tích hợp
- Phiên vừa sinh code tự review — Dùng instance độc lập
- Quá nhiều false positive; phương án "hãy thận trọng" — Tiêu chí cụ thể theo hạng mục; tạm tắt hạng mục nhiễu
- Hướng dẫn chi tiết rồi mà định dạng vẫn không đều — 2–4 ví dụ few-shot nhắm ca mơ hồ, kèm lý do
- Trường có thể không có trong tài liệu, model bịa giá trị — Để trường nullable/optional
- JSON đúng schema nhưng tổng tiền sai — Lỗi ngữ nghĩa → validate (calculated_total vs stated_total) rồi retry kèm lỗi cụ thể
- Thông tin nằm ở tài liệu khác chưa gửi — Retry vô ích — cần đưa nguồn vào
- Độ chính xác tổng 97%, muốn bớt duyệt tay — Đo theo loại tài liệu / theo trường; lấy mẫu phân tầng
- Hai nguồn uy tín đưa số khác nhau — Ghi cả hai, kèm nguồn và ngày; không lấy trung bình
- Hội thoại dài mất số tiền, ngày, cam kết — Khối "case facts" riêng gửi kèm mỗi prompt
- Token/API key cần cho server trong .mcp.json — Dùng ${ENV_VAR}, không commit bí mật
- Agent cứ dùng Grep thay vì tool MCP mạnh hơn — Mô tả tool MCP chi tiết hơn
- Quy tắc phải đúng mọi lần (chặn lệnh nguy hiểm, hạn mức hoàn tiền) — Hook PreToolUse / gate bằng code
- Chuẩn hóa kết quả tool trước khi model đọc — Hook PostToolUse
- Định hướng giọng điệu, phong cách — Prompt / few-shot
- Chuẩn chung cho cả team, áp dụng mọi phiên — CLAUDE.md của project
- Quy ước cho file khớp một mẫu, ở bất kỳ đâu — .claude/rules/ + paths
- Quy trình dùng lại, gọi khi cần — Skill (.claude/skills/)
- Quy trình có đầu ra dài, không muốn làm đầy context chính — Skill với context: fork
- Việc rộng, song song được (nghiên cứu nhiều hướng) — Coordinator + subagent
- Việc tuần tự, phụ thuộc chặt, cần chung context — Một agent
- Các bước biết trước / việc mở không đoán trước — Prompt chaining / phân rã động
- Lỗi tạm thời (timeout) — Retry tại chỗ; vẫn lỗi → trả lỗi có cấu trúc cho coordinator
- Vi phạm quy tắc nghiệp vụ (quá hạn đổi trả) — Không retry — giải thích cho khách
- Khách đòi gặp người / chính sách không nói tới / không tiến triển — Escalate kèm tóm tắt có cấu trúc
- Chờ được hàng giờ / chặn người dùng — Message Batches / gọi đồng bộ
- Thay đổi lớn, nhiều hướng / sửa nhỏ, rõ phạm vi — Plan mode / làm thẳng
- Tiếp tục / thử hướng khác mà giữ bản gốc / kết quả tool đã cũ — --resume / fork (--fork-session, fork_session) / phiên mới + tóm tắt
- -p, --print — Chạy không tương tác: in kết quả rồi thoát
- --output-format — Định dạng đầu ra ở print mode: text, json, stream-json
- --json-schema — JSON đã validate theo schema (chỉ print mode), nằm ở structured_output
- --max-turns — Giới hạn số lượt agent (print mode)
- --resume, -r — Tiếp tục phiên theo ID hoặc tên, hoặc mở bộ chọn
- --continue, -c — Mở hội thoại gần nhất trong thư mục hiện tại
- --fork-session — Khi resume, tạo session ID mới thay vì dùng lại bản gốc
- fork_session / forkSession — Agent SDK (Python / TS): rẽ nhánh phiên, dùng cùng resume
- --permission-mode plan — Khởi động ở plan mode
- .mcp.json — MCP server scope project, commit cho team
- ~/.claude.json — MCP server scope local (mặc định) và user — riêng bạn
- ~/.claude/CLAUDE.md — Chỉ dẫn cấp user, chỉ của bạn, mọi project
- ./CLAUDE.md, ./.claude/CLAUDE.md — Chỉ dẫn cấp project, commit cho team
- @path/to/file — Import file vào CLAUDE.md
- /memory — Duyệt và mở các file nhớ trong phiên
- .claude/rules/ + paths: — Rule chỉ nạp khi làm việc với file khớp glob
- .claude/commands/ — Slash command của project (đã gộp vào skills)
- .claude/skills/<name>/SKILL.md — Skill của project
- context: fork — Chạy skill trong subagent fork
- argument-hint — Gợi ý tham số khi autocomplete
- allowed-tools (skill) — Docs: tool dùng không cần hỏi trong lượt đó. Guide v1.0: giới hạn tool
- disable-model-invocation: true — Claude không tự nạp skill; chỉ chạy khi gõ /name
- .claude/agents/ — Định nghĩa subagent của project (frontmatter name, description, tools, model)
- permissionDecision: "deny" — Hook PreToolUse chặn lời gọi tool, kèm permissionDecisionReason
- /compact — Nén context (có thể kèm trọng tâm cần giữ)