close

AI

为了帮助 AI 更全面地了解 Rspack 的功能、配置与最佳实践,从而在日常开发和问题排查过程中提供更准确的帮助,Rspack 提供了以下能力:

Agent Skills

Agent Skills 是可安装到 Agent 中的领域知识包,能够让 Agent 在特定场景下更准确、更专业地给出建议或执行操作。

我们在 rstackjs/agent-skills 仓库中为 Rstack 生态提供了许多 Skills,其中关于 Rspack 的 Skills 包括:

在支持 Skills 的 Coding Agent 中,可以通过以下命令使用 skills 包安装指定的 Skill:

npm
yarn
pnpm
bun
deno
npx skills add rstackjs/agent-skills --skill rspack-best-practices

安装完成后,用自然语言输入相关提示词即可触发对应 Skill,例如:

帮我把这个 Rspack 1.x 项目迁移到 v2

llms.txt

llms.txt 是一种帮助 LLM 发现和使用项目文档的标准规范。Rspack 遵循该规范,发布了以下两个文件:

  • llms.txt:结构化索引文件,包含所有文档页面的标题、链接与简要描述。
https://rspack.rs/llms.txt
  • llms-full.txt:完整内容文件,将所有文档页面的内容合并为单个文件。
https://rspack.rs/llms-full.txt

你可以根据使用场景选择合适的文件:

  • llms.txt 体积较小、消耗 token 少,适合让 AI 按需获取具体页面。
  • llms-full.txt 包含全量文档内容,无需 AI 逐一跟随链接,适合需要 AI 全面了解 Rspack 的场景,但会消耗更多 token,建议在支持大上下文窗口的 AI 工具中使用。

Markdown 文档

Rspack 文档的每个页面都提供对应的 .md 纯文本版本,可直接作为上下文提供给 AI。你可以在文档任意页面的标题下方点击「复制 Markdown」或 「复制 Markdown 链接」按钮,获取该页面对应的 Markdown 文件内容或链接。

https://rspack.rs/guide/start/introduction.md

将 Markdown 链接或内容提供给 AI,即可让其精确了解某一具体章节的内容,适合在针对性问题排查或查阅特定内容时使用。

AGENTS.md

使用 create-rspack 创建新项目时,生成的项目中会包含一个 AGENTS.md 文件。该文件遵循 AGENTS.md 规范,向 Agents 提供项目的关键信息。

生成的 AGENTS.md 示例内容如下:

# AGENTS.md

You are an expert in JavaScript, Rspack, and web application development. You write maintainable, performant, and accessible code.

## Commands

- `npm run dev` - Start the dev server
- `npm run build` - Build the app for production
- `npm run preview` - Preview the production build locally

## Docs

- Rspack: <https://rspack.rs/llms.txt>

你也可以根据项目的实际情况进行修改,添加更多关于项目结构、整体架构等多方面的信息,以便 Agents 更好地理解你的项目。

Tip

如果你使用的是 Claude Code,可以创建一个 CLAUDE.md 文件,并在其中引用 AGENTS.md 文件。

CLAUDE.md
@AGENTS.md