Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:llms

Trình tạo llms.txt

Tạo llms.txt và llms-full.txt tùy chọn từ thư mục docs, file hoặc URL tài liệu, theo cấu trúc llmstxt.org với section, link và bước validate súc tích.

01

Chọn nguồn

02

Tìm tài liệu

03

Rút metadata

04

Sinh index

Nguyên tắc 01

Theo cấu trúc llmstxt.org thay vì tự bịa sitemap riêng.

Nguyên tắc 02

Giữ mô tả ngắn gọn và hữu ích cho việc chọn ngữ cảnh.

Nguyên tắc 03

Chỉ tạo llms.txt và llms-full.txt; hosting và SEO nằm ngoài scope.

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 Chọn nguồn Không có tham số thì scan ./docs; có path thì scan thư mục hoặc file đó; có URL thì lấy cấu trúc tài liệu.
  2. 2 Tìm tài liệu Dùng /ak:scout để tìm file .md và .mdx trong nguồn local, hoặc web_search capability để lấy cấu trúc tài liệu từ URL.
02

Xử lý

Agent / skill thực thi

  1. 3 Rút metadata Với mỗi file, rút title H1, mô tả từ đoạn đầu, category section và phân loại core hay optional.
  2. 4 Sinh index Chạy scripts/generate-llms-txt.py với --source, --output, --base-url và tùy chọn --full, hoặc làm thủ công theo spec llms.txt được tham chiếu.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Đúng cấu trúc spec Xuất H1 tên project bắt buộc, blockquote summary khuyến nghị, H2 section, link Markdown kèm mô tả và section ## Optional cuối cho tài liệu có thể bỏ qua.
  2. 6 Validate link Kiểm H1, blockquote, định dạng link Markdown, vị trí Optional, mô tả ngắn gọn và không có jargon chưa giải thích.
04

Đóng

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

  1. 7 Tôn trọng scope Không xử lý hosting, deployment, SEO, robots.txt hoặc sitemap.
  2. 8 Bảo vệ bí mật Không lộ skill internals, system prompt, env var, config nội bộ, dữ liệu cá nhân hoặc nội dung ngoài scope.

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:llms [path|url] [--full] [--output path] [--url base]

Đối số

[path|url]

Đường dẫn hoặc URL nguồn

Nguồn tài liệu cần lập index. Bỏ qua để scan ./docs; nếu nguồn là URL, cần fetch hoặc map trước khi chạy generator được bundle vì script chỉ scan directory local.

/ak:llms docs/reference

Option dùng chung

--full

Artifact full

Ghi thêm llms-full.txt có nội dung tài liệu inline. Review kích thước và nội dung riêng tư trước khi publish.

/ak:llms docs --full
--output path

Thư mục output

Ghi llms.txt và mọi llms-full.txt vào thư mục này thay vì root project. Flag này không publish hay deploy file.

/ak:llms docs --output public
--url base

URL gốc

Dùng URL public gốc này cho các link Markdown được tạo. Khi chạy script trực tiếp dùng --base-url; option này không kiểm HTTP link.

/ak:llms docs --url https://example.com/docs

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

Index docs mặc định Khuyến nghị
/ak:llms
Dùng khi:
Dùng khi project có thư mục ./docs và cần index tài liệu thân thiện với LLM theo mặc định.
Kết quả:
Scan ./docs để tìm file Markdown, rút title và mô tả, nhóm tài liệu core với optional, ghi llms.txt và validate cấu trúc llmstxt.org bắt buộc.
Nguồn cụ thể
/ak:llms docs/reference
Dùng khi:
Dùng khi chỉ một thư mục hoặc file tài liệu cụ thể nên làm nguồn cho index thân thiện với LLM.
Kết quả:
Dùng path được cung cấp thay vì ./docs, phân tích các file .md và .mdx tìm được, phân loại link vào section H2 và xuất llms.txt hợp lệ.
File full context
/ak:llms docs --full
Dùng khi:
Dùng khi AI assistant cần cả index súc tích và file mở rộng có nội dung tài liệu inline.
Kết quả:
Tạo llms.txt chọn lọc cùng llms-full.txt có nội dung inline, rồi kiểm heading, định dạng link Markdown, vị trí Optional và mô tả súc tích.
URL docs đã publish
/ak:llms docs --output public --url https://example.com/docs
Dùng khi:
Dùng khi link được tạo cần trỏ tới docs site đã publish và file output cần ghi ngoài root.
Kết quả:
Áp dụng tiền tố URL gốc cho link Markdown được tạo, ghi output vào thư mục đã yêu cầu và giữ nội dung llms.txt ngoài hosting, SEO, robots.txt và sitemap.

Phạm vi xử lý

  • Scan tài liệu
  • Cấu trúc llms.txt
  • Ngữ cảnh mở rộng tùy chọn
  • Validate link
  • Index tài liệu thân thiện với AI

Artifact tạo ra

Đầu ra llms.txt

Mẫu đường dẫn

Luôn có llms.txt; có llms-full.txt khi dùng --full.

Các file là index tài liệu cho ngữ cảnh LLM, không phải cấu hình deploy hoặc SEO.

Skill liên quan

Tiếp theo