linting-neostandard-eslint9

linting-neostandard-eslint9 技能概览

linting-neostandard-eslint9 是一个面向 ESLint v9 flat config 和 neostandard 的实用设置与迁移技能。当前需要为 JavaScript 或 TypeScript 搭建类似 Standard 的基础规范、想从旧的 .eslintrc* 迁移出去，或者需要一条真正通过 eslint 执行的 eslint.config.js / eslint.config.mjs 路径时，就用 linting-neostandard-eslint9 skill。

这个技能最适合想把“lint 已经坏了或过时了”推进到“有一个可维护、能正常工作的配置”的开发者，而且尽量少做兼容性猜测。它尤其适合正在更换 lint 工具、引入 TypeScript，或者需要统一 CI 和编辑器行为的项目。

这个技能是做什么的

linting-neostandard-eslint9 的核心任务，是帮你选择并接好合适的 flat-config 基线，而不是从零发明一套自定义 lint 策略。它提供的是面向 eslint@9、neostandard 和仓库级覆盖规则的现代化配置路径，更贴近真实项目的落地方式。

什么时候最适合用

如果你属于下面这些场景，就很适合用它：

• 用 ESLint v9 启动新的 JS 或 TS 仓库
• 从 standard 迁移到 neostandard
• 用 flat config 替换旧式 ESLint RC 配置
• 对齐本地 lint、CI 和 pre-commit hooks
• 排查 flat config 或规则组合为什么表现异常

最关键的区别是什么

它的关键区别在于：neostandard 被当作共享的 ESLint flat config，而不是一个独立的 linter。也就是说，这个技能关注的是实际执行链路：安装 eslint，生成或编写 eslint.config.*，然后运行 eslint .。这个区别非常重要，因为很多接入问题，都是把 neostandard 误以为才是实际执行的命令导致的。

如何使用 linting-neostandard-eslint9 技能

安装并确认执行模型

当你的仓库需要一个干净的 ESLint v9 基线时，使用 linting-neostandard-eslint9 install 流程：

npm install --save-dev eslint neostandard

然后确认你的工作流跑的是 ESLint，而不是旧包装器：

npx eslint .

如果你是从空项目开始，先创建 eslint.config.js 或 eslint.config.mjs，并在添加覆盖规则之前，保持配置放在根目录且尽量简单。

把目标转成有用的提示词

linting-neostandard-eslint9 usage 在你提供明确约束时效果最好，而不是只说“帮我配一下 lint”。更有价值的信息包括：

• 包管理器：npm、pnpm、yarn 或 bun
• 语言组合：纯 JS、纯 TS，或两者都有
• 配置偏好：eslint.config.js 还是 eslint.config.mjs
• 迁移来源：.eslintrc、standard，或当前还没有 lint
• 编辑器/CI 需求：VS Code、GitHub Actions、pre-commit，或三者都要

更强的提示词示例：
“请为一个使用 pnpm 的 TypeScript monorepo 配置 linting-neostandard-eslint9。我们现在用的是 .eslintrc，想改成 flat config，只需要 CI 做 lint，希望支持 VS Code 保存时自动修复。”

先读对文件

对这个技能来说，最快的路径是先看这些文件：

1. SKILL.md，了解核心设置模型
2. rules/eslint-v9-flat-config.md，了解 flat config 结构
3. rules/neostandard.md，了解选项和执行细节
4. 如果你在转换现有仓库，查看 rules/migration-from-legacy-eslint.md 或 rules/migration-from-standard.md
5. 如果你需要自动化或编辑器行为，再看 rules/ci-and-editor-integration.md

这些文件会告诉你：哪些地方是技能的明确意见，哪些地方需要根据你的项目做适配。

放到真实仓库流程里使用

一个可靠的 linting-neostandard-eslint9 guide 顺序通常是：

• 安装依赖
• 生成或手写 eslint.config.*
• 运行 npx eslint .
• 在加 CI 强制之前先修好规则差异
• 添加 lint 和 lint:fix 脚本
• 最后再接 pre-commit 或编辑器自动修复

如果你在迁移，先把配置改动控制得小一些。先验证行为是否一致，再引入无关的格式化、测试或 CI 调整。

linting-neostandard-eslint9 技能常见问答

linting-neostandard-eslint9 只适合新项目吗？

不是。它对已有仓库往往更有价值，因为迁移才是大多数接入摩擦的来源。如果你正从 standard、旧版 ESLint RC 文件，或者一个已经不再符合 ESLint v9 的混合配置切换过来，这个技能就很合适。

我已经懂 ESLint 了，还需要 neostandard 吗？

不一定需要，但如果你想在 ESLint v9 flat config 之上获得一个类似 Standard 的默认方案，neostandard 可以减少决策成本。如果你需要高度定制的规则，那么手写 flat config 可能比这个技能的基线路径更合适。

这比直接写一个给 AI 编辑器的提示词更好吗？

通常是的，尤其当你在意正确性和可重复性时。linting-neostandard-eslint9 skill 提供了已知的安装与配置路径，还有迁移指导和集成细节。普通提示词经常会漏掉 eslint 和 neostandard 的执行模型、flat-config 结构，或者 CI/编辑器边界。

什么时候不该用这个技能？

如果你的项目属于下面这些情况，就可以跳过：

• 已经确定不会用 ESLint 的 lint 栈
• 采用高度定制、而且并不接近 neostandard 的公司级 lint 标准
• 已经稳定运行在 flat config 上，没有迁移需求
• 以 formatter 优先的工作流为主，lint 规则本来就刻意保持最少

如何改进 linting-neostandard-eslint9 技能

给出仓库的准确形态

提升效果最大的做法，是明确说明仓库里有哪些文件、哪些文件必须被 lint。告诉它你需要 *.js、*.mjs、*.cjs、*.ts、*.mts 还是 *.cts，以及测试、脚本或配置文件是否也要包含在内。这样可以避免 files 和 ignores 选项过宽或遗漏。

先说清楚你的取舍优先级

最有用的 linting-neostandard-eslint9 skill 输出，通常都来自清晰的优先级：

• “尽量保持最小配置”
• “不要分号”
• “不要加样式类规则，格式化交给 Prettier”
• “TypeScript import 要正确支持”
• “不要加入会立刻破坏现有 CI 的规则”

这些约束会帮助技能在基础 neostandard 默认值、ts: true、分号模式以及定向覆盖规则之间做选择。

注意常见失败模式

最常见的错误，是把旧式配置和 flat config 混着用，误以为 neostandard 才是要运行的命令，以及在没有关闭冲突的基础 JS 规则时就直接加 TS 规则。另一个常见问题，是想一次性迁移配置、CI 和规则语义。更稳妥的做法是一次只改一层，验证通过后再继续。

从第一次 lint 结果开始迭代

把第一次 npx eslint . 的输出当作反馈，而不是最终结论。如果结果太吵，就把具体报错和当前的 eslint.config.* 发出来；如果结果太宽松，就列出你原本希望覆盖的规则或文件类型。想得到更好的第二轮建议，请附上当前配置、失败路径，以及这个仓库应更像 Standard 还是更像自定义 ESLint policy。