Điều chỉnh độ sâu giải thích với ak:coding-level

Dùng ak:coding-level để lưu lượng giải thích, teaching structure cùng strategic context bạn muốn trong response tương lai. Level đã chọn được lưu dưới key codingLevel trong .claude/.ck.json; nó thay đổi communication style, không thay đổi code standard hoặc safety rule của project.

Chọn ak:coding-level cho preference bền vững

Dùng ak:coding-level khi

• Giải thích thường xuyên quá cơ bản hoặc quá ngắn với bạn.
• Bạn muốn beginner teaching, professional design context hoặc lead-level risk framing tiếp tục trong session sau.
• Bạn muốn project-scoped preference thay vì lặp response-format instruction trong mọi prompt.

Chọn workflow khác khi

• Bạn cần chỉnh tone cho một response; hãy nêu trực tiếp trong request.
• Bạn cần đổi linting, language, architecture hoặc review requirement. Coding level không override repository instruction.
• Bạn cần guarantee độc lập runtime. Automatic injection được chứng minh bằng Engineer session-start Hook, còn hỗ trợ đầy đủ Hook là Claude-specific.

Chuẩn bị preference

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài trong project scope dự kiến.
• Chọn một integer rõ ràng từ 0 tới 5.
• Giữ nguyên key không liên quan trong .claude/.ck.json.
• Mở supported session mới sau khi đổi value nếu muốn xác minh automatic injection.

Xem Runtime adapter trước khi dựa vào hành vi dựa trên Hook bên ngoài Claude Code.

Đặt level

Skill nhận một level. Metadata của Skill tắt automatic model invocation, vì vậy hãy chọn Skill rõ ràng thay vì chờ assistant tự thay preference.

/ak:coding-level 2

/ak:coding-level 2

$ak:coding-level 2

Không có hành vi được mô tả cho argument bị bỏ trống hoặc ngoài range. Hãy cung cấp level hợp lệ hoặc yêu cầu runtime làm rõ thay vì đoán.

Hiểu điều gì xảy ra trong một lần chạy

1. Bạn chọn level. Skill nhận value rõ từ 0 đến 5.
2. Preference được lưu. Skill cập nhật codingLevel trong .claude/.ck.json và giữ phần còn lại của project configuration.
3. Supported session khởi động. Engineer session-start Hook tải config và mặc định level 5 khi thiếu codingLevel.
4. Hook map level sang guidance. Hook expose selected style name và inject communication rule tương ứng vào session context.
5. Response theo profile. Explanation depth, hình dạng code example cùng response section đổi; repository constraint và approval boundary không đổi.

Claude Code cũng cung cấp sáu manual style có tên qua setting Output style trong /config. Native install emit các style vào directory output-styles/ ở runtime root; explicit plugin install emit chúng vào output-styles/ ở plugin root. Session Hook resolve active layout này trước, rồi mới thử legacy sidecar .agentkit/output-styles/. Nếu cả hai nơi đều không có style đã chọn, Hook emit diagnostic thay vì âm thầm bỏ qua guidance.

AgentKit chưa xác minh discovery qua /output-style bằng runtime canary. Source không thiết lập manual style selection trên Cursor hoặc Codex, vì vậy xem tính năng đó ở các runtime này là unsupported trừ khi live runtime hiển thị.

Giữ thay đổi đúng scope

• Review diff .claude/.ck.json vì preference tồn tại qua các session trong project đó.
• Đừng thay toàn bộ config file chỉ để đổi một key.
• Skill không nêu provider, network call, subprocess, paid service hay large disk effect nào ngoài config edit nhỏ.
• Manual output-style selection có thể ảnh hưởng current response shape mà không chứng minh persisted preference đã được tải.
• Style cùng tên do bạn tạo được giữ lại kèm warning trong lần ak update thông thường. ak kit init --force chỉ có thể thay collision của Kit đã chọn; --fresh thực hiện riêng việc reset install target đã chọn bằng snapshot.

Xác minh kết quả

Một lần chạy hoàn tất nên cung cấp:

• Value codingLevel hợp lệ trong .claude/.ck.json.
• Không có config change không liên quan.
• Trên supported fresh session, guidance khớp rõ selected profile.
• Ví dụ ở level 1, giải thích dẫn bằng why, nêu common pitfall và có key takeaways cho work quan trọng.

Skill không định nghĩa standalone test. Hãy xác minh persisted JSON, restart supported runtime và so sánh response quan sát được với selected level.

Xử lý sự cố hoặc tiếp tục

Biết các giới hạn hiện tại

• Automatic injection phụ thuộc Engineer session-start Hook; exact source cung cấp bằng chứng đầy đủ cho Claude Code, không cho hành vi Cursor hoặc Codex tương đương.
• Sáu profile là default rộng, không phải phép đo ability.
• Package stable và beta hiện chứa cùng ak:coding-level, output-style cùng relevant session-injection content.