workleap-chromatic-best-practices

用途：为仓库提供 Chromatic 配置的审计与修复流程，目标是控制快照成本并优化 CI。执行时按顺序：1) 定位配置，检查 chromatic.config.json、.storybook/preview.ts[x]、.github/workflows 中相关 yml 及 package.json 脚本；若不存在配置，询问用户是否要设置。2) 逐项审计并修复十项检查：untraced 配置（可选，需权衡成本与回归）、preview 桶导入是否禁用 TurboSnap、清理本地 Chromatic 脚本、CI 基于 label 触发、CI 必需标志（onlyChanged、exitOnceUploaded、autoAcceptChanges）、checkout 的 fetch-depth: 0 及 Chromatic 环境变量、浏览器配置（仅 Chrome）、Renovate/Changesets 排除 bot 分支、预览大依赖标记（>20 导出或 >500 行）、工作流并发与标签自动移除。3) 生成通过/失败与处理动作的审计报告表。重要规则：只使用有文档记录的 Chromatic 选项，避免未文档化标志破坏 TurboSnap；仅从 CI 运行，本地运行会触发完整视觉测试并浪费月度快照预算；始终保留 TurboSnap 的有效性，每条建议都应考虑快照成本。详细检查流程、代码示例、检测模式、修复动作与报告模板参见 references/audit-checks.md，TurboSnap 保留规则、快照成本乘数、CI 触发策略与 monorepo 专项检查参见 references/background.md。限制：资料未提供具体价格、免费额度、平台要求或版本兼容信息。