Tóm tắt nhanh:
ak-journalghi lại chuyện gì đã xảy ra trong phiên, vì sao, và việc gì còn dở, rồi lưu bằngak journal createvàoplans/journals/. Nó thường chạy tự động cuốiak-cook,ak-fix,ak-shipvà là bước cuối, không chuyển cho skill nào. Nó không thay ADR hay docs, và không tự đăng lên mạng xã hội.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn vừa sửa xong một lỗi khó, kết thúc một phiên làm nhiều việc, hoặc muốn ghi thẳng về một lần thất bại để mai mở lại biết mình đang ở đâu. Không cần khi điều bạn muốn giữ là một quy tắc lâu dài: cái đó ghi vào ADR hoặc docs của project.
flowchart LR
A["ak-cook, ak-fix, ak-ship"] --> B["ak-journal"]
U["Bạn gọi tay"] --> B
B --> C["File trong plans/journals/"]
B --> D["Đăng mạng xã hội, chỉ khi bạn yêu cầu"]
C --> E["Dừng, là bước cuối"]Nó dựa trên 4 ý:
| Ý | Câu hỏi | Ví dụ |
|---|---|---|
| Lịch sử, không phải quyết định | Điều này nên ghi vào nhật ký hay vào docs? | "Đã thử 3 cách cache, cách thứ hai làm lộ dữ liệu cũ" vào nhật ký. Quy tắc "mọi cache dùng Redis" vào ADR hoặc docs của project. |
| Lưu bằng CLI | File nằm ở đâu và tên gì? | plans/journals/2026-10-21-session-expiry-fix.md. Tạo thêm bài cùng tên trong ngày thì thành ...-2.md, ...-3.md. Xem lại bằng ak journal list, ak journal show <slug> hoặc trang Journals trên desktop. |
| Tự động và gọi tay | Khi nào nhật ký tự được viết, và tắt thế nào? | Cuối ak-plan, ak-cook, ak-fix, ak-ship, ak-bootstrap có bước viết nhật ký tự động. Tắt cho một lần bằng --skip-journal trên skill đó, tắt hẳn bằng ak config prefs set journal.auto false. Gọi /ak-journal bằng tay thì luôn chạy. |
| Local trước, mạng xã hội sau | Có kênh đã cấu hình thì nó có tự đăng không? | Không. Phải nói rõ "đăng lên mạng xã hội". Kể cả khi đó, nó xem trước đúng kênh và nội dung, và chỉ báo đăng xong khi có biên nhận từ nhà cung cấp. |
Nhật ký tốt là cụ thể: lỗi thật, đường dẫn thật, kết quả thật. Tắt journal.auto chỉ tắt bước tự động cuối workflow, gọi /ak-journal bằng tay vẫn chạy.
Prompt mẫu sau khi sửa bug:
/ak-journal Ghi lại vụ sửa lỗi <tên lỗi>: nguyên nhân gốc, thay đổi chính,
ảnh hưởng tới người dùng, quyết định đã chọn và việc còn dở.Skill này không có cờ.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, cách truyền tuỳ chọn khi skill không có cờ, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-journal: ghi phiên làm việc thành nhật ký kỹ thuật" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-journal". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-journal
