Claude Code Tresor实战:用斜杠命令从零构建现代化React应用
Claude Code Tresor实战:用斜杠命令从零构建现代化React应用
还在为搭建一个 React 项目反复手写配置文件而头疼吗?Claude Code Tresor 是一个世界级的 Claude Code 工具集,内置 斜杠命令(Slash Commands)、专家级 Agents 和自动化 Skills,只需几条 /scaffold、/review 命令,就能在几十分钟内从零生成一个带 TypeScript、Tailwind CSS、完整测试和 CI/CD 的现代化 React 应用。
本文将带你走通一条完整路径:安装 → 脚手架生成 → 组件开发 → 自动化测试 → 代码审查 → 文档生成,全程以斜杠命令为核心,新手也能照着做。
一、Claude Code Tresor 是什么?
Claude Code Tresor 的核心资产可以概括为"三层武器库":
| 类型 | 数量 | 作用 | 调用方式 |
|---|---|---|---|
| ⚡ 斜杠命令 | 19 个 | 一键执行标准化工作流 | /scaffold、/review |
| 🤖 专家 Agents | 141 个 | 多视角深度分析 | @test-engineer、@docs-writer |
| ✨ 自动化 Skills | 8 个 | 编码时后台自动检查 | 保存文件自动触发 |
其中与本文 React 实战最相关的斜杠命令有:
/scaffold:生成项目结构、React 组件、API 服务、CI/CD 配置/test-gen:自动创建测试套件/review:多 Agent 并行代码审查/docs-gen:从代码生成文档/code-health:评估代码库健康度
💡 详细清单可查看官方文档:documentation/reference/commands-reference.md
二、5分钟一键安装步骤
2.1 准备环境
- Node.js 18+(React 项目构建需要)
- Claude Code CLI(运行
claude --version确认) - Git 2.0+
2.2 克隆并运行安装脚本
# 克隆仓库
git clone https://gitcode.com/gh_mirrors/cl/claude-code-tresor
cd claude-code-tresor
# 一键安装:8 个 Skills + 8 个 Agents + 全部斜杠命令
./scripts/install.sh
安装脚本位于 scripts/install.sh,只想要斜杠命令可以精简安装:
./scripts/install.sh --commands-only
2.3 验证安装成功
ls ~/.claude/commands/ # 应能看到 scaffold/、review/、test-gen/ 等目录
启动 Claude Code 后输入 /scaffold --help,能看到参数说明即安装成功。完整安装指南见:documentation/guides/installation.md。
三、用 /scaffold 一键生成 React 应用骨架
这是全文最关键的一步。在 Claude Code 中执行:
/scaffold react-app task-manager --typescript --vite --tailwind --tests
一条命令背后,/scaffold 会自动完成以下工作:
- 创建 Vite + React + TypeScript 工程
- 配置 Tailwind CSS 样式方案
- 初始化 Jest + Testing Library 测试环境
- 生成 ESLint + Prettier 质量配置
- 搭建标准目录结构(
src/components/、src/hooks/等)
生成后的验证三步走:
cd task-manager
npm install # 安装依赖
npm run dev # 开发服务器启动在 http://localhost:5173
/scaffold 支持的全部参数(--tests、--ci、--docker、--auth 等)和模板变体(minimal / standard / complete / enterprise)详解在:commands/development/scaffold/README.md。
📖 仓库内置了完整的 React 应用搭建工作流参考,本文步骤即基于它整理:examples/workflows/react-app-setup.md
四、快速生成核心组件
4.1 用命令生成组件骨架
# 生成带 Hooks、测试和 Storybook 故事的组件
/scaffold react-component UserProfile --hooks --tests --stories
生成的标准结构:
src/components/UserProfile/
├── UserProfile.tsx
├── UserProfile.test.tsx
├── UserProfile.stories.tsx
└── index.ts
4.2 用 Prompt 模板生成复杂组件
对于 TaskList 这类需要多个子组件和状态处理的复杂组件,直接调用专家 Agent 效果更好:
@docs-writer 为一个任务管理应用创建 TaskList 组件:
- 显示任务的标题、描述、状态和截止日期
- 支持状态过滤(全部/进行中/已完成)
- 使用 TypeScript + Tailwind CSS
- 包含无障碍特性和完整测试
更省事的做法是复用仓库中打磨过的提示词模板,替换变量即可:prompts/code-generation/frontend.md。组件的 React 风格规范可参考:standards/style-guides/react.md。
五、用 /test-gen 补齐测试覆盖
手动写测试往往拖到上线前才补,而斜杠命令可以让测试"随写随生成":
# 为指定文件生成测试,目标覆盖率 90%
/test-gen --file components/UserCard.tsx --framework jest
如果需要体系化的测试策略(单测、集成测试、API Mock、无障碍测试),交给测试专家 Agent:
@test-engineer 为这个 React 任务管理应用制定完整测试策略:
- 所有组件的单测
- 用户流集成测试
- API Mock 配置
- jest-axe 无障碍测试
@test-engineer 的能力定义见:agents/test-engineer/agent.md。
六、用 /review 做专业级代码审查
提交前执行多视角自动审查,/review 会并行调度代码质量、安全、性能、架构等多个 Agent:
# 审查已暂存的改动,开启安全与性能检查
/review --scope staged --checks security,performance
# 或按检查项全面审查 React 应用
/review --checks security,performance,style,accessibility
支持的检查维度包括:security、performance、style、maintainability、testing、documentation。输出是带严重级别(critical / high / medium / low)的统一行动清单,可以直接当作修复待办。
七、文档与上线前的质量把关
7.1 一键生成文档
# 生成带徽章和示例的 README
/docs-gen readme --sections all --badges --examples
# 生成组件使用指南
/docs-gen guide --type component --format gitbook
7.2 上线前健康检查
v2.7.0 新增了 10 个编排命令,发布前建议跑一轮:
| 命令 | 用途 | 耗时 |
|---|---|---|
/code-health |
代码库质量评估、测试覆盖率打分 | 20-40 分钟 |
/vulnerability-scan |
依赖 CVE 扫描、漏洞检测 | 30-60 分钟 |
/deploy-validate |
部署前验证,给出 go/no-go 决策 | 10-20 分钟 |
八、常见问题排查
| 问题 | 解决方案 |
|---|---|
/scaffold 提示 Template not found |
检查模板名是否为 minimal / standard / complete / enterprise |
提示 Directory already exists |
加 --overwrite 参数覆盖已有文件 |
| 命令不被识别 | 确认 ~/.claude/commands/ 下有对应目录,并重启 Claude Code |
| 测试快照失败 | 运行 npm run test -- --updateSnapshot 更新快照 |
更多排查手段见:documentation/guides/troubleshooting.md
九、下一步:扩展你的 React 应用
完成基础应用后,推荐沿着官方示例继续深入:
- API 集成:
/scaffold express-api user-service --auth --database --tests,后端开发全流程参考 examples/workflows/api-development.md - 性能优化:调用
@performance-tuner分析包体积、虚拟滚动、记忆化机会,案例参考 examples/case-studies/performance-optimization.md - CI/CD 流水线:
/scaffold ci-cd github-actions --tests --deploy --security,参考 examples/workflows/ci-cd-pipeline.md - 持续更新工具集:
./scripts/update.sh拉取最新命令与 Agent
总结
Claude Code Tresor 把"建 React 应用"这件事拆解成了一条可复制的斜杠命令流水线:
/scaffold react-app—— 分钟级生成工程骨架/scaffold react-component—— 标准化组件产出/test-gen—— 测试覆盖不掉队/review—— 多 Agent 视角质量把关/docs-gen—— 文档随代码同步生长
对于新手来说,最大的价值不是省了几行代码,而是强制建立了一套专业团队的工程节奏。装上这套工具集,你的第一个 React 项目就拥有了生产级的底子。
延伸阅读:
- 5 分钟上手指南:GETTING-STARTED.md
- 架构设计说明:ARCHITECTURE.md
- 完整文档中心:documentation/README.md