用途:对 TypeScript / JavaScript 项目执行并诊断代码规范门禁,把“看起来没问题”转为可重复的工具证据,并诚实区分通过、失败、无法验证与 planned;不替代编译、测试或安全审计。识别 .ts、.tsx、.js、.jsx、.mjs、.cjs 及 package.json、deno.json 等工作区标记。
主要能力:执行只读 lint 并保留退出码、作用域与工具版本;将失败分为格式、静态规则、配置、环境、工具内部错误;用 npx eslint . --fix 处理可逆格式问题后复扫;把 lint、format、compile、test、security 证据分层汇报。
用法:在仓库或模块根先探测 npx --no-install eslint --version;再运行 npx --no-install eslint . --max-warnings 0;修复优先 npx eslint . --fix,随后复跑同一命令并运行项目已有测试与构建。标准流程包括确定真实作用域、读取项目契约(如 eslint.config.js 等)、探测版本、只读检查、失败分型、受控修复、验证闭环。输出模板含范围、工具、命令、状态、发现、修改、复验、未验证。
适用场景:用户要求检查或修复 TS/JS 规范、AI 修改代码后提交前验证、CI 出现上述 lint 失败、判断问题能否自动修复。
限制与要求:工具须已安装且版本兼容,需在正确根目录执行,以已提交配置为准;不静默安装、不升级依赖、不改团队规则、不用 ignore 或调高阈值掩盖问题;工具缺失或配置缺失须标 UNVERIFIED。不用于语言学习、框架设计、业务建模、依赖漏洞与安全审计;本地通过不等于 CI 会通过。该技能不收集上传代码或凭据,默认只读本地并本地运行工具;自动修复前先检查 diff,破坏性或大范围修改需用户确认。