检查代码质量:/react-best
对照 React 最佳实践和项目规范,审查刚写的代码。AI 会逐文件检查:组件是否过大、Hook 使用是否合规、有没有性能隐患、命名是否一致,然后输出一份结构化报告。
# 在 Claude Code 中输入
/react-best
类比:相当于找一位资深前端做 Code Review,只不过这位"同事"24 小时在线,且每次都会按同一份标准检查。
AI全栈技师图灵奖预备役
请输入访问密码
STAGE 02-1 · 跑起来
照着顺序做一遍,以后每次拿到新项目都能自己搞定:环境准备 → 安装依赖 → 启动项目。
01 / 准备 + 装依赖
项目代码只是团队写的部分,还需要下载第三方库才能跑。
Node、nvm、pnpm 的安装已在 00 课讲过。先把项目 clone 下来、cd 进项目目录——这时目录里如果有团队配好的 .nvmrc(写明该用哪个 Node 版本),先 nvm use 切到统一版本,再装依赖。依赖(第三方库)只在第一次拉项目、或依赖更新时装。
# 前提:nvm / Node / pnpm 这几个工具已装好(见 00 课)
# 拉取项目并进入目录(地址见 00 课/02-2)
git clone <项目地址>
cd <项目文件夹>
# 切到项目指定的 Node 版本(项目带 .nvmrc 时)
nvm use
# 安装根目录依赖(这里是用 pnpm 装项目依赖,不是装 pnpm 本身)
pnpm install
# 安装特定应用依赖
cd apps/web
pnpm install
02 / 跑起来
最常用的命令——启动后浏览器打开就能看到页面。
日常最常用的命令。运行后终端输出本地地址(通常 localhost:3000),浏览器打开就能看到页面,改完代码自动刷新。
# 启动所有应用
pnpm dev
# 启动特定应用
cd apps/web
pnpm dev
# 或使用 TurboRepo 命令
pnpm --filter web dev
03 / 打包
把源码打包成可部署的文件。日常开发用 dev,发布时才用 build。
把源码编译、打包成可部署的文件。和 dev 的区别:dev 给开发时看实时效果,build 生成发布用的最终文件。日常主要用 dev,发布时才用 build。
# 构建所有应用
pnpm build
# 构建特定应用
pnpm --filter web build
04 / 检查
提交前跑一遍,确保代码规范、格式统一。
提交前跑这两个命令。lint 检查代码有没有问题或不规范的写法,format 自动统一格式(缩进、引号等)。很多项目在 CI 里强制检查,不过就无法合并。
# 运行 ESLint 检查
pnpm lint
# 格式化代码
pnpm format
05 / 收尾
让 AI 帮忙检查质量、处理国际化、补全设计文档,再用 Git 规范提交和推送。
代码写完不算结束。团队定了五步完整流程:前三步让 AI 提高代码质量和文档完整度,后两步用 Git 规范提交改动。前三步是 Claude Code 里的斜杠命令,后两步是终端 Git 命令。
/react-best对照 React 最佳实践和项目规范,审查刚写的代码。AI 会逐文件检查:组件是否过大、Hook 使用是否合规、有没有性能隐患、命名是否一致,然后输出一份结构化报告。
# 在 Claude Code 中输入
/react-best
类比:相当于找一位资深前端做 Code Review,只不过这位"同事"24 小时在线,且每次都会按同一份标准检查。
/write-i18n扫描目标模块,把硬编码的中文文案替换成 i18n key。AI 会自动按项目规范命名 key(模块.功能.描述),生成对应的语言文件,支持动态变量占位。
# 在 Claude Code 中输入,指定模块
/write-i18n src/pages/UserProfile
类比:就像请了一个翻译,把界面上的文字都换成"占位符",方便以后切换成英文、日文等其他语言。
design-note.md让 AI 根据刚写完的代码,自动填写 design-note.md 设计说明文档。记录页面结构、交互逻辑、组件拆分原因、状态管理等设计决策,方便后续维护和团队交接。
# 在 Claude Code 中用自然语言描述
请根据当前代码更新 design-note.md,
记录本次修改涉及的页面结构、交互逻辑和设计决策
类比:就像建筑工人盖完一面墙后,在图纸上标注"这面墙用了什么材料、为什么这样砌",方便后来的施工队理解。
git commit -a -m用 Git 把改动记录下来。git commit -a -m "改动说明" 这条命令把所有改过的文件都保存一份快照,并附上说明。-a 的意思是"自动选中所有改过的文件",-m 的意思是"这次保存的说明",引号里就是你对这次改动的描述。如果想不出来说明,告诉 AI "根据这些代码改动,给我一个简洁的说明"。
# 查看当前改动了哪些文件
git status
# 提交改动,-a 自动选中改过的文件,-m 后面是这次改动的说明
git commit -a -m "添加用户个人资料页面"
# 说明尽量简洁,举几个例子
git commit -a -m "修复登录表单验证问题"
git commit -a -m "更新首页文案"
-a 是什么?自动选中所有改过的文件,省得你一个个挑。-m 是什么?后面引号里是这次改动的说明,方便以后查看历史时知道每次改了啥。
git push把本地的 commits 上传到 GitLab 远程分支。第一次推新分支需要用 git push -u origin 分支名,之后直接 git push 即可。推送完成后,你就可以在 GitLab 网页上发起 Merge Request,让团队评审你的代码。
# 第一次推新分支
git push -u origin feature/user-profile
# 之后直接推送
git push
类比:就像把整理好的文件夹上传到云盘,让团队都能看到。上传后在 GitLab 网页上点「Create Merge Request」,请大家评审。
本课核心