feat(repo): 整理 Qoder Skills 和 MCP 配置到仓库
- 添加 5 个用户级别 Skills: - auto-commit: 自动 Git 提交 - karpathy-guidelines: 编码规范指南 - opencli-websearch: 多源网络搜索 - pdf-reader: PDF 内容提取 - repo-analyzer: 项目深度分析 - 添加 Playwright MCP 配置 (21 个浏览器自动化工具) - 创建完整的 README.md 文档说明
This commit is contained in:
189
README.md
Normal file
189
README.md
Normal file
@@ -0,0 +1,189 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user