---

name: lint-and-validate description: "强制要求：每次代码更改后运行适当的验证工具。在代码无错误之前不要完成任务。" risk: unknown source: community date_added: "2026-02-27"

代码检查与验证技能

强制要求： 每次代码更改后运行适当的验证工具。在代码无错误之前不要完成任务。

按生态系统的流程

Node.js / TypeScript

1. 检查/修复： npm run lint 或 npx eslint "path" --fix
2. 类型检查： npx tsc --noEmit
3. 安全检查： npm audit --audit-level=high

Python

1. 检查器 (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 | 统一代码检查 | python scripts/lint_runner.py <project_path> | | scripts/type_coverage.py | 类型覆盖率分析 | python scripts/type_coverage.py <project_path> |

何时使用

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅当任务明确匹配上述描述的范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来要求澄清。