用途:为新项目或已有项目建立统一的工程规范,覆盖类型检查、lint、格式化、测试、pre-commit 与 CI。
主要能力:强调强类型(严格模式)、严格 lint(默认严格,后续更易放宽)、自动格式化、各阶段检查(pre-commit + CI)、测试与源码同目录(foo.ts → foo.test.ts)、面向行为测试(只 mock 外部边界)。
使用方式:先查看 reference/ 下的语言指南(Python、TypeScript);若无指南则用 WebSearch 搜索“[language] project setup best practices”。按顺序执行:typing → linting → formatting → testing → pre-commit → CI。已有项目按同样顺序增量迁移。参考文件包括 reference/python.md(uv、ruff、basedpyright、pytest)、reference/typescript.md(pnpm、ESLint、Prettier、Vitest)、reference/common-patterns.md(测试理念、CI 模式、安全)。工具选择偏好生态标准、活跃维护、默认严格、快速、与编辑器/CI/pre-commit 集成良好。
质量清单:类型用最严格模式,无正当理由不用 any;lint 严格、警告视为错误;保存与 pre-commit 自动格式化;测试同目录、覆盖率 >80%;pre-commit 执行格式化、lint、类型检查;CI 执行相同检查并报告覆盖率;README 含安装说明;初始提交所有检查通过。
限制:具体命令、配置细节与各语言完整步骤需查阅对应 reference 文件,资料未提供完整代码示例;其他语言依赖网络搜索回退,效果取决于搜索结果。