Lối tắt dễ mắc
Tôi biết sẵn cấu trúc docs.
Cách làm đúng
Phải tìm hợp đồng của dự án trước; có thể không hề có cây docs chung.
Ctrl K
Tóm tắt nhanh / Lệnh
Bộ Marketing
/ak:docs
Tạo và audit tài liệu dự án
Tạo, cập nhật, tóm tắt và kiểm tra đúng lớp tài liệu dự án đang dùng, bao gồm cả ngữ cảnh agent ở gốc repo.
01
Chốt mục tiêu
02
Định tuyến lệnh
03
Nạp quy tắc
04
Tìm nguồn thẩm quyền
Nguyên tắc 01
Mã sở hữu phần làm gì và làm thế nào; tài liệu sở hữu lý do và vị trí cần tìm.
Nguyên tắc 02
Bộ tài liệu nhỏ nhưng dùng được tốt hơn văn bản rộng và trùng lặp.
Nguyên tắc 03
CLAUDE.md hoặc AGENTS.md ở gốc là bộ nhớ quy trình, không phải sổ tay dự án chung.
Nguyên tắc 04
Bằng chứng hiện tại quan trọng hơn tài liệu cũ và tên file được đoán trước.
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.
01
Khởi động
Đầu vào, phạm vi, route
- 1 Chốt mục tiêu Xác định người đọc, kết quả cần đạt, nguồn bằng chứng, phần bền vững so với phần tạm thời, và tiêu chí hoàn tất.
- 2 Định tuyến lệnh Đọc init, update, summarize, agent-context, agents, llms; nếu không rõ thì hỏi người dùng thay vì tự chọn init.
02
Xử lý
Agent / skill thực thi
- 3 Nạp quy tắc Nạp workflow tham chiếu tương ứng cùng quy tắc viết tài liệu hoặc quy tắc ngữ cảnh agent trước khi soạn.
- 4 Tìm nguồn thẩm quyền Đọc lần lượt hướng dẫn repo, README, điều hướng docs, tài liệu hiện có, mã, test, script và bằng chứng đang chạy.
03
Kiểm chứng
Gate, review, xác thực
- 5 Chọn nơi sở hữu Chỉ cập nhật tài liệu có hợp đồng hoặc bằng chứng đổi; liên kết đến nơi sở hữu thực thi thay vì chép lại dữ kiện.
- 6 Viết gọn Giữ tài liệu như lớp điều hướng, lý do, ràng buộc, quyết định, thuật ngữ và các phương án đã loại.
04
Đóng
Báo cáo, bàn giao, artifact
- 7 Kiểm chứng tuyên bố Đối chiếu mọi đường dẫn, lệnh, khóa cấu hình và mô tả hành vi với bằng chứng hiện tại.
- 8 Báo phạm vi Tách phần thẩm quyền bền vững khỏi ghi chú nghiên cứu hoặc kiểm tra, rồi báo phần đã đổi mà không dán nội dung dư thừa.
Đừng bỏ qua bước bắt buộc
Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.
Lối tắt dễ mắc
Nên chép hành vi này vào tài liệu.
Cách làm đúng
Ưu tiên liên kết đến script, manifest, mã nguồn hoặc artifact đang sở hữu hành vi đó.
Lối tắt dễ mắc
Ghi chú lịch sử có thể nằm trong tài liệu thẩm quyền.
Cách làm đúng
Bằng chứng tạm thời, audit, kế hoạch và ghi chú phát hành phải nằm ngoài tuyến thẩm quyền bền vững.
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ế.
Khởi tạo tài liệu Khuyến nghị
/ak:docs init- Dùng khi:
- Repo cần tuyến tài liệu tối thiểu theo đúng dự án.
- Kết quả:
- Nạp workflow init và chỉ lập phần tài liệu thật sự cần.
Cập nhật tài liệu đổi
/ak:docs update- Dùng khi:
- Mã, script hoặc hợp đồng dự án đã đổi nên tài liệu có thể lỗi thời.
- Kết quả:
- Đối chiếu và sửa các tài liệu bị ảnh hưởng theo bằng chứng hiện tại.
Kiểm tra ngữ cảnh agent
/ak:docsagent-context--audit
- Dùng khi:
- CLAUDE.md hoặc AGENTS.md ở gốc cần rà soát phần giữ, bỏ hoặc sửa.
- Kết quả:
- Áp dụng quy tắc agent-context và xác nhận từng quyết định thay đổi.
Xin cố vấn cho ngữ cảnh agent
/ak:docsagent-context--advice
- Dùng khi:
- Thay đổi ngữ cảnh gốc cần kongming góp ý trước khi đề xuất ghi.
- Kết quả:
- Nhận review cố vấn cho đề xuất agent-context và vẫn chỉ ghi sau xác nhận.
Rút luật từ lỗi lặp lại
/ak:docsagents 30d--source
- Dùng khi:
- Lịch sử git, CI và dấu hiệu trong mã gần đây cần được chuyển thành luật NÊN hoặc KHÔNG NÊN đã xác nhận.
- Kết quả:
- Xếp hạng tín hiệu lặp lại, kèm review kongming mặc định, và chỉ đưa luật có chứng cứ vào ngữ cảnh agent ở gốc.
Chạy thử rút luật
/ak:docsagents 30d--dry-run
- Dùng khi:
- Cần xếp hạng tín hiệu lặp lại mà không tạo đề xuất cố vấn hoặc ghi file.
- Kết quả:
- Dừng sau bước xếp hạng tín hiệu, không đề xuất luật, không gọi cố vấn và không ghi file.
Phạm vi xử lý
- Khởi tạo tài liệu
- Cập nhật dựa trên bằng chứng
- File ngữ cảnh agent
- Rút luật từ lịch sử và CI
- Tạo llms.txt