name: lint-and-validate description: “自动质量控制、代码检查和静态分析流程。在每次代码修改后使用,以确保语法正确性和项目标准。触发关键词:lint, format, check, validate, types, static analysis.” allowed-tools: Read, Glob, Grep, Bash
代码检查与验证技能
强制性: 在每次代码更改后运行适当的验证工具。在代码无误之前不要完成任务。
按生态系统分类的流程
Node.js / TypeScript
- 检查/修复:
npm run lint或npx eslint "path" --fix - 类型检查:
npx tsc --noEmit - 安全检查:
npm audit --audit-level=high
Python
- 检查器 (Ruff):
ruff check "path" --fix(快速且现代) - 安全检查 (Bandit):
bandit -r "path" -ll - 类型检查 (MyPy):
mypy "path"
质量循环
- 编写/编辑代码
- 运行审计:
npm run lint && npx tsc --noEmit - 分析报告: 检查“最终审计报告”部分。
- 修复并重复: 不允许提交有“最终审计”失败的代码。
错误处理
- 如果
lint失败:立即修复样式或语法问题。 - 如果
tsc失败:在继续之前纠正类型不匹配。 - 如果没有配置工具:检查项目根目录下的
.eslintrc、tsconfig.json、pyproject.toml并建议创建一个。
严格规则: 在通过这些检查之前,不应提交或报告代码为“完成”。
脚本
| 脚本 | 目的 | 命令 |
|---|---|---|
scripts/lint_runner.py |
统一代码检查 | python scripts/lint_runner.py <project_path> |
scripts/type_coverage.py |
类型覆盖分析 | python scripts/type_coverage.py <project_path> |