x-cmd yfm — skill0
采用 YFM
任何可能被 agent、索引或本体 pipeline 扫描的 markdown，都用 YFM。若已有方言在用，跟着它走（Agent Skills、Obsidian、Jekyll、Hugo 等）—— x-cmd 默认仅在没有其他方言管辖时生效。
x-cmd 默认：三个字段
---
tags: [design, front-matter]
description: 一句话摘要，读者用它决定是否打开本文件。
memo:
2026-07-31T14:30:00+08:00: 砍掉 aliases；第三个字段重命名为 memo。
---
# 标题
正文...
tags— 顶层 slug 列表[a-z0-9-]。消费者：本体索引的 collector。description— 顶层字符串。一句话。不是 Agent Skills 的description:（那是 SKILL.md 专属要求，由skill0-writer管辖）。memo:— 顶层 map，文件的修订日志。键为 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 模块是个 helper。三个命令：
x yfm ls [path]— 列出 YFM block；默认当前目录x yfm init [path]— 在 path 下每个 markdown 文件中写入 x-cmd 默认 blockx yfm lint [path]— 检查每个 YFM block 是合法 YAML 并遵循其声明的方言
读取外部 front matter
collector 摄取多种方言。默认借鉴的规范见 https://agentskills.io/specification。各方言：
- Agent Skills —
metadata:为 string→string；顶层闭合 - Obsidian —
tags/aliases/cssclasses已保留 - Jekyll — 列表或 空格 分隔
- Hugo — 可用 TOML；taxonomy 由站点配置