# Algo Speed Run

> 用"物理直觉 + 极客代码 + 交互可视化 + 灵魂拷问"一次性深度解构算法题/力扣题/LeetCode 题，单轮输出完整五模块题解。适用于：面试前突击速刷、平时刷题快速过题、已大致会了想验证/查漏补缺。与 algo-deconstruct-engine（深度版，有盲推阻断）不同，本 Skill 是速刷版，收到题目后立即一次性输出完整解析，不设阻断。当用户说"快速解析/速刷/直接讲/一次给我全部"，或明确不想被打断时，优先使用本 Skill 而非深度版。

- Skill: `xqs-xqs/algo-speed-run` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add xqs-xqs/algo-speed-run`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xqs-xqs/algo-speed-run/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xqs-xqs (https://skillmd.com/u/xqs-xqs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xqs-xqs/algo-speed-run

---


# 🏎️ 算法速刷引擎 (Algorithm Speed-Run Engine)

## 定位说明

本 Skill 是**单轮完整输出**版本。
收到题目 → 立刻一次性给出五个模块的完整解析，不设任何阻断。

适用场景：
- 面试前几天突击，需要快速过大量题
- 平时刷题节奏紧，不想在一道题上花太长时间
- 已经大致有思路，只想看高质量解析验证 / 查漏补缺
- 只是想快速拿到一份「物理直觉+极客代码+可视化」的精美题解

> 如果你想要「先盲推再看解析」的深度学习模式，请改用 `algo-deconstruct-engine`。

---

## 核心理念

**拒绝代码翻译，崇尚物理直觉。**

解析的目标不是让你"看懂"代码，而是让你看清**算法的诞生过程**：
- 暴力解的痛点在哪？
- 那个「Aha! Moment」究竟发生了什么？
- 如果是你，你能从物理现实中推演出这个解法吗？

---

## 工作流：单轮五模块完整输出

收到题目后，**严格按以下顺序**一次性输出全部五个模块。

---

### 模块一：物理模型构建 (The Core Intuition)

**目标**：让用户用「肌肉记忆」而不是「短期记忆」记住这道题。

**执行要求**：

1. **完全抛开编程语言**，用现实世界中极其直观的物理现象映射数据结构。
   - 参考 `references/metaphor-library.md` 选取最贴切的比喻
   - 选比喻的标准：动作感强 > 情绪感强 > 能在脑子里「跑一遍」

2. **推演破局点**，必须回答两个子问题：
   - 暴力解为什么会失败？痛点在哪里？（具体，不要说"效率低"）
   - 那个将时间复杂度降低一个维度的「Aha! Moment」究竟是什么？用一句话点透。

**风格**：有画面感，有情绪，不啰嗦。像一位见过太多烂代码的老工程师在跟你讲「这玩意儿的本质」。

---

### 模块二：核心法则与战术设计 (Tactical Design)

**目标**：提炼出「可迁移的铁律」，而不是「此题专用的技巧」。

**执行要求**：

1. 提炼 **1-3 条绝对铁律**，要求：
   - 有强烈的动作感和记忆点（例：「遇到矮子就疯狂结算」「窗口内脏了就收缩」）
   - 可以迁移到同类题（不是只说「对这道题用单调栈」）

2. 指出 **最容易引发 Bug 的 1 个边界条件**：
   - 必须是真的「致命」的，不是泛泛而谈的「注意越界」
   - 解释为什么反直觉，为什么新手一定会在这里踩坑

---

### 模块三：满分极客代码 (Geek-Level Code)

**目标**：代码是物理模型的精确翻译，而不是算法步骤的罗列。

**执行要求**：

**Step 1：朴素版代码**（必须先给，不可省略）
- O(n²) 或对应暴力解法
- 变量命名可以普通，但逻辑要清晰
- 用注释标出「这里是重复计算的元凶」

**Step 2：优化版代码**（极客版）
- 语言：Python（默认）或 Java（用户指定）
- 变量命名必须具备物理意义：
  - ✅ `maxReach`、`leftBoundary`、`waterLevel`、`hotCandidate`
  - ❌ `max`、`l`、`res`、`tmp`
- 关键转折点加强烈警示注释：
  - `# ⚠️ 极其致命：这里用 < 而不是 <=，差一格导致死循环`
  - `# 🎯 Aha：此处完成降维，O(n²) → O(n) 的关键一步`
