lint-and-validate

# Lint 与验证技能 > **强制要求：** 在每次代码变更后运行适当的验证工具。在代码无错误之前，不得完成任务。 ### 各生态系统流程 #### Node.js / TypeScript 1. **Lint/修复:** `npm run lint` 或 `npx eslint "path" --fix` 2. **类型检查:** `npx tsc --noEmit` 3. **安全性:** `npm audit --audit-level=high` #### Python 1. **Linter (Ruff):** `ruff check "path" --fix` (快速且现代) 2. **安全性 (Bandit):** `bandit -r "path" -ll` 3. **类型检查 (MyPy):** `mypy "path"` ## 质量循环 1. **编写/编辑代码** 2. **运行审计:** `npm run lint && npx tsc --noEmit` 3. **分析报告:** 检查“最终审计报告”部分。 4. **修复并重复:** 不允许提交带有“最终审计”失败的代码。 ## 错误处理 - 如果 `lint` 失败：立即修复样式或语法问题。 - 如果 `tsc` 失败：在继续之前纠正类型不匹配。 - 如果未配置工具：检查项目根目录下的 `.eslintrc`, `tsconfig.json`, `pyproject.toml` 并建议创建一个。 --- **严格规则：** 在未通过这些检查之前，不得提交任何代码或报告为“已完成”。 --- ## 脚本 | 脚本 | 用途 | 命令 | |--------|---------|---------| | `scripts/lint_runner.py` | 统一 Lint 检查 | `python scripts/lint_runner.py ` | | `scripts/type_coverage.py` | 类型覆盖率分析 | `python scripts/type_coverage.py ` |