# Qoder 配置仓库

本仓库整理了 Qoder IDE 的 Skills 和 MCP (Model Context Protocol) 配置。

## 📁 目录结构

```
qoder-config/
├── skills/                 # Skills 配置
│   ├── karpathy-guidelines/    # Karpathy 编码规范指南
│   └── repo-analyzer/          # 项目深度分析技能
└── mcps/                   # MCP 服务器配置
    └── playwright/             # Playwright 浏览器自动化
```

## 🛠️ Skills

### 1. auto-commit

**描述**: 自动将更改提交到 Git，并生成描述性消息。

**使用场景**:
- 代码、文档、测试结果或实验结果发生变更时
- 用户提到"保存"、"记录"、"追踪"、"commit"、"提交"时
- 需要保持修改历史记录时

**核心功能**:
- 自动检测文件变更
- 生成符合规范的 Git 提交消息（遵循 Conventional Commits）
- 支持多种提交类型：feat, fix, docs, test, refactor, chore, experiment
- 原子化提交，一个逻辑变更一次提交

### 2. karpathy-guidelines

**描述**: 基于 Andrej Karpathy 观察的编码行为准则，减少常见 LLM 编码错误。

**使用场景**:
- 编写、审查或重构代码时
- 避免过度复杂化
- 进行精确的代码修改
- 明确假设条件
- 定义可验证的成功标准

**核心原则**:
1. **编码前先思考** - 明确假设，不要隐藏困惑
2. **简洁优先** - 最少代码解决问题，不写投机性代码
3. **精确修改** - 只修改必须的部分
4. **目标驱动** - 定义成功标准，循环验证

### 3. opencli-websearch

**描述**: 使用 Qoder WebSearch 和 OpenCLI 同时进行多源网络搜索，合并结果并提供全面的信息检索。

**使用场景**:
- 搜索信息、研究话题
- 获取多源数据
- 学术论文检索
- 技术问题查询
- 中文社区内容搜索

**支持的数据源**:
- **学术源**: arxiv
- **技术源**: stackoverflow, hackernews
- **中文社交**: zhihu, xiaohongshu（需浏览器）
- **新闻源**: 36kr, bbc, reuters
- **通用源**: google（需浏览器）

**核心特性**:
- 并行搜索架构，同时调用多个数据源
- 智能结果去重和排序
- 支持深度内容获取（下载完整网页为 Markdown）
- 临时数据管理和存储

### 4. pdf-reader

**描述**: 使用 pymupdf4llm 从 PDF 文件中提取文本和表格，并转换为 Markdown 格式。

**使用场景**:
- 处理 PDF 文件
- 从 PDF 中提取内容
- 将 PDF 转换为文本或 Markdown
- 阅读或处理 PDF 文档

**核心功能**:
- 自动提取文本、表格和基本格式
- 保留文档结构（Markdown 格式）
- 处理多栏布局和复杂格式
- 支持指定页面范围提取
- 批量处理多个 PDF 文件

**依赖**:
```bash
pip install pymupdf4llm
```

### 5. repo-analyzer

**描述**: 深度分析开源项目并生成专业架构报告。

**使用场景**:
- 分析开源项目的架构和设计
- 对比两个同类项目的设计差异
- 深入研究框架或库的实现思路

**核心特性**:
- 业务视角优先，从"解决什么问题"出发
- 抽象层次把控，讲设计而非贴代码
- 全局关联，连接项目整体设计哲学
- 启发性写作，让读者学到东西
- 深度洞察，解释 Why > What

**分析工作流**:
1. 项目获取与初始化
2. 项目规模评估与分析模式选择
3. 外部调研 + 项目文档研读
4. 项目特征识别 + 自适应提问
5. 动态报告结构设计
6. 并行深度分析（subagent 团队）
7. 交叉验证 + 质量管控
8. 多源融合与最终报告

## 🔌 MCP (Model Context Protocol)

### 1. playwright

**描述**: Playwright 浏览器自动化工具集，提供 21 个浏览器交互工具。

**工具列表**:
- `browser_navigate` - 导航到 URL
- `browser_click` - 点击页面元素
- `browser_type` - 输入文本
- `browser_fill_form` - 填写表单
- `browser_select_option` - 选择选项
- `browser_hover` - 悬停元素
- `browser_press_key` - 按键
- `browser_drag` - 拖拽元素
- `browser_take_screenshot` - 截图
- `browser_snapshot` - 获取页面快照
- `browser_evaluate` - 执行 JavaScript
- `browser_run_code` - 运行代码
- `browser_tabs` - 标签页管理
- `browser_navigate_back` - 后退
- `browser_wait_for` - 等待条件
- `browser_console_messages` - 获取控制台消息
- `browser_network_requests` - 获取网络请求
- `browser_handle_dialog` - 处理对话框
- `browser_resize` - 调整窗口大小
- `browser_file_upload` - 上传文件
- `browser_close` - 关闭浏览器

**使用场景**:
- 网页自动化测试
- 网页数据抓取
- UI 交互验证
- 浏览器行为分析

## 📝 使用说明

### 安装 Skills

将 `skills/` 目录下的 skill 复制到 Qoder 的 skills 目录：

```bash
# macOS/Linux
cp -r skills/* ~/Library/Application\ Support/Qoder/User/skills/

# Windows
xcopy /E /I skills\* %USERPROFILE%\AppData\Roaming\Qoder\User\skills\
```

### 配置 MCP

MCP 配置通常需要添加到 Qoder 的 MCP 配置文件中。参考每个 MCP 服务器目录下的 `SERVER_METADATA.json` 和 `tools/` 目录中的工具定义。

## 📊 统计信息

- **Skills 数量**: 5
- **MCP 服务器数量**: 1
- **MCP 工具总数**: 21

## 📄 许可证

各 Skills 和 MCP 可能使用不同的许可证，请参阅各自目录下的 LICENSE 文件。

- `karpathy-guidelines`: MIT License

---

**最后更新**: 2026-04-18