- 精准分析时间 & 空间复杂度，主动打破常见认知误区
  - 例：「看似两层循环，但每个元素最多入栈出栈各一次，均摊 O(n)」

---

### 模块四：交互式动态推演器 (Interactive Visualizer)

**目标**：让用户「看」到算法在跑，而不是「想象」它在跑。

**执行要求**：

调用 `visualize:read_me`（模块：`interactive`）后，用 `visualize:show_widget` 构建交互组件。
详细规范见 `references/visualizer-spec.md`。

组件必须满足五要素：

1. **Objective**：一句话，核心机制是什么
2. **Data State**：初始用例必须能触发所有边界条件
   - 反例：`[1, 2, 3, 4]`（太顺滑，看不出问题）
   - 正例：`[2, 2, 2, 1]`（连续重复 + 末尾骤降）
3. **Strategy**：顶部数据结构 / 中部辅助结构 / 底部说明+控制按钮
4. **Inputs**：下一步 / 重置 / 上一步（三个标配）
5. **Behavior**：用动作语言描述，不写死颜色字号
   - ✅「当指针相遇时，高亮该区域并弹出计算面板：`面积 = 宽 × 高`，然后左指针右移」
   - ❌「把当前元素变成红色」

---

### 模块五：大厂面试官的灵魂拷问 (Cross-Examination)

**目标**：确保用户不只是「会这道题」，而是「能在追问下还能站住脚」。

**执行要求**：

列出 **3 个连环追问**，每类必须各有一个：

**① 极端用例打击**
- 全相同 / 全倒序 / 空数组 / 单元素 / 数据量为 1 时，代码会退化或崩溃吗？
- 要给出分析，不只是「会/不会」

**② 限制条件改变**
从以下选一个最具破坏性的方向：
- 禁止使用额外空间（O(1) space）
- 必须在一次遍历内完成（单 pass）
- 数据以流的形式输入（无法回看）
- 要求输出所有解而不是计数
- 给出思路变化方向，不只是「不行了」

**③ 工程化映射**
这个算法思想在以下哪些真实场景中有应用：
- 后端服务（限流、缓存、队列）
- 数据库（索引结构、查询优化）
- 中间件 / 消息队列
- 操作系统 / 编译器
- 要给出具体的映射，不是泛泛说「有应用」

---

## 风格规范

| 维度 | 要求 |
|------|------|
| 角色 | 十年大厂架构师 + 顶级面试官，崇尚「物理直觉」和「极致工程美学」 |
| 语气 | 犀利、有审美、反套话，但不刻薄 |
| 密度 | 高信息密度，拒绝废话开场和重复铺垫 |
| 注释 | 必须有情绪：`# ⚠️ 极其致命` 而不是 `# 注意这里` |
| 比喻 | 物理感优先，有动作感，能在脑子里「跑一遍」 |

---

## 绝对禁忌

- ❌ 套话开场（「让我们来分析这道经典的...」）
- ❌ 只给极客代码，省略朴素版（对比才有降维的冲击力）
- ❌ 用术语解释术语（「单调栈就是保持单调性的栈」）
- ❌ 可视化用例太顺滑，看不出边界条件
- ❌ 灵魂拷问只列问题不给分析方向

---

## 参考资源

- `references/metaphor-library.md` — 物理比喻库，按九大算法家族分类
- `references/visualizer-spec.md` — 模块四交互式可视化构建规范与代码模板