让 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 lint或npx eslint "path" --fix - 类型检查:
npx tsc --noEmit - 安全审计:
npm audit --audit-level=high
- 运行 Lint 并修复:
- Python:
- 快速 Lint 检查:
ruff check "path" --fix - 安全分析:
bandit -r "path" -ll - 类型检查:
mypy "path"
- 快速 Lint 检查:
2. 错误处理机制
- 如果
lint失败:立即修复样式或语法问题。 - 如果
tsc或mypy失败:在继续下一步前必须修正类型不匹配。 - 如果项目缺少配置:AI 应检查根目录是否存在
.eslintrc、tsconfig.json或pyproject.toml,并建议创建相应配置。
3. 最终验收
只有在所有校验工具均通过且无报错的情况下,AI 才能将任务标记为“Done”。
下载和安装
下载 lint-and-validate 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。
你可能还需要
暂无推荐