MDA 跨平台技能编译与完整性校验
把一份技能源文件编译成多种 Agent 格式，并提供校验、完整性和签名发布流程。
技能说明
MDA 将一份 .mda 源文件编译为 SKILL.md、AGENTS.md 等目标文件，帮助团队统一维护 Agent 技能并在发布前做格式和完整性检查。
关于此技能
Markdown for Agent 的跨运行环境技能工程工具，把一份 .mda 源文件编译为 SKILL.md、AGENTS.md、MCP-SERVER.md 和 CLAUDE.md，并提供校验、完整性和签名流程。
核心能力
一次编写多端输出
从一个 .mda 源文件生成不同 Agent 运行环境可加载的文档格式，减少多份说明漂移。
标准与兼容校验
用 JSON Schema 和兼容性检查确认 frontmatter、目标格式和 agentskills.io v1 字段。
完整性保护
为源文件和编译产物生成可复现的 SHA-256 摘要，发现内容被修改。
签名与发布门禁
支持 GitHub Actions Sigstore 或 did:web 的签名、验证、发布准备和只读检查。
适用场景
维护跨平台技能库
让同一份技能同时输出给 Codex、Claude Code、OpenCode 和其他支持 Markdown 技能的 Agent。
发布前质量检查
在提交或发布前验证格式、依赖、目标兼容性和编译产物是否一致。
高风险技能分发
为团队技能增加摘要校验、签名证据和可信发布流程，降低被悄悄替换的风险。
使用步骤
- 01
安装命令行工具
运行 npx @markdown-ai/cli --help，或 npm install -g @markdown-ai/cli 安装 mda 命令。
- 02
创建源文件
用 mda init 创建 .mda 文件，填写名称、描述、版本、依赖和技能正文。
- 03
编译并校验
用 mda validate 和 mda compile --integrity 生成目标文件，再用 integrity verify 检查摘要。
- 04
签名后发布
需要可信发布时配置明确的 Sigstore 或 did:web 证据，完成 verify 和 release doctor 检查后再分发。
常见问题
它是 Agent 运行时吗？+
不是。MDA CLI 是技能编写、编译、校验和发布门禁工具，运行时仍由 Codex、Claude Code 等 Agent 负责加载。
Codex 能用吗？+
仓库提供 Codex CLI 兼容性目录，并明确验证了 agentskills.io v1 字段的编译和发现；扩展字段不保证被 Codex 读取。
签名会自动被 Agent 验证吗？+
不会。README 明确说明当前运行时通常不会自动验证完整性摘要或签名，发布方仍需在加载前自行设置验证门禁。
许可证怎么判断？+
工具和参考实现使用 Apache-2.0，Open Spec 内容使用 CC-BY-4.0；二次分发时要按对应目录和内容遵守许可。
当前有哪些限制？+
依赖解析器、中央注册表和完整的运行时签名验证仍在建设中；Cursor MDC 等非目标格式不在 v1.0 兼容范围。
npx @markdown-ai/cli --help