代码检查与校验技能
强制要求: 每次代码变更后必须运行相应校验工具。在代码无错误前,不得将任务视为完成。
按技术栈执行流程
Node.js / TypeScript
- Lint/Fix:
npm run lint或npx eslint "path" --fix - Types:
npx tsc --noEmit - Security:
npm audit --audit-level=high
Python
- Linter(Ruff):
ruff check "path" --fix(快速且现代) - Security(Bandit):
bandit -r "path" -ll - Types(MyPy):
mypy "path"
质量闭环
- 编写/修改代码
- 执行审计:
npm run lint && npx tsc --noEmit - 分析报告: 检查 “FINAL AUDIT REPORT” 段落。
- 修复并重复: “FINAL AUDIT” 失败时禁止提交代码。
错误处理
- 若
lint失败:立即修复风格或语法问题。 - 若
tsc失败:先修复类型不匹配,再继续流程。 - 若未配置工具:检查项目根目录中是否有
.eslintrc、tsconfig.json、pyproject.toml,并建议补齐配置。
严格规则: 未通过上述检查的代码,不得提交,也不得标记为“完成”。
脚本
| 脚本 | 用途 | 执行命令 |
|---|---|---|
scripts/lint_runner.py |
统一 lint 检查 | python scripts/lint_runner.py <project_path> |
scripts/type_coverage.py |
类型覆盖率分析 | python scripts/type_coverage.py <project_path> |