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/

openspec/specs/code-quality-gates/spec.md

@@ -36,22 +36,23 @@
 - **THEN** 系统 MUST 排除 `dist/`、`.build/`、`node_modules/`、`openspec/`、`.opencode/`、`.claude/`、`.codex/`、`*.bun-build`、`bun.lock`、`data/` 等非源码目录
 
 ### Requirement: Prettier 代码格式门禁
-项目 SHALL 提供 Prettier 格式化和格式检查命令，用于统一代码风格。Prettier 配置 SHALL 显式声明 `printWidth`、`semi`、`singleQuote`、`trailingComma`、`bracketSpacing`、`arrowParens`、`endOfLine`、`tabWidth`、`useTabs` 全部格式化参数。
+
+项目 SHALL 通过 `eslint-plugin-prettier` 将 Prettier 格式检查集成为 ESLint 规则，使 `lint` 命令同时覆盖代码质量和格式检查（原独立的 `format:check` 命令不再存在，格式检查统一通过 `lint` 完成）。项目仍保留独立的 `format` 命令（`prettier --write`）用于快速格式化。Prettier 配置 SHALL 显式声明 `printWidth`、`semi`、`singleQuote`、`trailingComma`、`bracketSpacing`、`arrowParens`、`endOfLine`、`tabWidth`、`useTabs` 全部格式化参数。
 
 #### Scenario: 检查代码格式
-- **WHEN** 开发者运行文档化的格式检查命令
-- **THEN** 系统 SHALL 使用 Prettier 检查受管理文件，并在发现未格式化文件时以非零状态退出
+- **WHEN** 开发者运行 `bun run lint`
+- **THEN** ESLint SHALL 通过 eslint-plugin-prettier 检查受管理文件格式，并在发现未格式化文件时以非零状态退出
 
 #### Scenario: 自动格式化代码
-- **WHEN** 开发者运行文档化的格式化命令
+- **WHEN** 开发者运行 `bun run format` 或 `eslint --fix`
 - **THEN** 系统 SHALL 使用 Prettier 重写受管理文件的格式
 
 #### Scenario: 排除 OpenSpec 文档和生成产物
-- **WHEN** Prettier 格式化或格式检查运行
+- **WHEN** Prettier 格式化或格式检查运行（通过 ESLint 或独立 Prettier 命令）
 - **THEN** 系统 MUST 排除 `openspec/`、`dist/`、`.build/`、`node_modules/`、`bun.lock`、`skills-lock.json`、`.agents/`、`data/`、`*.bun-build`、`.opencode/`、`.claude/`、`.codex/` 和临时构建产物
 
 #### Scenario: 格式化配置一致性
-- **WHEN** 不同开发者在不同操作系统上运行 `prettier --write`
+- **WHEN** 不同开发者在不同操作系统上运行格式化（通过 ESLint 或独立 Prettier）
 - **THEN** 由于所有格式化参数均显式定义，产物 SHALL 完全一致
 
 ### Requirement: TypeScript 未使用变量检测
@@ -95,11 +96,12 @@
 - **THEN** lint 命令 MUST 报告 `import/no-cycle` 警告
 
 ### Requirement: 快速检查命令
+
 项目 SHALL 提供快速 `check` 命令，用于日常开发期间验证代码质量和基础行为。
 
 #### Scenario: 运行快速检查
 - **WHEN** 开发者运行 `bun run check`
-- **THEN** 系统 SHALL 依次执行类型检查、lint、格式检查和单元测试
+- **THEN** 系统 SHALL 依次执行类型检查、lint（含格式检查）和单元测试
 
 #### Scenario: 快速检查失败
 - **WHEN** `check` 中任一子检查失败

openspec/specs/commit-quality-gates/spec.md

@@ -5,18 +5,19 @@
 ## Requirements
 
 ### Requirement: pre-commit 自动质量检查
-项目 SHALL 通过 husky 和 lint-staged 在 git commit 前自动对变更文件运行 ESLint 和 Prettier 检查。
+
+项目 SHALL 通过 husky 和 lint-staged 在 git commit 前自动对变更文件运行 ESLint（含 Prettier 格式）检查。由于 eslint-plugin-prettier 已集成格式检查，lint-staged SHALL 仅运行 `eslint --fix` 即可同时修复代码质量和格式问题。
 
 #### Scenario: 变更 TypeScript 文件后提交
 - **WHEN** 开发者 stage 了 `.ts` 或 `.tsx` 文件并执行 `git commit`
-- **THEN** lint-staged SHALL 自动对变更文件运行 `eslint --fix` 和 `prettier --write`，修复后继续提交
+- **THEN** lint-staged SHALL 自动对变更文件运行 `eslint --fix`（含格式修复），修复后继续提交
 
 #### Scenario: 变更 Markdown 或 JSON 文件后提交
 - **WHEN** 开发者 stage 了 `.md`、`.json`、`.yaml` 或 `.yml` 文件并执行 `git commit`
 - **THEN** lint-staged SHALL 自动对变更文件运行 `prettier --write`
 
 #### Scenario: lint 检查失败阻止提交
-- **WHEN** 变更文件存在无法自动修复的 ESLint 错误
+- **WHEN** 变更文件存在无法自动修复的 ESLint 错误（含格式错误）
 - **THEN** pre-commit hook MUST 以非零状态退出，阻止提交
 
 #### Scenario: 无变更文件提交

openspec/specs/eslint-prettier-integration/spec.md

@@ -0,0 +1,25 @@
+## 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%