⚡

项目设置与工具链配置Skill project-setup

这个技能用于引导新软件开发项目的初始化过程，实现强类型、严格代码检查、自动格式化、全面测试、预提交钩子和持续集成，支持多种语言如Python和TypeScript，确保代码质量和开发效率。关键词：项目初始化、强类型、代码检查、自动化测试、CI/CD、开发工作流。

DevOps 0 次安装 0 次浏览 更新于 3/9/2026

名称: 项目设置 描述: 引导新项目，具备强类型、代码检查、格式化和测试。支持Python、TypeScript和其他语言，并附带研究回退。

项目设置

核心原则

  • 强类型: 启用严格模式；类型在编译时捕获错误
  • 强代码检查: 默认严格规则；禁用比添加更容易
  • 自动格式化: 自动化和一致；无需手动格式化
  • 每个阶段检查: 预提交钩子 + CI；早期捕获问题
  • 共位测试: foo.ts → foo.test.ts；明确测试内容
  • 行为聚焦: 测试代码做什么，而不是如何做；仅模拟外部边界

工作流程

  1. 检查 reference/ 中的语言指南（Python、TypeScript）
  2. 如果没有指南：WebSearch “[语言] 项目设置最佳实践”
  3. 遵循设置顺序：类型检查 → 代码检查 → 格式化 → 测试 → 预提交 → CI
  4. 对于现有项目：按相同顺序逐步迁移

参考文件

  • reference/python.md - uv, ruff, basedpyright, pytest
  • reference/typescript.md - pnpm, ESLint, Prettier, Vitest
  • reference/common-patterns.md - 测试理念、CI模式、安全

工具选择

优先选择工具：生态系统标准、积极维护、默认严格、快速、良好集成（编辑器 + CI + 预提交）。

质量检查清单

  • [ ] 类型检查: 最严格模式，无 any 类型，除非有正当理由
  • [ ] 代码检查: 严格规则，警告视为错误
  • [ ] 格式化: 保存时自动格式化 + 预提交
  • [ ] 测试: 共位测试，覆盖率 >80%
  • [ ] 预提交: 格式化、代码检查、类型检查
  • [ ] CI: 相同检查 + 覆盖率报告
  • [ ] README: 设置说明
  • [ ] 初始提交时所有检查通过