宝玉(@dotey)

我在做 baoyu-skills 时，做了一个尝试，就是用了一个 EXTEND.md 文件保存用户自定义设置，当时我想的是 Agent 读起来方便。 但是这导致一个问题，Markdown 不是严格的...

7.0内容质量
我在做 baoyu-skills 时，做了一个尝试，就是用了一个 EXTEND.md 文件保存用户自定义设置，当时我想的是 Agent 读起来方便。 但是这导致一个问题，Markdown 不是严格的...

TL;DR · AI 摘要

使用 Markdown 保存用户自定义设置存在解析困难和格式不一致问题，建议改用 JSON 或 YAML。

核心要点

  • Markdown 不是严格的结构化数据，程序解析困难。
  • JSON 或 YAML 更适合保存 Skill 的扩展配置。
  • LLM 可以读取 Markdown，但代码处理时存在一致性问题。

结构提纲

按章节快速跳转。

  1. §EXTEND.md 文件的使用

    使用 EXTEND.md 文件保存用户自定义设置，方便 Agent 读取。

  2. ·Markdown 的问题

    Markdown 不是严格的结构化数据，导致程序解析困难和格式不一致。

  3. ›改进建议

    建议使用 JSON 或 YAML 文件格式作为 Skill 的扩展配置。

思维导图

用一张图看清主题之间的关系。

查看大纲文本（无障碍 / 无 JS 友好）
  • Markdown 与配置管理
    • EXTEND.md 的使用
      • Agent 读取方便
    • Markdown 的问题
      • 非结构化数据
      • 解析困难
      • 格式不一致
    • 改进建议
      • 使用 JSON 或 YAML

金句 / Highlights

值得收藏与分享的关键句。

  • Markdown 不是严格的结构化数据，LLM 自己读取没问题，但是程序解析很困难。

    — 文章正文

    ⬇︎ 下载 PNG𝕏 分享到 X
  • 如果让我再设计的话，我会更倾向于用 json 或者 yaml 文件格式作为 Skill 的扩展配置。

    — 文章正文

    ⬇︎ 下载 PNG𝕏 分享到 X
  • 小小的 markdown 文件，却可以改变 Coding Agent 的世界状态。

    — 马东锡 NLP 的评论

    ⬇︎ 下载 PNG𝕏 分享到 X
#Markdown#JSON#YAML#配置管理
打开原文

宝玉 on X: "我在做 baoyu-skills 时，做了一个尝试，就是用了一个 EXTEND.md 文件保存用户自定义设置，当时我想的是 Agent 读起来方便。 但是这导致一个问题，Markdown 不是严格的结构化数据，LLM 自己读取没问题，但是程序解析很困难，另外格式很难严格保持一致性。 如果让我再设计的话，我会更倾向于用 json" / X

宝玉

@dotey

我在做 baoyu-skills 时，做了一个尝试，就是用了一个 EXTEND.md 文件保存用户自定义设置，当时我想的是 Agent 读起来方便。 但是这导致一个问题，Markdown 不是严格的结构化数据，LLM 自己读取没问题，但是程序解析很困难，另外格式很难严格保持一致性。 如果让我再设计的话，我会更倾向于用 json 或者 yaml 文件格式作为 Skill 的扩展配置，这样既可以让 LLM 方便读取，也可以用代码解析和保存。

马东锡 NLP

@dongxi_nlp

2h

Article

Markdown Is A Context Interface

Harness 系列文章之 5，小小的 markdown 文件，却可以改变 Coding Agent 的世界状态。 .md file works when the harness knows what kind of context it is. 现代 coding agent 里，一个很有意思的现象是：普通...

12:20 AM · Jun 15, 2026

4.2K

Views

7

2

1

17

6

16

Read 7 replies