让 agent 帮你做出 PDF。

在 Claude Code 中安装

mkdir -p ~/.claude/skills/marsdawn
curl -fsSL https://marsdawn.southern-light.dev/cli/skill/SKILL.md -o ~/.claude/skills/marsdawn/SKILL.md

需要做出 PDF 时，Claude Code 会自动加载它，你也可以用 /marsdawn 自己运行。它只是一个简短的文件，安装前先读一遍。

其他 agent 也能用同一个文件。它是纯 Markdown，只有说明和命令，让你的 agent 读这个网址，或直接贴给它就好。这个文件是英文的。

它教什么

• 如果没有 marsdawn，就用 Homebrew 安装，再用 marsdawn --version 确认版本，而不是假设某个版本。
• 用 marsdawn export … --json 导出，并读懂结果：PDF 存到哪里、有几页，以及有没有 Mermaid 图表没画出来。
• 依退出代码分辨失败的原因：找不到文件、PDF 已经存在、导出失败、选项错误。
• 只有装了 MarsDawn app 才用 open，而且绝不用它来做 PDF。

它不会做的事

• 它不会自己取得运行任何东西的权限。你的 agent 在安装或运行 marsdawn 之前，仍然会先问你，就像运行其他命令一样。
• 它不会把你的文稿传到任何地方。marsdawn 在你的 Mac 上产生 PDF，除非你加上 --allow-remote-images，否则不会加载网络上的图片。

完整的规格，每个字段和每个代码，都在给 AI agent 的 marsdawn 参考里。