内容
# algo-coach
交互式算法练习教练 Skill，基于[代码随想录](https://programmercarl.com/)的题库和学习路线。
通过 MCP 服务提供出题、代码测试、解法讲解和实际工程应用场景，适用于算法学习、LeetCode 刷题和面试准备。
## 功能
- **主题学习路线** — 12 个主题（数组、链表、哈希表、二叉树、动态规划等），按推荐顺序进阶
- **理论回顾** — 每个主题配有核心概念和基础知识讲解
- **随机出题** — 按主题和难度筛选，含题目描述、约束、示例和多语言函数签名
- **代码测试** — 提交代码后自动运行测试用例，即时反馈通过/失败
- **渐进提示** — 4 级提示系统（方向 → 思路 → 伪代码 → 完整解法），避免直接给答案
- **解法讲解** — 最优解代码 + 复杂度分析 + 关键思路 + 与用户解法的对比
- **工程应用** — 每道题关联 1-2 个真实生产系统案例（Redis、PostgreSQL 等）
- **三种模式** — 学生模式（引导教学）、面试模式（限时挑战）、工程模式（系统设计关联）
- **多语言支持** — Python / Java / C++ / Go / JavaScript / TypeScript
## 安装
### Claude Code
```bash
claude skill install algo-coach.skill
```
或手动安装 MCP 服务：
```bash
claude mcp add --transport stdio algo-coach -- npx -y algo-coach-mcp@latest
```
### Cursor
在项目根目录创建 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"algo-coach": {
"command": "npx",
"args": ["-y", "algo-coach-mcp@latest"]
}
}
}
```
### VS Code（GitHub Copilot）
在项目根目录创建 `.vscode/mcp.json`：
```json
{
"servers": {
"algo-coach": {
"type": "stdio",
"command": "npx",
"args": ["-y", "algo-coach-mcp@latest"]
}
}
}
```
### 其他 MCP 兼容工具
将以下配置添加到工具的 MCP 配置文件中：
```json
{
"mcpServers": {
"algo-coach": {
"type": "stdio",
"command": "npx",
"args": ["-y", "algo-coach-mcp@latest"]
}
}
}
```
## 使用
安装后重启编辑器或会话，然后对 AI 说：
> 来道哈希表的题
或使用任意触发词：`练习算法`、`刷题`、`algo coach`、`算法教练`、`来道题`
### 练习过程中的指令
| 指令 | 效果 |
|------|------|
| 提示 / hint | 获取下一级提示 |
| 答案 / solution | 直接查看解法 |
| 下一题 / next | 进入下一题 |
| 应用 / cases | 查看工程应用案例 |
| 理论 / theory | 回顾主题基础知识 |
| 跳过 / skip | 跳过当前题目 |
| 换语言 / lang | 切换编程语言 |
## 项目结构
```
algo-coach/
SKILL.md # Skill 定义（主文件）
references/
mcp-tools.md # MCP 工具 API 参考
algo-coach.skill # 可分发的 Skill 安装包
```
## MCP 服务
本 Skill 依赖 [algo-coach-mcp](https://www.npmjs.com/package/algo-coach-mcp) 提供以下工具：
| 工具 | 功能 |
|------|------|
| `get_topic_roadmap` | 获取主题学习路线 |
| `get_theory` | 获取主题理论基础 |
| `pick_problem` | 随机选题 |
| `generate_test_cases` | 生成测试用例 |
| `run_user_code` | 执行用户代码并验证 |
| `get_solution` | 获取参考解法 |
| `get_real_world_cases` | 获取工程应用案例 |
即使 MCP 服务不可用，Skill 也能降级运行 — AI 会基于自身知识补全出题、测试和讲解。
## License
MIT
