tomevault-io 开发流程检查技能
当用户进行代码修改后，此技能确保执行必要的质量检查命令，同时遵循务实开发理念。
技能描述
该技能会在用户完成代码修改后，自动提醒并执行相关的开发流程检查，确保代码质量和类型安全，但不追求过度的完美标准。
技能使用原则
- 保证质量，但避免过度检查：执行必要的检查，但不追求完美的检查流程
- 实用功能优先，理论完美次之：解决实际的代码问题比预防各种可能更重要
- 简单解决方案优于复杂方案：优先选择直接有效的检查方式
- 务实开发指导：评估检查的必要性，避免过度检查
检查内容
前端应用 (apps/frontend)
当修改前端代码时，执行以下检查：
pnpm check:type- TypeScript 类型检查pnpm lint- Biome linter 检查pnpm test- 运行测试套件pnpm check:all- 运行所有质量检查（如果需要全面检查）
后端应用 (apps/backend)
当修改后端代码时，执行以下检查：
pnpm check:type- TypeScript 类型检查pnpm lint- Biome linter 检查pnpm test- 运行测试套件pnpm check:all- 运行所有质量检查（如果需要全面检查）
使用场景
- 完成代码修改后：自动提醒用户执行相应的检查命令
- 提交代码前：确保所有检查都通过
- PR 创建前：验证代码质量标准
- 集成测试前：确保基本质量门控通过
检查流程
前端代码修改流程
# 1. 类型检查
pnpm check:type
# 2. 代码风格检查
pnpm lint
# 3. 运行测试
pnpm test
# 4. 全面检查（可选）
pnpm check:all
后端代码修改流程
# 1. 类型检查
pnpm check:type
# 2. 代码风格检查
pnpm lint
# 3. 运行测试
pnpm test
# 4. 全面检查（可选）
pnpm check:all
质量标准
必须通过的检查
- ✅ TypeScript 类型检查（零错误）
- ✅ Biome linter 检查（符合项目代码风格）
- ✅ 测试套件（所有测试通过）
推荐检查
- ✅ 代码覆盖率（达到80%目标）
- ✅ 拼写检查
- ✅ 重复代码检查
错误处理
类型检查失败
- 检查
any类型的使用 - 验证 React 组件属性类型
- 确保路径别名正确使用
Linter 检查失败
- 代码格式不符合项目标准
- 导入顺序不正确
- 未使用的变量或导入
测试失败
- 检查测试用例的逻辑
- 验证 mock 配置
- 确认测试环境设置
项目特定要求
零容忍政策
- 禁止使用
any类型：必须使用具体类型或unknown - 测试文件类型安全：同样禁止
any类型 - React 组件属性类型：使用具体的 React 组件属性类型
路径别名要求
- 跨目录导入必须使用正确的路径别名
- 避免使用相对路径导入其他目录
- 按照最佳实践排序导入语句
本地化规范
- 代码注释使用中文
- 测试用例描述使用中文
- 变量和函数名继续使用英文
自动化建议
建议在以下场景自动触发检查：
- Git pre-commit hook
- CI/CD pipeline
- IDE 保存时自动检查
- Pull Request 创建时
注意事项
- 区分应用目录：根据修改的文件选择正确的检查命令
- 错误优先级：先修复类型错误，再处理风格问题
- 性能考虑：全面检查耗时较长，可在关键时刻执行
- 团队协作：确保所有开发人员遵循相同的检查标准
Converted and distributed by TomeVault — claim your Tome and manage your conversions.