design-advisor — 方案分析与避坑指南

定位：编码前的"大脑"——帮助正确分析问题、设计方案、规避已知错误模式。 可被 dev-flow 步骤 3（制定方案）按需调用，也可独立使用。

全局输出规范（最高优先级）

本 Skill 生成的方案分析、样式诊断、反模式建议中，文件路径、代码位置引用必须遵循 ~/.codebuddy/rules/AI行为规范.mdc 的「文件/代码位置引用」规范（反引号包裹相对路径 `相对路径` + 空格后缀行号 L行号，IDE 自动识别为可点击链接）。

适用范围：方案设计中引用的代码文件、样式分析中的 SCSS/CSS 文件、反模式清单中引用的示例代码位置等所有输出。

路由规则

收到请求后，根据用户意图匹配下表，使用 read_file 加载对应子模块（相对于本 Skill 目录）：

加载策略

• 单一意图：只加载匹配的一个模块。
• 多模块场景：用户意图涉及多个模块时，按需依次加载。例如「帮我分析这个样式问题的方案」→ 先加载设计指南，再加载样式分析。
• 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，可直接触发：