yfm — skill0
Áp dụng YFM
Hãy dùng YFM cho bất kỳ file markdown nào mà agent, chỉ mục, hay pipeline ontology có thể quét. Hãy theo dialect đang có sẵn nếu repo đã dùng dialect đó (Agent Skills, Obsidian, Jekyll, Hugo, v.v.) — mặc định của x-cmd chỉ áp dụng khi không có dialect nào khác chi phối.
Mặc định của x-cmd: ba trường
---
tags: [design, front-matter]
description: Một câu tóm tắt để người đọc quyết định có mở file này không.
memo:
2026-07-31T14:30:00+08:00: Bỏ aliases; đổi tên trường thứ ba thành memo.
---
# Tiêu đề
Nội dung...
tags— danh sách slug[a-z0-9-]ở cấp cao nhất. Bên tiêu thụ: bộ thu thập cho việc lập chỉ mục ontology.description— chuỗi ở cấp cao nhất. Một câu. Không phảidescription:của Agent Skills (đó là yêu cầu chỉ dành cho SKILL.md, doskill0-writerquản lý).memo:— map ở cấp cao nhất, là nhật ký sửa đổi của file. Khoá là dấu thời gian ISO 8601 (YYYY-MM-DDTHH:mm:ss±HH:mm, theo múi giờ địa phương của tác giả); giá trị là mô tả thay đổi ngắn. Mới nhất trước. Bỏ qua khi không có lịch sử nào đáng ghi.
Phạm vi áp dụng
<project>/.x-cmd/story/— mở rộng vớiissue:— xem usecase/story.md.- Nội dung issue / PR của GitHub — mở rộng với
repo:,number:— xem usecase/git-issue-pr-wiki-markdown-etc.md. README.mdcủa GitHub — chỉ các trường mặc định.
Module
Module yfm là công cụ phụ trợ. Ba lệnh:
x yfm ls [path]— liệt kê các khối YFM; mặc định là thư mục hiện tạix yfm init [path]— ghi một khối mặc định của x-cmd vào mỗi file markdown dưới pathx yfm lint [path]— kiểm tra rằng mỗi khối YFM là YAML hợp lệ và tuân theo dialect mà nó tuyên bố
Đọc front matter của dialect khác
Bộ thu thập tiêu thụ nhiều dialect khác nhau. Về đặc tả mà mặc định mượn, xem https://agentskills.io/specification. Theo từng dialect:
- Agent Skills —
metadata:là string→string; cấp cao nhất là đóng - Obsidian — dành riêng cho
tags/aliases/cssclasses - Jekyll — danh sách hoặc phân tách bằng dấu cách
- Hugo — có thể là TOML; taxonomy do site cấu hình