MDA — Compile One Doc into SKILL/AGENTS/CLAUDE

Main

• 把 .mda 作为单一事实来源，再编译出多种 runtime 可直接加载的文档，避免手动维护多份内容。

• 用 mda validate + 目标 schema 做 CI 门禁，保证发布的 SKILL/AGENTS/CLAUDE 结构始终正确。

• 当需要 agent 文档供应链的可验证性时，用 --integrity 生成摘要，并用 mda integrity verify 做校验。

Source-backed notes

• README 将 .mda 定义为 Markdown 超集，可编译输出 SKILL.md、AGENTS.md、MCP-SERVER.md 与 CLAUDE.md。
• CLI 手册说明 npm 包名为 @markdown-ai/cli，全局安装后的命令为 mda。
• CLI 手册给出最小闭环：mda init → mda validate → mda compile --integrity → mda integrity verify。

FAQ

• CLI 安装后是什么命令？：CLI 手册说明 @markdown-ai/cli 只提供一个命令：mda。
• 能不安装直接用吗？：可以。CLI 手册提供 npx @markdown-ai/cli --help 的免安装用法。
• CI 里应该验证什么？：先校验 .mda 源文件与输出目标文件，再用 mda integrity verify 做完整性校验。