Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:journal

Nhật ký kỹ thuật theo phiên

Lưu nhật ký kỹ thuật theo thời gian dưới plans/journals bằng CLI chính thức, giữ lịch sử công việc mà không thay thế docs hiện tại, ADR hoặc nguồn quyết định sản phẩm.

Thu thập sự kiện

Soạn entry ngắn

Lưu bằng CLI

Validate khi cần

Nguyên tắc 01

Ưu tiên lỗi, path, outcome và quyết định cụ thể hơn retrospective mơ hồ.

Nguyên tắc 02

Lưu bằng ak journal create; không để journal chỉ nằm trong chat.

Nguyên tắc 03

Bước journal tự động do flag rõ ràng và thứ tự config điều khiển.

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

Khởi động

Đầu vào, phạm vi, route

1 Thu thập sự kiện Thu thập root cause, thay đổi chính, ảnh hưởng, quyết định, bước tiếp theo, lỗi cụ thể, path và outcome của session.
2 Soạn entry ngắn Viết title ngắn và body Markdown có bằng chứng cụ thể thay vì tóm tắt mơ hồ.

Xử lý

Agent / skill thực thi

3 Lưu bằng CLI Dùng ak journal create với title, summary và stdin để không cần editor tương tác.
4 Validate khi cần Chạy ak journal validate <slug-or-filename-stem> cho entry cần kiểm tra.

Kiểm chứng

Gate, review, xác thực

5 Bỏ qua publish AgentWiki Báo “AgentWiki publish skipped” vì publish từ skill này đang deferred và file local vẫn là source of truth.
6 Duyệt lịch sử Dùng ak journal list, ak journal show <slug> hoặc trang Journals để xem entry hiện có.

Đóng

Báo cáo, bàn giao, artifact

7 Tôn trọng chính sách tự động Khi chạy tự động sau workflow khác, tôn trọng --skip-journal, config journal.auto và thứ tự ưu tiên: flag > project config > user config > default true.
8 Chỉ đăng social khi cấu hình đủ Với social post, resolve config, soạn body từng channel, dry-run post-social trước, rồi chỉ publish sau khi xem output dry-run.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:journal [topic or reflection]

Đối số

[topic or reflection] Bắt buộc

Chủ đề journal

Chủ đề phiên, reflection hoặc yêu cầu ghi lại bằng ngôn ngữ tự nhiên. Nêu lỗi cụ thể, path, outcome, quyết định và việc còn lại; Skill không có mode flag được công bố.

/ak:journal "Record today's session-cache repair: duplicate invalidation root cause, rejected timer workaround, affected API behavior, regression evidence, and follow-up monitoring."

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Reflection phiên làm việc Khuyến nghị

/ak:journal after fixing the OAuth callback race condition

Dùng khi:: Khi muốn có bản ghi công việc theo thời gian sau khi implement hoặc debug.
Kết quả:: Thu thập root cause, thay đổi chính, tác động, quyết định và bước tiếp theo; soạn entry Markdown cụ thể; lưu bằng ak journal create dưới plans/journals; báo AgentWiki publish skipped.

Đào lại failure

/ak:journal why the deployment rollback was necessary

Dùng khi:: Khi entry cần nhấn mạnh root cause trung thực, tác động và bài học từ failure.
Kết quả:: Có thể gọi subagent journal-writer khi mục tiêu là sự thẳng thắn cảm xúc, rồi vẫn ghi journal qua ak journal create và giữ nó làm lịch sử công việc local thay vì nguồn quyết định.

Entry theo ngày và project

/ak:journal record yesterday's API migration notes dated 2026-08-29 for project vividkit-web

Dùng khi:: Khi cần gắn file journal với một ngày cụ thể hoặc tên project trong registry AgentKit.
Kết quả:: Dùng input tuỳ chọn ak journal create --date và --project nhưng vẫn giữ workflow thu thập, soạn, validate khi cần và báo AgentWiki skipped.

Bài social đã cấu hình

/ak:journal turn today's release journal into configured social posts with image ./release-card.png

Dùng khi:: Khi đã cấu hình channel social cho journal và muốn copy theo từng channel sau khi journal local tồn tại.
Kết quả:: Tạo journal trước, resolve cấu hình .agentkit journal/config và writing style, soạn body theo từng channel, chạy post-social với --dry-run --json để kiểm tra, rồi chỉ publish sau khi output dry-run được chấp nhận.

Phạm vi xử lý

Reflection theo session
Bản ghi công việc theo thời gian
Lưu bằng journal CLI
Preference auto-journal
Dry-run publish social

Artifact tạo ra

Kết quả journal

Mẫu đường dẫn

Path file đã tạo, summary một dòng, trạng thái validate nếu chạy, AgentWiki publish skipped.

Journal giữ lịch sử công việc; không nên dùng nó như spec sản phẩm bền vững.