mda
一个面向AI Agent的Markdown超集规范与编译工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：mda。 它的用途是：一个面向AI Agent的Markdown超集规范与编译工具。 完整的 Skill 内容见：https://321skill.com/skills/mda/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我将这份 agent 技能描述编译成适配 Claude Code 和 Codex CLI 的文档。”，它会引导你使用 MDA 编译器处理你的 `.mda` 源文件，自动生成 `SKILL.md` 和 `AGENTS.md` 等目标文件，并确保内容完全一致。你也可以要求它验证已生成文档的签名，确认文件在传输过程中未被篡改。
介绍
MDA 旨在解决为不同 AI Agent 运行时（如 Claude Code、Codex CLI 等）编写和维护技能文档时的重复和碎片化问题。开发者过去需要为每个运行时平台编写格式略有差异的 Markdown 文件（如 SKILL.md、AGENTS.md），导致内容容易漂移不一致。
MDA 提供了一个统一的 Markdown 超集规范，开发者只需编写一份 .mda 源文件。通过其编译器，可以一键生成适配所有主流 Agent 运行时的、可直接使用的 Markdown 文件，确保多平台分发内容的一致性。
它非常适合为 AI 助手开发技能、工具或插件的开发者、技术文档工程师，以及需要跨多个 Agent 平台部署标准化指令的团队。
与同类工具或手动维护多份文件相比，MDA 的核心区别在于它提供了一个标准化的源格式和编译流程，不仅实现了“一次编写，多处运行”，还通过内容摘要和可选的签名机制，为生成的文档提供了防篡改验证能力，这在当前 Agent 生态中是一个独特的安全特性。
核心特点
提供“一次编写，多处编译”的确定性流程，从根本上杜绝多平台技能文档的内容漂移；通过内置的内容摘要和可选的 Sigstore 签名，为加载的文档提供端到端的完整性和来源验证，这是现有 Agent 技能格式普遍缺失的安全层。
注意事项
主要面向技术开发者和文档编写者，不适合不涉及为AI Agent创建技能或指令的普通用户。
常见问题
MDA 是用来做什么的？
用于编写一份源文件，然后编译生成适配 Claude、Codex 等多种 AI Agent 运行时的技能文档，避免维护多份不同格式文件的麻烦。
使用 MDA 需要编程知识吗？
需要基本的 Markdown 编写能力，并且了解如何通过命令行工具进行编译，适合开发者或技术文档作者。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mda/raw/index.md 读取 mda 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mda/raw/index.md（查看排版版本）