用途:style-fix 用于最小范围修正样式写法,只处理 CSS、Tailwind、CSS Module、Ant Design 覆盖、className 和主题 token,不重构业务逻辑、不重新设计 UI、不顺手做类型治理。
主要能力:按“输入→识别范围→只读审查→分级→修改必须修复项→最小验证→汇报”流程工作。支持按目录/文件、功能名、Git 暂存区或无范围输入定位;功能名会经模块文档、路由配置和关键词搜索定位。修复项包括 Tailwind v3 写法、v4 canonical class、可无损替换的 arbitrary value、已有 token 却用裸值、写死固定色、CSS Module 命名、无边界 Ant Design 覆盖等。
使用方式:先读 AGENTS.md、样式入口、Tailwind 版本与 lint 配置,只使用已确认存在的 token/utility。暂存区模式用 git status --short 和 git diff --cached --name-only --diff-filter=ACMR,重新暂存用 git add <具体文件>,不使用 git add -A 或 git add .。验证用 git diff --check -- <文件>,TS/TSX 改动运行项目已有 lint 或类型检查,不确定时建议 npm run lint 和 npm run check-types。
适用场景:修复样式报错、Missing comma、选择器解析、@apply、Tailwind v4 canonical class、主题 token 替换、Ant Design 槽位覆盖等。
限制:不改业务行为、请求、权限或状态;不擅自新增局部 ConfigProvider;不为少量样式新增包装组件;不扩大到全仓库迁移;不新增全局 token 或全局 Ant Design 覆盖,除非已有规范无法表达且用户明确同意;不替换图标、不改交互、不把透明/渐变/玻璃态扁平化为实色。Ant Design 槽位需查当前安装版本类型定义或源码,不同版本以本地为准。