aszer/qoder-config
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f571b205983c0a5314a9dd33d4535f311711debe
qoder-config/README.md
aszerW c3ea38c045 feat(repo): 整理 Qoder Skills 和 MCP 配置到仓库 
- 添加 5 个用户级别 Skills:
  - auto-commit: 自动 Git 提交
  - karpathy-guidelines: 编码规范指南
  - opencli-websearch: 多源网络搜索
  - pdf-reader: PDF 内容提取
  - repo-analyzer: 项目深度分析

- 添加 Playwright MCP 配置 (21 个浏览器自动化工具)
- 创建完整的 README.md 文档说明
2026-04-18 11:17:41 +08:00

5.3 KiB
Raw Blame History

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 文件

依赖:

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 目录：

# 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