yfm — skill0
Применяй YFM
Используй YFM для любого markdown, который может просканировать агент, индекс или онтологический конвейер. Соблюдай уже используемый диалект, если он есть (Agent Skills, Obsidian, Jekyll, Hugo и т. д.) — дефолт x-cmd действует только когда никакого другого диалекта не задано.
Дефолт x-cmd: три поля
---
tags: [design, front-matter]
description: Одно предложение-резюме, по которому читатель решает, открывать ли этот файл.
memo:
2026-07-31T14:30:00+08:00: Убраны aliases; третье поле переименовано в memo.
---
# Заголовок
Body...
tags— список слагов верхнего уровня[a-z0-9-]. Потребитель: сборщик для онтологической индексации.description— строка верхнего уровня. Одно предложение. Это не полеdescription:из Agent Skills (оно требуется только в SKILL.md и регулируетсяskill0-writer).memo:— словарь верхнего уровня, журнал изменений файла. Ключи — метки времени ISO 8601 (YYYY-MM-DDTHH:mm:ss±HH:mm, локальное смещение автора); значения — краткие описания изменений. Сначала новые. Не указывай, если историю не стоит фиксировать.
Область применения
<project>/.x-cmd/story/— расширяется полемissue:— см. usecase/story.md.- Тела GitHub issue / PR — расширяются полями
repo:,number:— см. usecase/git-issue-pr-wiki-markdown-etc.md. - GitHub
README.md— только поля по умолчанию.
Модуль
Модуль yfm вспомогательный. Три команды:
x yfm ls [path]— перечислить блоки YFM; по умолчанию текущий каталогx yfm init [path]— записать блок с дефолтом x-cmd в каждый markdown-файл под путёмx yfm lint [path]— проверить, что каждый блок YFM — валидный YAML и соответствует заявленному диалекту
Чтение чужого front matter
Сборщик принимает много разных диалектов. Спецификацию, из которой взят дефолт, смотри на https://agentskills.io/specification. По диалектам:
- Agent Skills —
metadata:это string→string; верхний уровень закрыт - Obsidian —
tags/aliases/cssclassesзарезервированы - Jekyll — список или пробел-разделённый
- Hugo — возможен TOML; таксономия задаётся конфигом сайта