用途：在 Next.js 项目中运行 @next/codemod 的 agents-md codemod，将压缩后的 Next.js 框架文档注入项目根目录的 CLAUDE.md 或 AGENTS.md，使 AI 编码代理无需工具调用或技能即可被动获得框架知识。
主要能力：自动检测项目中的 Next.js 版本并下载匹配版本的文档；把约 40KB 文档压缩为约 8KB 的管道分隔索引注入目标文件；同时把完整文档下载到 .next-docs/ 并自动加入 .gitignore；非破坏性更新，已有文件只注入或更新索引部分。
使用方式：先确认 package.json 的 dependencies 或 devDependencies 中含 next，否则停止并提示这不是 Next.js 项目。目标文件优先级为 CLAUDE.md（若存在）→ AGENTS.md（若存在）→ 默认 CLAUDE.md。在项目根目录执行：npx @next/codemod@canary agents-md --output <TARGET_FILE>，其中 TARGET_FILE 为检测到的文件名。--output 使命令非交互。运行后读取目标文件确认已包含注入内容，再向用户报告版本、更新文件与大小，并建议提交更改。
适用场景：使用 Claude Code 等支持 skills.sh 标准的 AI 代理开发 Next.js 项目时，为代理提供框架参考文档。
限制：仅适用于 Next.js 项目；需要网络下载文档；需具备 Node.js 工具链（npx）；资料未提供其他平台或收费信息。