---
name: dev-workflow-checker
description: 开发流程检查技能，确保代码修改后执行必要的质量检查
---

# 开发流程检查技能

当用户进行代码修改后，此技能确保执行必要的质量检查命令，同时遵循务实开发理念。

## 技能描述

该技能会在用户完成代码修改后，自动提醒并执行相关的开发流程检查，确保代码质量和类型安全，但不追求过度的完美标准。

### 技能使用原则
- **保证质量，但避免过度检查**：执行必要的检查，但不追求完美的检查流程
- **实用功能优先，理论完美次之**：解决实际的代码问题比预防各种可能更重要
- **简单解决方案优于复杂方案**：优先选择直接有效的检查方式
- **务实开发指导**：评估检查的必要性，避免过度检查

## 检查内容

### 前端应用 (`src/web`)
当修改前端代码时，执行以下检查：
- `pnpm typecheck` - TypeScript 类型检查
- `pnpm lint` - Biome linter 检查
- `pnpm test` - 运行测试套件
- `pnpm check:all` - 运行所有质量检查（如果需要全面检查）

### 后端应用 (`src/server`)
当修改后端代码时，执行以下检查：
- `pnpm typecheck` - TypeScript 类型检查
- `pnpm lint` - Biome linter 检查
- `pnpm test` - 运行测试套件
- `pnpm check:all` - 运行所有质量检查（如果需要全面检查）

## 使用场景

1. **完成代码修改后**：自动提醒用户执行相应的检查命令
2. **提交代码前**：确保所有检查都通过
3. **PR 创建前**：验证代码质量标准
4. **集成测试前**：确保基本质量门控通过

## 检查流程

### 前端代码修改流程
```bash
# 1. 类型检查
pnpm typecheck

# 2. 代码风格检查
pnpm lint

# 3. 运行测试
pnpm test

# 4. 全面检查（可选）
pnpm check:all
```

### 后端代码修改流程
```bash
# 1. 类型检查
pnpm typecheck

# 2. 代码风格检查
pnpm lint

# 3. 运行测试
pnpm test

# 4. 全面检查（可选）
pnpm check:all
```

## 质量标准

### 必须通过的检查
- ✅ TypeScript 类型检查（零错误）
- ✅ Biome linter 检查（符合项目代码风格）
- ✅ 测试套件（所有测试通过）

### 推荐检查
- ✅ 代码覆盖率（达到80%目标）
- ✅ 拼写检查
- ✅ 重复代码检查

## 错误处理

### 类型检查失败
- 检查 `any` 类型的使用
- 验证 React 组件属性类型
- 确保路径别名正确使用

### Linter 检查失败
- 代码格式不符合项目标准
- 导入顺序不正确
- 未使用的变量或导入

### 测试失败
- 检查测试用例的逻辑
- 验证 mock 配置
- 确认测试环境设置

## 项目特定要求

### 零容忍政策
- **禁止使用 `any` 类型**：必须使用具体类型或 `unknown`
- **测试文件类型安全**：同样禁止 `any` 类型
- **React 组件属性类型**：使用具体的 React 组件属性类型

### 路径别名要求
- 跨目录导入必须使用正确的路径别名
- 避免使用相对路径导入其他目录
- 按照最佳实践排序导入语句

### 本地化规范
- 代码注释使用中文
- 测试用例描述使用中文
- 变量和函数名继续使用英文

## 自动化建议

建议在以下场景自动触发检查：
1. Git pre-commit hook
2. CI/CD pipeline
3. IDE 保存时自动检查
4. Pull Request 创建时

## 注意事项

1. **区分应用目录**：根据修改的文件选择正确的检查命令
2. **错误优先级**：先修复类型错误，再处理风格问题
3. **性能考虑**：全面检查耗时较长，可在关键时刻执行
4. **团队协作**：确保所有开发人员遵循相同的检查标准