Thiết kế context đáng tin cậy với ak:context-engineering

Dùng ak:context-engineering để hoàn tất công việc được yêu cầu với ít lãng phí context, chi phí, thời gian và bước agent hơn. Tối ưu outcome đầy đủ, gồm failure, retry và verification. Không cắt scope hay verification bắt buộc để đạt mục tiêu hiệu quả. Skill không đổi model setting, API key, billing hay provider quota.

Chọn ak:context-engineering cho vấn đề context

Dùng ak:context-engineering khi

• Session dài làm mất fact quan trọng, trộn task hoặc gần chạm context limit.
• Bạn cần giảm token nhưng vẫn giữ decision, lịch sử tệp và next step.
• Bạn đang thiết kế retrieval, memory, mô tả tool hoặc context isolation cho hệ thống agent.
• Bạn muốn so sánh context gốc với summary đã nén bằng probe.

Chọn workflow khác khi

• Bạn cần fact hoặc vị trí tệp trong repository. Dùng ak:scout trước.
• Bạn cần tài liệu bên ngoài hiện hành. Dùng ak:docs-seeker.
• Bạn cần implementation thay vì context design. Chuyển sang planning hoặc ak:cook sau khi proposal có acceptance criteria đo được.
• Bạn chỉ cần quota chính thức của runtime. Xem status surface của runtime; Skill không tạo usage data và không đọc credential file để lấy số đó.

Chuẩn bị bằng chứng và runtime

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho đúng runtime cùng scope.
• Nêu failure quan sát được, model hoặc runtime limit nếu biết, và evidence phải sống sót sau khi nén.
• Xác định message, tool output, credential hoặc dữ liệu khách hàng nhạy cảm không được sao chép vào summary, tệp hay dịch vụ bên ngoài.
• Để phân tích bằng script, chuẩn bị JSON UTF-8 là mảng message hoặc object có mảng messages.

Xem Runtime adapter trước khi coi usage signal riêng của một runtime là bằng chứng có thể chuyển đổi.

Chạy Skill

/ak:context-engineering "Tool output chiếm phần lớn một debugging session dài. Hãy thiết kế policy nén giữ lại error, decision, tệp đã đổi và next step; không ghi tệp."

/ak:context-engineering "Tool output chiếm phần lớn một debugging session dài. Hãy thiết kế policy nén giữ lại error, decision, tệp đã đổi và next step; không ghi tệp."

$ak:context-engineering "Tool output chiếm phần lớn một debugging session dài. Hãy thiết kế policy nén giữ lại error, decision, tệp đã đổi và next step; không ghi tệp."

Skill nhận một topic hoặc câu hỏi và không công bố mode flag. Hãy yêu cầu output cụ thể như diagnosis, budget, compression policy, so sánh chọn model, memory design, tool review hoặc evaluation plan.

Khi so sánh model hoặc harness, giữ đủ bốn metric cốt lõi: chi phí trung bình mỗi task, thời lượng task trung bình, chi phí ước tính cho lần thành công đầu, và số bước agent trung bình. Trước hết yêu cầu success đủ cho task. Sau đó so sánh chi phí per first-attempt success và duration. Dùng raw cost để lập ngân sách và steps để chẩn đoán lãng phí. Đừng gộp metric tương quan thành một điểm. Trường thiếu vẫn unknown; không có ranking cứng hay tự đổi model.

Analyzer cục bộ tùy chọn

Các utility Python đọc tệp tối đa 100 MiB và không tự tạo output file. Shell redirection hoặc yêu cầu ghi riêng sẽ thay đổi ranh giới này. Evaluator dùng heuristic; comment trong source dành model-based judging thật cho implementation production.

Hiểu các giai đoạn của lần chạy

1. Skill xác định context failure. Nó tách áp lực capacity khỏi distraction, contradiction, poisoning, lost-in-the-middle hoặc thiếu persistence.
2. Skill đo trước khi tối ưu. Usage number đến từ runtime display hoặc script estimate cục bộ. Phần trăm thiếu không được lấy từ credential hay provider API.
3. Skill chọn strategy có giới hạn. Source nhóm lựa chọn thành write, select, compress và isolate, rồi chỉ nạp reference phù hợp.
4. Skill giữ task contract. Goal, decision, constraint, artifact history, current state và next step vẫn rõ ràng.
5. Skill đề xuất hoặc thực hiện thao tác đã yêu cầu. Advice ở trong hội thoại; analyzer đọc tệp cục bộ; design hoặc summary được yêu cầu có thể ghi vào path đã duyệt.
6. Skill kiểm tra chất lượng. Probe kiểm tra factual recall, artifact, continuation và decision rationale thay vì chỉ tin mức giảm token.

Giữ context và credential an toàn

• Đọc context, summary hoặc memory file cục bộ cần quyền trên path đó; ghi hoặc thay thế chúng cần ranh giới artifact rõ ràng.
• Usage và context number đến từ runtime display hoặc script estimate. Skill không đọc, in hay truyền credential file, OAuth token hoặc API key để báo usage.
• Context isolation qua agent khác có thể nhân model usage và cost. Hãy xin phép trước khi thêm paid provider, parallelism rộng hoặc external storage.
• Memory system đề xuất không tự cấp quyền thu thập, lưu giữ hoặc lưu chéo session dữ liệu cá nhân.
• Không bỏ context gốc hoặc ghi đè trusted summary trước khi kết quả nén vượt qua các probe bắt buộc.

Xác minh kết quả

Một lần chạy hướng dẫn hoàn chỉnh nên nêu failure quan sát được, evidence đã dùng, strategy đã chọn, preservation contract, tác động token hoặc latency dự kiến và phép thử có thể bác bỏ proposal. Lần chạy script cũng phải báo input file, thao tác chính xác, exit status, JSON output và mọi giới hạn estimate hoặc heuristic.

Chỉ coi kết quả là bằng chứng khi critical fact vẫn truy xuất được, artifact history và next step còn nguyên, material mâu thuẫn hoặc cũ đã được xác định và thay đổi không âm thầm mở rộng persistence, provider access hay cost.

Khắc phục sự cố hoặc tiếp tục

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

• Script đi kèm ước tính token bằng số ký tự đơn giản; đây không phải billing record của provider hay token count chính xác theo tokenizer.
• Số liệu attention, degradation, cost và performance trong source là design guidance, không phải phép đo hệ thống của bạn.
• Skill không tự tạo context bundle, memory store, graph hay evaluation dataset.
• External model judging, retrieval service và persistent store cần tool, credential, privacy review và cost approval riêng.