#Modern.js For AI

Modern.js 为 AI Agent 提供了一套工具套件，帮助开发者利用 AI 高效完成 Modern.js 应用的功能开发、依赖升级与版本迁移工作。

#llms.txt

Modern.js 文档遵循 llms.txt 规范，由 @rspress/plugin-llms 自动生成，可通过 /llms.txt 或 /llms-full.txt 供 AI 工具检索：

• 索引：https://modernjs.dev/llms.txt
• 全文：https://modernjs.dev/llms-full.txt（体积较大，按需取片段）

大部分「这个 API / 配置是什么」类问题，靠 llms.txt 即可解决。让你的 Agent 按需检索它即可，不必把文档复制进项目。

#随包文档与 AGENTS.md

每个新建的 Modern.js 项目都开箱即为 agent-ready：

• 随包文档：@modern-js/app-tools 包内置了完整英文文档（node_modules/@modern-js/app-tools/main-doc/docs/en/）——与你安装的框架版本严格一致，离线可用。
• AGENTS.md / CLAUDE.md：npx @modern-js/create 默认生成这两个文件。AGENTS.md 指示 agent 在编写任何 Modern.js 代码前先阅读随包文档（避免依赖过时的训练数据）；CLAUDE.md 通过 @AGENTS.md 指令供 Claude Code 引用。可通过 --no-agents-md 跳过生成；--sub（子项目）模式下也不会生成——monorepo 场景的 agent 文件应由仓库根统一管理。

AGENTS.md 中由 Modern.js 管理的部分包裹在 <!-- BEGIN:modernjs-agent-rules --> / <!-- END:modernjs-agent-rules --> 标记内。标记之外的内容完全归你所有，Modern.js 工具永远不会改动。

#Skills

Skills 是按需触发的 AI 辅助能力，遵循 Agent Skills 开放标准。用户向 Skills：

Skills 默认不强装、不隐式安装，由你显式安装。RSC、微前端等属于配置或架构决策，不是 modernjs-feature-enable 的一键启用项。

#安装 Skills

Modern.js 的用户向 Skill 就放在仓库根 skills/ 目录，遵循 Agent Skills 开放标准。推荐用标准的 skills CLI 直接从 GitHub 安装：

# 列出可安装的 Skills
npx skills add web-infra-dev/modern.js --list

# 安装单个 Skill 到你的 Agent 目录（--agent 可选 claude-code / codex / cursor 等）
npx skills add web-infra-dev/modern.js --skill modernjs-migrate-to-v3 --agent codex -y

它会把整个 Skill 目录（SKILL.md + scripts/ + references/）安装到对应 Agent 目录，随后即可在该 Agent 里触发。

需锁定到某个版本时，在仓库后加 #<ref>（ref 可为 tag / 分支 / commit），即安装该版本上的 Skill（把 <tag> 换成含本 Skill 的发布 tag）：

npx skills add web-infra-dev/modern.js#<tag> --skill modernjs-migrate-to-v3 --agent codex -y