# 项目规范

## 技术栈
- Next.js 16 + TypeScript
- Tailwind CSS + shadcn/ui
- Supabase 数据库

## 代码风格
- 使用函数组件
- 优先使用 Server Components
- 类型定义放在 types/ 目录

## 禁止事项
- 不要使用 any 类型
- 不要使用 console.log

# 同时修改多个文件
claude "重构用户模块，把 UserService 拆分成 AuthService 和 ProfileService"

# 让 Claude 帮你写 commit message
claude commit

# 让 Claude 帮你创建 PR 描述
claude pr

# 让 Claude 帮你解决合并冲突
claude "解决当前的合并冲突"

# ~/.claude/commands/review.md
请审查以下代码变更：
1. 检查安全问题
2. 检查性能问题
3. 检查代码风格
4. 给出改进建议

变更文件：$ARGUMENTS

claude /review src/components/UserList.tsx

# 把文件内容传给 Claude
cat src/utils/api.ts | claude "优化这个文件的性能"

# 把 git diff 传给 Claude
git diff | claude "审查这些变更"

# 把错误日志传给 Claude
cat error.log | claude "分析这个错误"

# 批量重命名
claude "把所有 useXxx hook 文件从 hooks/ 移到 hooks/custom/"

# 批量添加类型
claude "给 src/api/ 下所有函数添加返回类型标注"

# 批量修复 lint 错误
pnpm lint --json | claude "修复这些 lint 错误"

# 清除上下文
claude --clear

# 恢复上次对话
claude --continue

# 指定上下文文件
claude --include src/types/api.ts "实现用户 API"

# 先让 Claude 写测试
claude "为用户注册功能写单元测试"

# 再让 Claude 实现功能
claude "实现用户注册功能，通过刚才写的测试"

# 让 Claude 分析错误
claude "这个错误是什么原因？" << EOF
TypeError: Cannot read property 'id' of undefined
  at UserCard (src/components/UserCard.tsx:15:23)
  at renderWithHooks (node_modules/react-dom/...)
EOF

# 让 Claude 添加调试日志
claude "在关键位置添加调试日志，帮助定位问题"

# 从 API 文档生成类型
claude "根据这个 API 文档生成 TypeScript 类型" << EOF
GET /api/users
Response: { users: [{ id, name, email, created_at }] }
EOF

# 从设计稿生成组件
claude "根据这个描述实现组件：一个卡片列表，每个卡片显示头像、姓名、职位"

# 安全重构
claude "把 UserService 类重构成函数式风格，保持所有测试通过"

# 提取组件
claude "把 UserList 中的 UserCard 提取成独立组件"

# 优化性能
claude "优化这个组件的渲染性能，减少不必要的重渲染"

# 生成 API 文档
claude "给 src/api/ 下所有函数生成 JSDoc 文档"

# 生成 README
claude "根据项目结构生成 README.md"

# 生成变更日志
claude "根据 git log 生成 CHANGELOG.md"

# Tab 补全文件路径
claude "修改 src/comp<Tab>"

# 上下箭头切换历史
claude <Up>  # 上一条命令

# Ctrl+C 中断生成
# Ctrl+D 退出

# 简洁输出
claude --quiet "解释这段代码"

# 详细输出
claude --verbose "解释这段代码"

# 只输出代码
claude --code-only "实现排序函数"

# 开多个终端并行工作
# 终端 1：前端开发
claude "实现用户列表页面"

# 终端 2：后端开发
claude "实现用户 API 接口"

# 终端 3：测试
claude "写用户模块的测试"

# 使用特定模型
claude --model claude-opus-4 "复杂的架构设计"
claude --model claude-sonnet-4 "简单的代码修改"

# 配置 MCP Server
claude mcp add postgres -- npx @modelcontextprotocol/server-postgres "..."

# 使用 MCP 工具
claude "查询数据库中最近注册的用户"

# 分享对话
claude --share

# 导出对话
claude --export > conversation.md

# 导入规范
claude --import team-rules.md

# CI/CD 中使用
claude --non-interactive "检查代码是否有安全问题" > security-report.txt

# 批量处理
for file in src/components/*.tsx; do
  claude --quiet "检查 $file 是否有性能问题" >> perf-report.txt
done

# 开启调试模式
claude --debug "为什么这个测试失败"

# 查看 token 使用
claude --show-tokens "解释这段代码"

# 方法 1：清除并重新开始
claude --clear

# 方法 2：只包含相关文件
claude --include src/types.ts --include src/api.ts "实现功能"

# 方法 3：分步骤处理
claude "第一步：分析代码结构"
claude --continue "第二步：实现功能"

# 方法 1：提供更多上下文
claude "参考 src/components/Button.tsx 的风格，实现 Input 组件"

# 方法 2：明确约束
claude "实现 Input 组件，要求：支持 ref、支持错误状态、支持前后缀"

# 方法 3：迭代优化
claude "优化刚才的代码，添加错误处理"

# 方法：使用 CLAUDE.md
echo "代码风格参考 src/components/Button.tsx" >> CLAUDE.md