1
0
Files
DiAL/openspec/specs/eslint-prettier-integration/spec.md
lanyuanxiaoyao ad87be6956 refactor: 精简 package.json scripts,引入 eslint-plugin-prettier 统一格式检查
删除 start/build:web/format:check,简化 check 为 typecheck+lint+test

引入 eslint-plugin-prettier 将 Prettier 集成至 ESLint,统一质量检查入口

简化 lint-staged 配置,扩展 clean 清理范围至 dist/
2026-05-12 21:43:20 +08:00

1.4 KiB

Purpose

定义 ESLint 与 Prettier 集成方案,通过 eslint-plugin-prettier 将 Prettier 格式检查统一纳入 ESLint 工作流,减少独立工具调用,提升开发体验。

Requirements

Requirement: ESLint 集成 Prettier 格式检查

项目 SHALL 通过 eslint-plugin-prettier 将 Prettier 格式规则集成为 ESLint 规则,使单次 eslint . 运行同时报告代码质量问题和格式问题。ESLint 配置 SHALL 注册 plugin:prettier/recommended 规则集,该规则集自动加载 Prettier 配置并禁用与 Prettier 冲突的 ESLint 规则。

Scenario: lint 运行同时检查格式

  • WHEN 开发者运行 bun run lint
  • THEN ESLint SHALL 同时报告代码质量违规和 Prettier 格式违规

Scenario: lint --fix 自动格式化

  • WHEN 开发者运行 eslint --fix 或 lint-staged 自动触发 eslint --fix
  • THEN ESLint SHALL 对可自动修复的代码质量问题和格式问题一并修正,包括调用 Prettier 重写文件格式

Scenario: Prettier 配置被正确读取

  • WHEN ESLint 通过 eslint-plugin-prettier 检查代码格式
  • THEN 检查结果 SHALL 与独立运行 prettier --check 的结果完全一致

Scenario: 不因集成降低 lint 性能

  • WHEN 开发者运行 bun run lint
  • THEN 运行时间 SHOULD 不超过原 eslint . + prettier --check 总耗时的 120%