用途:react-ai-infra 是一个元技能,把 APM(Agent Package Manager)和团队整理的 React 技能集接入已存在的 React 项目,覆盖 Claude Code 与 GitHub Copilot。它不搭建 React 项目本身,用户需先运行 create-next-app、create-tsrouter-app、npm create vite 或同类命令;本技能负责代理资产层:apm.yml、捆绑技能与规则、框架专属 AGENTS.md。
主要能力与流程:0)验证 apm CLI 是否安装,未安装则中止并给出安装说明;1)在项目根目录检测目标环境(.claude/ 或 CLAUDE.md 对应 claude,.github/ 或 copilot-instructions.md 对应 copilot,.agents/skills/ 为跨客户端技能总线);2)询问使用哪种 React 框架(Next.js / TanStack Start / Vite + React),不自动检测,非交互运行必须快速失败;3)从 templates/apm.yml 生成或合并 apm.yml,targets 字段须为块式列表且始终包含 agent-skills;4)经用户确认后运行 apm install --target <列表>;5)把捆绑技能复制到 .claude/skills/ 与 .agents/skills/;6)把捆绑规则复制到 .claude/rules/,并为 Copilot 转换 frontmatter 后写入 .github/instructions/<name>.instructions.md;7)部署框架专属 AGENTS.md(目前仅 Next.js 有模板,其他框架干净跳过);8)验证并报告。
使用方式:需项目根目录(含 package.json)、PATH 中可用的 apm CLI、以及用于框架选择的交互式会话。Windows 上 apm 通常仅注册到 PowerShell,Git Bash/WSL 可能报 command not found,需回退 PowerShell 再判断。安装命令:Windows(PowerShell)irm https://aka.ms/apm-windows | iex;macOS/Linux curl -sSL https://aka.ms/apm-unix | sh;Homebrew brew install microsoft/apm/apm;pip pip install apm-cli。
适用场景:已有 React/Next.js/TanStack Start/Vite 仓库需要接入团队代理资产;需要 Claude Code 与 Copilot 双端技能与规则一致;把 APM 管理的依赖(如 react-best-practices)接入项目。
限制:不适用于非 React 项目;仓库尚未创建时需先运行对应脚手架命令;只想安装单个 APM 包应直接调用 apm install <pkg>;部分 monorepo 固定工具版本时不应安装 APM。apm install 会在项目根写入 apm_modules/,较新版本会自动把 apm_modules/ 追加到 .gitignore。检测到的 targets 会写入 apm.yml,后续新增目标不会自动加入,需手动编辑 targets 并重跑 apm install。捆绑资产包括 templates/apm.yml、templates/agents/nextjs.md、skills/no-use-effect/SKILL.md、rules/react-components.md。其他细节暂未提供。