OO

omnisockit/open-wecom-skills

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

35 stars 7 forks 质量 70 趋势 12Apache-2.0

让你的 AI 大模型成为企业微信开发专家 - 1 MCP ·41 技能 ·550+ API ·三大开发模式全覆盖 —— 让你的 AI 模型成为 WeCom 开发专家 - 1 MCP ·41 技能 ·550+ API ·三大主要开发的全面覆盖......

概览

41项技能 ·550+ API ·三大开发模式全覆盖 ·MCP 一行命令接入 Open WeCom Skills 是一套面向 AI 大模型的**,源于 源雀 团队**的实战经验结晶。 - 🎯 — 每个接口的参数、响应、限制都有结构化文档,杜绝 AI 幻觉 - 🛡️ — 内置 Gotcha Guide,提炼真实项目中的实战经验,让 AI 主动避坑 - ⚡ — Python / TypeScript / Go / Java / PHP 五语言模板,可直接生成项目代码 兼容所有主流 AI 工具:Claude Desktop / Claude Code / Cursor / Windsurf / VS Code + Copilot / Trae / Antigravity / Cline / Roo Code / Kilo Code / Continue, Cherry Studio / Zed / OpenAI Codex CLI 等。 1. 阅读 wecom-core.md 搭建鉴权基座 2.根据业务选择需要的 SKILL 模块 3.复制代码模板到项目中 4.对照 Code Review 清单做检查 💡 第三方应用的凭证体系复用 ISV SKILL,业务 API 复用企业内部开发 SKILL。 Open WeCom Skills 可配合以下 AI 工具使用(推荐通过 MCP 接入): 💡 你可以通过 npm pack @omnisockit/mcp-server 下载包后检查全部源码,验证以上承诺。

概述(AI 翻译)

让你的 AI 大模型成为企业微信开发专家

41项技能 ·550+ API ·三大开发模式全覆盖 ·MCP 一行命令接入

英文 |简体中文


✨ 这是什么

Open WeCom Skills 是一套面向 AI 大模型的企业微信开发结构化知识体系,源于 源雀 团队六年深耕企微生态、服务 500+ 企业的实战经验结晶。

它不是官方文档的搬运,而是一套为 AI 深度优化的知识工程:

  • 🎯 精确 API 知识 — 每个接口的参数、响应、限制都有结构化文档,杜绝 AI 幻觉
  • 🛡️ 踩坑指南 — 内置 Gotcha Guide,提炼真实项目中的实战经验,让 AI 主动避坑
  • ⚡ 即用代码模板 — Python / TypeScript / Go / Java / PHP 五语言模板,可直接生成项目代码

💡 源雀开源生态项目 — 本项目中的每一个踩坑指南、参数约束、边界条件,都来自 源雀 SCRM 的一线开发实践,经过大量生产环境验证。 了解源雀 SCRM ·查看开源

有 SKILL vs 没有 SKILL

没有 技能 有 技能
❌ AI 凭记忆编造 API ✅ AI 精确查阅接口定义
❌ 遗漏 WelcomeCode 20 秒时限 ✅ 主动提醒关键限制
❌ 搞混 follow_user vs follow_info ✅ 参数语义完全准确
❌ 不知道 linkedcorp 全 POST ✅ 知道每个踩坑点

🚀 快速开始

方式一:通过 MCP Server(推荐) ⚡

在你的 AI 工具中添加一行配置,即可让 AI 精通企微全部 API:

零克隆、零配置、AI 按需读取 SKILL — 查看各工具详细配置

兼容所有主流 AI 工具:Claude Desktop / Claude Code / Cursor / Windsurf / VS Code + Copilot / Trae / Antigravity / Cline / Roo Code / Kilo Code / Continue, Cherry Studio / Zed / OpenAI Codex CLI 等。

方式二:手动注入 AI 上下文

将 skills/ 目录注册到你的 AI 工具:

克劳德密码/法典

光标

其他 AI 助手 — 将 skills/ 目录添加到 AI 工具的知识库或上下文中即可。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。


✨ 这是什么

