Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:folder-context

CLAUDE.md trong subfolder

Tạo CLAUDE.md gọn trong subfolder và AGENTS.md liên kết cho convention cục bộ bền vững mà root docs không nên gánh.

01

Xác nhận thư mục

02

Kiểm tra bằng chứng cục bộ

03

Chạy sanity gate

04

Đề xuất outline

Nguyên tắc 01

Context subfolder dành cho convention cục bộ mà agent sau này khó tự suy ra.

Nguyên tắc 02

Chỉ dẫn agent ở root thuộc /ak:docs agent-context, không thuộc skill này.

Nguyên tắc 03

Bullet gọn tốt hơn cây file và tài liệu dự án chung chung.

Nguyên tắc 04

Mọi chỉ dẫn cục bộ phải dựa trên bằng chứng hoặc quyết định rõ của user.

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. 1 Xác nhận thư mục Đảm bảo argument là subfolder, không phải root dự án hoặc yêu cầu docs chung.
  2. 2 Kiểm tra bằng chứng cục bộ Đọc source chính, cấu hình, Markdown và context file cục bộ đã có trong thư mục đó.
02

Xử lý

Agent / skill thực thi

  1. 3 Chạy sanity gate Bỏ qua thư mục chỉ là tài liệu tham chiếu tĩnh hoặc có thể khám phá theo yêu cầu mà không cần convention bền vững.
  2. 4 Đề xuất outline Nhóm context tương lai theo mục đích, file quan trọng, ràng buộc, convention, quyết định đã khóa và context xuyên session.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Chờ xác nhận Lấy xác nhận của user trước khi ghi chỉ dẫn agent cục bộ vào thư mục đích.
  2. 6 Ghi CLAUDE.md Tạo bullet ngắn gọn, cụ thể, cục bộ, chỉ dựa trên bằng chứng trong folder hoặc quyết định rõ từ user; bỏ section rỗng.
04

Đóng

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

  1. 7 Liên kết AGENTS.md Tạo AGENTS.md làm symlink tới CLAUDE.md, hoặc file một dòng trỏ tới CLAUDE.md nếu không dùng được symlink.
  2. 8 Tôn trọng sửa đổi Nếu user sửa file, đọc lại, nêu mâu thuẫn và không tự revert khi chưa được yêu cầu.

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:folder-context <target-folder>

Đối số

<target-folder> Bắt buộc

Subfolder đích

Subfolder hiện có cần nhận context agent cục bộ. Không được là root dự án hoặc yêu cầu docs chung; bằng chứng bổ sung có thể định hướng outline đề xuất nhưng không đổi target folder dạng positional.

/ak:folder-context packages/payments

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ế.

Tạo context cục bộ Khuyến nghị
/ak:folder-context packages/payments
Dùng khi:
Một subfolder có quy tắc đặt tên, kiến trúc, workflow hoặc an toàn bền vững khác với root dự án.
Kết quả:
Xác minh target là subfolder, kiểm tra source, cấu hình, Markdown và chỉ dẫn cục bộ hiện có, đề xuất outline, chờ phê duyệt, rồi ghi CLAUDE.md gọn và AGENTS.md liên kết.
Giữ quyết định rõ ràng
/ak:folder-context src/payments "ghi lại các quy tắc đặt tên provider và quyết định lưu currency dưới dạng integer minor units"
Dùng khi:
Bạn có thể nêu quyết định cục bộ bền vững mà agent sau này cần giữ qua nhiều session.
Kết quả:
Dùng bằng chứng trong folder cùng quyết định đã cung cấp, bỏ section rỗng hoặc chung chung, và giữ bullet chỉ cụ thể cho target folder thay vì lặp lại hướng dẫn root.
Áp dụng sanity gate
/ak:folder-context reference/archive
Dùng khi:
Một folder có thể chỉ chứa tài liệu tham chiếu tĩnh hoặc context dễ đọc lại khi cần.
Kết quả:
Kiểm tra liệu chỉ dẫn cục bộ bền vững có chính đáng không và bỏ tạo CLAUDE.md hoặc AGENTS.md khi folder chỉ tĩnh hoặc có thể khám phá lại khi cần.
Tôn trọng context hiện có
/ak:folder-context apps/admin
Dùng khi:
Target đã có chỉ dẫn cục bộ hoặc chỉnh sửa của user cần tiếp tục là nguồn thẩm quyền.
Kết quả:
Đọc context cục bộ hiện tại trước khi đề xuất thay đổi, giữ chỉnh sửa không liên quan của user, nêu mâu thuẫn và không revert chỉ dẫn hiện có khi chưa được phép.

Phạm vi xử lý

  • Tạo CLAUDE.md theo phạm vi subfolder
  • Symlink AGENTS.md hoặc fallback bằng file trỏ tới CLAUDE.md
  • Khám phá và cắt gọn convention cục bộ
  • Ghi quyết định đã khóa và context xuyên session
  • Phát hiện mâu thuẫn sau khi user sửa

Tiếp theo