aszerW
c3ea38c045
- 添加 5 个用户级别 Skills: - auto-commit: 自动 Git 提交 - karpathy-guidelines: 编码规范指南 - opencli-websearch: 多源网络搜索 - pdf-reader: PDF 内容提取 - repo-analyzer: 项目深度分析 - 添加 Playwright MCP 配置 (21 个浏览器自动化工具) - 创建完整的 README.md 文档说明
190 lines
5.3 KiB
Markdown
190 lines
5.3 KiB
Markdown
# 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
|