Open WeCom Skills 是一套面向 AI 大模型的企业微信开发结构化知识体系,源于 源雀 团队六年深耕企微生态、服务 500+ 企业的实战经验结晶。

它不是官方文档的搬运,而是一套为 AI 深度优化的知识工程:

  • 🎯 精确 API 知识 — 每个接口的参数、响应、限制都有结构化文档,杜绝 AI 幻觉
  • 🛡️ 踩坑指南 — 内置 Gotcha Guide,提炼真实项目中的实战经验,让 AI 主动避坑
  • ⚡ 即用代码模板 — Python / TypeScript / Go / Java / PHP 五语言模板,可直接生成项目代码

💡 源雀开源生态项目 — 本项目中的每一个踩坑指南、参数约束、边界条件,都来自 源雀 SCRM 的一线开发实践,经过大量生产环境验证。 了解源雀 SCRM · 查看开源

有 SKILL vs 没有 SKILL

没有 SKILL 有 SKILL
❌ AI 凭记忆编造 API ✅ AI 精确查阅接口定义
❌ 遗漏 WelcomeCode 20 秒时限 ✅ 主动提醒关键限制
❌ 搞混 follow_user vs follow_info ✅ 参数语义完全准确
❌ 不知道 linkedcorp 全 POST ✅ 知道每个踩坑点

🚀 快速开始

方式一:通过 MCP Server(推荐) ⚡

在你的 AI 工具中添加一行配置,即可让 AI 精通企微全部 API:

{
  "mcpServers": {
    "omnisockit": {
      "command": "npx",
      "args": ["@omnisockit/mcp-server"]
    }
  }
}

零克隆、零配置、AI 按需读取 SKILL — 查看各工具详细配置

兼容所有主流 AI 工具:Claude Desktop / Claude Code / Cursor / Windsurf / VS Code + Copilot / Trae / Antigravity / Cline / Roo Code / Kilo Code / Continue / Cherry Studio / Zed / OpenAI Codex CLI 等。

方式二:手动注入 AI 上下文

将 skills/ 目录注册到你的 AI 工具:

Claude Code / Codex

# 将 SKILL 复制到项目的 skills 目录
cp -r skills/ your-project/.claude/skills/

# 或创建符号链接
ln -s /path/to/open-wecom-skills/skills your-project/.claude/skills

Cursor

# 在 .cursorrules 中引用
echo "参考 skills/ 目录中的企业微信 SKILL 文档" >> .cursorrules

其他 AI 助手 — 将 skills/ 目录添加到 AI 工具的知识库或上下文中即可。

方式三:作为开发者参考文档

# 克隆仓库
git clone https://github.com/OmniSocKit/Open-Wecom-Skills.git

# 查看 SKILL 分类
ls skills/             # enterprise/ isv/ third-party/
ls skills/enterprise/  # 企业内部开发 30 个
ls skills/isv/         # 服务商代开发 8 个
ls skills/third-party/ # 第三方应用 3 个

# 阅读核心 SKILL(建议第一个读)
cat skills/enterprise/wecom-core.md

方式四:作为项目脚手架

每个 SKILL 都提供代码模板,可直接复制到项目中:

  1. 阅读 wecom-core.md 搭建鉴权基座
  2. 根据业务选择需要的 SKILL 模块
  3. 复制代码模板到项目中
  4. 对照 Code Review 清单做检查

Skills 清单

📁 企业内部开发 (skills/enterprise/) — 30 SKILL

基础域 (7)

SKILL 说明 API 行数
wecom-core 认证基座 · access_token · 回调验签 · 频率限制 5 901
wecom-contact 通讯录管理 · 成员/部门/标签 CRUD · 异步导入 35 1262
wecom-app 应用管理 · 菜单 · 工作台 · 自建机器人 20 1452
wecom-message 消息管理 · 模板卡片 · 群聊 · 撤回 25 1958
在 GitHub 查看完整 README

安装

npx @omnisockit/mcp-server
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "omnisockit": { "command": "npx", "args": ["@omnisockit/mcp-server"] } } }