Agent Skills
返回列表
💻

Prettier 配置协调器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/prettier-config-harmonizer-2。

技能介绍

解决多包仓库的格式冲突

在 Monorepo 架构中,不同子包往往由于历史原因或团队迭代,维护着各自独立的 Prettier 配置。这种割裂状态会导致代码提交时频繁触发格式化冲突,甚至让 CI 流水线因缩进、引号或尾逗号的差异而意外失败。手动合并这些分散的 .prettierrc 文件不仅繁琐,还极易引入隐性的风格不一致,增加代码审查的认知负担。

工作机制与核心步骤

该技能利用 Prettier 内置 API 及 @prettier/plugin-xml,将格式协调过程自动化。其核心工作流分为三步:

  • 配置解析与提取:深度扫描 Monorepo 目录,读取各子包现有的格式化规则与 XML 插件配置。
  • 规则合并与降级:生成统一的 .prettierrc 基础配置,同时通过 overrides 字段为特定包保留差异化的格式策略。
  • 编辑器环境同步:自动重写 .editorconfig,确保开发者本地 IDE 的缩进、换行符行为与统一后的 Prettier 规则无缝对齐。

适用边界与注意事项

由于当前技能包未提供完善的自动化安装与执行脚本,其使用存在一定门槛。在将其接入核心 CI/CD 流水线或处理敏感代码库前,务必先审查上游项目的源码实现。建议在本地分支进行充分的灰度测试,验证生成的配置文件是否与团队的代码审查标准完全契合,避免自动化工具意外覆盖人工定制的复杂规则。

使用场景

  • 维护多包仓库时各子项目格式规则冲突,需要合并生成统一的 .prettierrc 基础配置。
  • 不同子包存在差异化的格式要求,需要为特定模块编写 Prettier 的 overrides 覆盖规则。
  • 团队本地编辑器缩进与提交格式不一致,需要同步更新 .editorconfig 对齐 Prettier 规则。
  • 项目包含大量 XML 配置文件且格式混乱,需要使用 @prettier/plugin-xml 统一代码风格。

适合人员

  • 前端架构师,希望统一团队内部多仓库或多包项目的代码风格规范。
  • DevOps 工程师,需要在 CI 流水线中修复因格式化规则冲突导致的构建阻断。
  • 开源项目维护者,需要为包含复杂子模块和特殊文件格式的项目制定代码贡献规范。