用途:把 Astro 项目的代码规范检查变成可重复的工具证据,并诚实区分通过、失败、无法验证与 planned。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现 npx --no-install eslint . 相关失败时。
主要能力:识别 .astro 工作区;执行 npx --no-install eslint . 并保留退出码、作用域与工具版本;区分格式、静态规则、配置、依赖和环境类失败;用 npx eslint . --fix 处理可逆问题并复扫;把 lint 结果与 CI、构建、测试证据分层汇报。
使用方式:先确认仓库根与作用域,读取 eslint.config.js、eslint.config.mjs、eslint.config.cjs、eslint.config.ts、.eslintrc.json、.eslintrc.js、.eslintrc.yml、.pre-commit-config.yaml 及 CI 实际命令;探测 npx --no-install eslint --version;只读运行 npx --no-install eslint .;失败分型后仅对可安全修复项执行 npx eslint . --fix;复跑同一 lint 命令,再运行项目已有测试与构建。输出按范围、工具、命令、状态、发现、修改、复验、未验证分层。
限制:工具缺失、版本不兼容或配置无法加载记为无法验证,不是通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore/调高阈值掩盖问题;formatter 通过不等于编译、测试或安全审计通过;不扫描生成与 vendor 目录除非仓库规则允许;自动修复前先检查 diff,破坏性修改需用户确认。本技能不收集、上传或存储用户代码与凭据,默认只读本地配置并运行本地工具。
适用场景:检查或修复 Astro 代码规范、AI 修改 .astro 后的提交前验证、CI lint 失败诊断、判断问题能否自动修复。不适用于语言语法学习、框架设计、业务建模、依赖漏洞与安全审计。
状态:stable(自 Codeguard V0.4);文件扩展名 .astro;无专用标记文件;工具准备 eslint-plugin-astro。