SKILL.make: Định dạng tệp Skill theo phong cách Makefile cho AI Agents

SKILL.make là một đặc tả mới mang mô hình khai báo và dựa trên sự phụ thuộc của Makefile vào định dạng Agent Skills. Nó thay thế văn bản xuôi mơ hồ bằng logic có cấu trúc, biến tệp SKILL.md thông thường thành một đồ thị thực thi có thể tái tạo.

Tại sao lại sử dụng tệp SKILL theo phong cách Makefile?

Mô hình này mang lại nhiều lợi ích thiết thực cho việc phát triển và vận hành các tác nhân AI (Agents):

• Tối ưu hóa Token: Cú pháp được tối ưu hóa giúp giảm kích thước tệp SKILL khoảng 15%, từ đó tiết kiệm chi phí và không gian ngữ cảnh (context window). Với việc tối ưu hóa thủ công, kích thước ngữ cảnh có thể giảm hơn 30%.
• Giải quyết sự phụ thuộc: Hệ thống (harness) sẽ tự động phân giải DAG (Đồ thị có hướng không chu trình). Điều này giúp loại bỏ việc phụ thuộc vào Mô hình ngôn ngữ lớn (LLM) để "đoán" bước tiếp theo. Nó sử dụng mô hình Mục tiêu: Phụ thuộc + Công thức (Recipe) để đảm bảo các Agent tuân theo thứ tự thực thi nghiêm ngặt mà không bỏ qua bước nào.
• Khả năng kết hợp cao: Cho phép mô-đun hóa các kỹ năng bằng cách gọi các mục tiêu (targets) trên các tệp khác nhau, giống như một hệ thống xây dựng (build system) chuyên nghiệp.
• Khả năng kiểm toán và phát triển: Đặt nền móng cho các triển khai SKILL có thể kiểm toán và tiến hóa theo thời gian.

Định nghĩa quy tắc

Định dạng SKILL.make sử dụng các tiền tố để xác định loại lệnh:

• VAR = val (Biến): Định nghĩa các hằng số để giảm sự lặp lại.
• @ cmd (Shell): Các hướng dẫn dòng lệnh trực tiếp để thực thi.
• $ tool (Invocable): Các lệnh gọi rõ ràng tới các công cụ/hàm do Agent định nghĩa.
• ? prompt (Reasoning): Các lời nhắc (prompt) tự do nơi Agent quyết định hành động.
• ifeq (Logic): Phân nhánh có điều kiện dựa trên trạng thái hoặc biến môi trường.
• multi-line string (Code snippet): Định nghĩa các đoạn mã bằng cách sử dụng chuỗi nhiều dòng trong cú pháp Makefile.

Ví dụ đơn giản

Dưới đây là một kỹ năng review mã (code-review) điển hình được viết theo định dạng SKILL.make:

# Variables
CODE_DIR = src/

# Target: review — run a full code review
review: lint test summary

lint:
	@ cd $(CODE_DIR) && eslint . --format json

test:
	@ cd $(CODE_DIR) && npm test

summary: lint test
	? Based on lint errors and test failures, write a review summary.

So sánh định dạng

Nhóm phát triển đã thử nghiệm một bộ sưu tập SKILL hoàn chỉnh (từ dự án "Skills for Real Engineers" nổi tiếng) bằng cách chuyển đổi sang định dạng Makefile. Kết quả cho thấy không chỉ cải thiện cấu trúc logic và khả năng đọc, mà các tệp SKILL.make này còn rất phù hợp để kiểm toán (theo dõi git, thống kê lời gọi) và đặt nền tảng vững chắc cho Kỹ thuật Tiến hóa (Evolution Engineering).

Bạn có thể sử dụng convert.sh để tái tạo quá trình chuyển đổi này. Thống kê so sánh như sau:

Tệp	SKILL.md	SKILL.make	Thay đổi
caveman	1916	1714	-10%
design-an-interface	3366	2789	-17%
domain-model	3512	3376	-3%
edit-article	721	692	-4%
git-guardrails-claude-code	2312	1861	-19%
github-triage	10089	8697	-13%
improve-codebase-architecture	5509	4913	-10%
migrate-to-shoehorn	2795	1328	-52%
obsidian-vault	1511	1233	-18%
qa	4965	4781	-3%
request-refactor-plan	2711	2626	-3%
scaffold-exercises	3589	2744	-23%
setup-pre-commit	2261	1703	-24%
tdd	4211	3212	-23%
to-issues	2737	2027	-25%
to-prd	2460	2092	-14%
triage-issue	3783	3160	-16%
ubiquitous-language	4890	4560	-6%
write-a-skill	3056	2879	-5%
TỔNG CỘNG	66394	56387	-15%

Hiện tại, đây là một đặc tả khái niệm (proof-of-concept) được thiết kế để tương thích với hầu hết các triển khai Agent Harness. Dự án được cấp phép theo MIT.