Prompts for Vibecoders¶

如果你用 Cursor、Claude Code、Codex 或其它 AI 编码助手开发，MinT 在固定 URL 暴露了一份 LLM 可读的整站文档摘要 —— 一次请求就能拿到全部上下文。

概念¶

llms.txt 是社区约定的格式，用于在文档站固定路径上提供 LLM 友好的内容摘要。MinT 直接从你读的同一份 MDX 自动生成这份文件，所以助手看到的内容和你完全一致 —— 不靠抓取，不会过期。

本站提供 3 个 URL：

URL	内容
`/zh/llms.txt`	全部中文页的索引，每页一行简介
`/zh/llms-full.txt`	全部中文页的完整 markdown 拼接
`/zh/llms.mdx`	内容同 `llms-full.txt`，但以 MDX 形式提供（有的助手更喜欢 MDX 风格的 include）

（英文版在 /en/llms.txt 等。）

模式¶

Cursor¶

在 Cursor 里把 URL 加到项目的 docs 上下文：

@docs https://mint-doc.macaron.im/zh/llms-full.txt

Cursor 会拉取文件并建索引，作为项目内每次提示的语义基础。MinT 发布更新后，重新拉一次即可同步。

Claude Code¶

在 Claude Code 会话开头让它拉一次：

读 https://mint-doc.macaron.im/zh/llms-full.txt 获取 MinT 完整文档，然后帮我在 Qwen3-30B 上写一个带自定义 reward 的 GRPO 训练循环。

整个会话只需要拉一次；Claude Code 会把内容留在上下文里。

curl（冒烟测试）¶

在终端验证路由通：

curl -sL https://mint-doc.macaron.im/zh/llms.txt | head -40

应该看到一串带文档 URL 的页标题列表。

API 接口¶

路由处理器在仓库的 app/[lang]/llms.txt/route.js。它走的是和侧边栏一样的 fumadocs page tree，剥掉只在 MDX 里有意义的组件（<Callout>、<WxImage>），输出纯 markdown。没有 query 参数；每次请求都从最新构建产物再生成。

注意事项¶

Token 预算。 整站的 llms-full.txt 有几千 token。绝大多数编码助手都装得下；如果只想喂某一页，把页面 URL 后面接上 /content.md（例如 /zh/llms.mdx/sdk/sft/content.md）—— fumadocs 会在这个路径下提供该页的 markdown 版本。
生效时间窗口。 路由读的是 build 产物，所以更新在站点重新部署时才落地（通常是公共 mint-doc 仓库 main 分支合并后几分钟内）。如果你昨天写的页面还没出现，构建还在传播中。
路线图页面也会原样输出。 少数页面描述还在落地的能力（例如 VLM）。这些页面用清楚的语言说明状态；助手原样看到这些文本，不会凭空臆测一个已上线的功能。
不要把 MINT_API_KEY 粘进 prompt。 文档里本来就没有真 key；但如果你从自己机器里复制脚本到 LLM prompt，先把 sk-* token 擦掉再贴。

Note

后续规划。 我们正在准备一个面向 Cursor / Claude Code 的 skill 包，封装 MinT 专用模式（RL 循环、自定义 reward、sampling）。进度跟踪在 mint-quickstart-alpha/mint-skill/SKILL.md。