SKILL.md
utoo - 统一前端工具链
utoo 是一个高性能的 npm 包管理工具，提供依赖安装、脚本执行、包信息查看等功能。
别名
utoo/ut- 主命令
utx- 执行命令别名（等同于ut x）
命令速查
命令
简写
说明
utoo install
ut i
安装项目依赖
utoo uninstall <pkg>
ut un
卸载指定依赖
utoo run <script>
ut r / utoo <script>
运行 package.json 中的脚本
utoo run
ut r
交互式选择 workspace 和脚本
utoo list
ut ls
列出依赖树
utoo view <pkg>
ut v / ut info
查看包信息
utoo execute <pkg>
ut x / utx
执行本地或远程 npm 包命令
utoo link
ut ln
链接本地包
utoo deps
ut d
仅生成 package-lock.json
utoo update
ut u
删除 node_modules 并重新安装
utoo clean
ut c
清理全局包缓存
utoo rebuild
ut rb
重建脚本钩子
utoo config
ut cfg
管理配置
使用指南
运行脚本
# 快捷方式：直接运行 package.json 中的脚本
utoo build
utoo dev
ut test
# 交互式选择（适用于 monorepo）
utoo run
# → 会引导用户选择 workspace 和对应脚本
# 显式运行
utoo run build
ut r dev安装依赖
# 安装所有依赖
utoo install
# 安装指定包
utoo install lodash
# 安装开发依赖
utoo install -D typescript
# 安装并保存到 package.json
utoo install react --save查看依赖
# 查看依赖树
utoo list
# 查看指定深度
utoo list --depth=1
# 查看包信息
utoo view react执行远程包
# 使用 utx 别名（推荐）
utx create-react-app my-app
utx vite
# 或使用完整命令
utoo execute create-react-app my-app
ut x vite常见任务
- 初始化项目: 先检查是否有 package.json，然后运行
utoo install
- 添加新依赖: 使用
utoo install <package>
- 运行开发服务器: 使用
utoo dev或ut dev
- 构建项目: 使用
utoo build或ut build
- 查看依赖关系: 使用
utoo list分析依赖树
- Monorepo 操作: 使用
utoo run交互式选择 workspace 和脚本
配置管理
# 设置镜像源
utoo config set registry https://registry.npmmirror.com --global
# 查看当前配置
utoo config list最佳实践
镜像源选择
根据网络环境选择合适的镜像源，使用 --registry 参数指定：
# 使用 npmmirror（国内推荐，速度快）
utoo install --registry https://registry.npmmirror.com
utoo install lodash --registry https://registry.npmmirror.com
# 使用 npm 官方源（国外或需要最新包时）
utoo install --registry https://registry.npmjs.org
# 更新依赖时指定镜像源
utoo update --registry https://registry.npmmirror.com常用镜像源
镜像源
URL
适用场景
npmmirror
https://registry.npmmirror.com
国内用户，速度快
npm 官方
https://registry.npmjs.org
需要最新包，国外网络
建议
- 国内用户: 优先使用 npmmirror 镜像，安装速度更快
- 需要最新版本: 如果 npmmirror 同步延迟，可临时切换到官方源
- CI/CD 环境: 建议在命令中显式指定
--registry确保一致性
执行指令
**重要：当此 skill 被调用时，你必须立即使用 Bash 工具执行 ut 命令。**
执行流程
- 直接执行用户请求的 ut 命令
- 如果返回 "command not found: ut"、"command not found: utoo" 或 "command not found: utx"，执行安装命令：
curl -fsSL https://utoo.land/install | bash- 安装完成后，重新执行用户请求的命令
命令映射
- ARGUMENTS:
test→ 执行ut test
- ARGUMENTS:
install→ 执行ut install
- ARGUMENTS:
install <pkg>→ 执行ut install <pkg>
- ARGUMENTS:
run <script>→ 执行ut run <script>
- ARGUMENTS:
<script>→ 执行ut <script>（快捷方式）
禁止使用 pnpm/npm/yarn 命令，必须使用 ut 命令。