让 AI 每次代码提交前强制执行代码校验与 Lint 检查

解决 AI 编写代码时容易忽视语法错误或类型不匹配的问题:通过强制执行“变更-校验-修复”循环,确保 AI 在宣布任务完成前,代码必须通过所有 Lint 和类型检查。

为什么需要这个技能

AI 在生成代码时可能会出现细微的语法错误、不符合项目规范的风格问题,或者在 TypeScript 等强类型语言中引入类型不匹配。如果直接提交这些代码,会导致构建失败或在运行时出现低级错误。

通过给 AI 注入此技能,可以将“代码校验”从一个可选步骤变为一个强制性的闭环流程。AI 不再仅仅是“写完代码”,而是需要通过运行具体的工具(如 ESLint, Ruff, MyPy)来证明代码的正确性,从而极大提升交付质量。

适用场景

  • AI 代理(Agent)在独立完成功能开发并准备提交代码时。
  • 需要在多种编程语言(Node.js, Python 等)环境下维护统一的代码质量标准时。
  • 避免 AI 产生“幻觉”导致调用了不存在的 API 或使用了错误的类型定义时。

核心工作流

AI 将遵循以下质量循环:编写/编辑代码 运行审计 分析报告 修复并重复

1. 针对不同生态执行校验

  • Node.js / TypeScript
    • 运行 Lint 并修复:npm run lintnpx eslint "path" --fix
    • 类型检查:npx tsc --noEmit
    • 安全审计:npm audit --audit-level=high
  • Python
    • 快速 Lint 检查:ruff check "path" --fix
    • 安全分析:bandit -r "path" -ll
    • 类型检查:mypy "path"

2. 错误处理机制

  • 如果 lint 失败:立即修复样式或语法问题。
  • 如果 tscmypy 失败:在继续下一步前必须修正类型不匹配。
  • 如果项目缺少配置:AI 应检查根目录是否存在 .eslintrctsconfig.jsonpyproject.toml,并建议创建相应配置。

3. 最终验收

只有在所有校验工具均通过且无报错的情况下,AI 才能将任务标记为“Done”。

下载和安装

下载 lint-and-validate 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md

你可能还需要

暂无推荐