# baoyu-skills 反思：EXTEND.md 应改用 JSON/YAML

- 来源：宝玉 (@dotey)
- 发布时间：2026-06-15 08:20
- AIHOT 分数：72
- AIHOT 链接：https://aihot.virxact.com/items/cmqehbmoo027wslunbe4bn9lu
- 原文链接：https://x.com/dotey/status/2066314944950268139

## AI 摘要

宝玉在开发 baoyu-skills 时，采用 EXTEND.md 文件保存用户自定义设置，初衷是方便 Agent 读取。但实践发现，Markdown 非严格结构化数据，虽能被 LLM 理解，却难以被程序解析，且格式难以保持一致性。他认为更合理的方案是采用 JSON 或 YAML 作为 Skill 扩展配置，既能被 LLM 方便读取，也便于代码解析与持久化。

## 正文

我在做 baoyu-skills 时，做了一个尝试，就是用了一个 EXTEND.md 文件保存用户自定义设置，当时我想的是 Agent 读起来方便。

但是这导致一个问题，Markdown 不是严格的结构化数据，LLM 自己读取没问题，但是程序解析很困难，另外格式很难严格保持一致性。

如果让我再设计的话，我会更倾向于用 json 或者 yaml 文件格式作为 Skill 的扩展配置，这样既可以让 LLM 方便读取，也可以用代码解析和保存。

### 引用推文

> 马东锡 NLP：http://x.com/i/article/2066281164134825984