代码检查与验证

问题

Agent 改完代码就标记「已完成」，但仓库里往往还留着 ESLint 报错、TypeScript 类型不匹配，或 Python 侧未跑 Ruff/Bandit。这类遗漏会在 CI 或 review 里才暴露，成本更高。

技能如何工作

技能把每次代码变更后的验证写成硬性规则：在工具报告无错误之前，不得结束任务或宣称完成。

Node.js / TypeScript 典型顺序：

• Lint / 修复： 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 失败先修类型。资料中还提到统一入口脚本 scripts/lint_runner.py 与类型覆盖率分析 scripts/type_coverage.py，适合在已有脚本的项目里接入同一套流程。

边界与注意

• 未配置工具时，应检查项目根是否存在 .eslintrc、tsconfig.json、pyproject.toml 等，并建议补齐配置，而不是跳过检查。
• 技能描述的是多生态通用流程；具体用哪条命令以当前仓库的 package 脚本与约定为准。
• 严格规则： 未通过这些检查的代码不得提交或报告为「已完成」。