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.

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 sau khi sửa điều kiện đua callback OAuth

Dùng khi:: Khi muốn lưu bản ghi kỹ thuật ngắn sau khi implement hoặc debug.
Kết quả:: Ghi chuyện đã xảy ra, quyết định, bước tiếp, lưu dưới plans/journals và ghi AgentWiki publish skipped.

Đào lại failure

/ak:journal tại sao việc rollback triển khai là cần thiết

Dùng khi:: Khi entry cần giải thích root cause, ảnh hưởng và bài học cho session sau.
Kết quả:: Có thể gọi journal-writer để viết thẳng thắn hơn, nhưng vẫn lưu qua ak journal create.

Journal audit chiến dịch

/ak:journal ghi lại phiên kiểm toán chiến dịch này

Dùng khi:: Một session làm việc cần journal kỹ thuật có ngày, không phải slide status.
Kết quả:: Ghi journal có ngày với thay đổi, quyết định, path cụ thể và bước tiếp theo dưới plans/journals.

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.

Bản đồ thực thi

Prompt mẫu

Phạm vi xử lý

Artifact tạo ra

Tiếp theo