📄 本页由源文件
skills/design-advisor/SKILL.md自动投影生成（单一权威源）。请勿直接编辑本页。
design-advisor
定位：编码前的"大脑"——帮助正确分析问题、设计方案、规避已知错误模式。 可被
dev-flow步骤 3（制定方案）按需调用，也可独立使用。
全局输出规范（最高优先级）
本 Skill 生成的方案分析、样式诊断、反模式建议中，文件路径、代码位置引用必须遵循
~/.codebuddy/rules/AI行为规范.mdc的「文件/代码位置引用」规范（反引号包裹相对路径`相对路径`+ 空格后缀行号L行号，IDE 自动识别为可点击链接）。适用范围：方案设计中引用的代码文件、样式分析中的 SCSS/CSS 文件、反模式清单中引用的示例代码位置等所有输出。
路由规则
收到请求后，根据用户意图匹配下表，使用 read_file 加载对应子模块（相对于本 Skill 目录）：
| 意图关键词 | 目标模块 | 加载指令 |
|---|---|---|
| 方案设计 / 评估方案 / 制定方案 / 分析问题 / 排查问题 / 定位根因 | 设计指南 | read_file("modules/design-guide.md") |
| 样式分析 / CSS调试 / 内联样式 / 主题系统 / scss | 样式分析 | read_file("modules/style-analysis.md") |
| 反模式 / 避坑 / 常见错误 / 踩坑 / 经验教训 / 反例 | 反模式清单 | read_file("modules/anti-patterns.md") |
加载策略
- 单一意图：只加载匹配的一个模块。
- 多模块场景：用户意图涉及多个模块时，按需依次加载。例如「帮我分析这个样式问题的方案」→ 先加载设计指南，再加载样式分析。
- dev-flow 调用时：dev-flow 步骤 3 会在
use_skill调用中指定路由目标（如「路由到 design-guide 模块」），直接执行对应的read_file加载。 - 不确定时：默认加载设计指南（design-guide），它是最通用的模块。
模块概览（仅供路由判断，不展开详情）
设计指南（design-guide）
方案设计的核心方法论：追根因、复用已有逻辑、隔离影响范围、对比参照、JS/CSS 断点分析、边界情况处理、问题排查原则、第三方库源码确认。
样式分析（style-analysis）
样式来源分析规范：CSS vs JS 内联样式识别、内联样式覆盖策略、.scss vs .module.scss 差异、主题系统、对比参照修复原则。
反模式清单（anti-patterns）
已发生过的 9 个错误模式及正确做法：反复调参、影响范围失控、自创等价逻辑、跳过根因分析、改动范围越界、误解用户指令、优化范围失控、JS/CSS 断点不一致、优化破坏 DOM 时序。
独立使用
不依赖 dev-flow，可直接触发：
| 用户说 | AI 行为 |
|---|---|
| "帮我分析下这个方案" | read_file 加载 design-guide 模块 |
| "这个样式为什么不对" | read_file 加载 style-analysis 模块 |
| "有没有什么反模式要注意" | read_file 加载 anti-patterns 模块 |
| "评估下这个修改方案" | read_file 加载 design-guide 模块 |
| "分析下这个样式问题的方案" | read_file 依次加载 design-guide + style-analysis |
| "帮我避坑" | read_file 加载 anti-patterns 模块 |