用途:扫描项目样式表,生成或更新样式参考文档,记录 BEM 用法、SCSS 架构、mixin/变量清单、主题模式、响应式断点与设计令牌约定。
主要能力:依据文件特征判定样式方案(SCSS/Sass、Less、CSS Modules、Tailwind、CSS-in-JS,或混合);识别 BEM 采用程度与分隔符风格;清点变量、mixin、函数、断点、颜色、z-index、动画约定;处理主题与组件作用域样式。
使用方式:分阶段执行。阶段 0 先检测样式方案与文档模式;阶段 1 建立任务跟踪;阶段 2 启动两个并行子代理,分别负责架构与变量、BEM 与主题,结论按类别增量写入报告文件并给出 file:line 证据;阶段 3 依据报告生成目标章节;阶段 4 写入并在顶部标注最后扫描日期,仅做局部更新,保留原有手工注释。
规则与限制:仅记录声明而非使用处,变量值、mixin 签名与断点必须来自实际声明;置信度低于 60% 省略,60%–80% 标注为未验证;先读取已有文档,只更新发生分歧的章节,不做整篇重写;不输出计数、目录树与 TOC;先读 docs/project-reference/scss-styling-guide.md 与 docs/project-config.json,在 Codex 中以 $skill-name 调用。具体命令、配置字段与报告路径已在资料中列出,未提供的实现细节暂未提供。