Agent 技能包（一键装上 AI 助手）

装上这个技能包后，你的 AI 助手（WorkBuddy / OpenClaw / Cursor / Claude Desktop / Cline / Dify 等）就自动学会了操作知新平台——查作业、批改、发通知、出题、分析学情，一共 24 个能力。

为什么需要技能包？

光给 AI 助手一个 API Key，它只是”能调”但”不会用”。技能包里带了一份 SKILL.md，告诉模型：

有哪 24 个工具，各自能做什么
教师常问的 10 个场景应该用哪些工具组合
怎么处理重名学生、日期格式、权限错误等坑
写操作（批改、发通知、延期）执行前要先确认

技能包 = Key（通行证） + SKILL.md（说明书） + 配置模板（即插即用）。

下载

📦 zxyun-teaching-skill.zip

含 SKILL.md、README、4 份客户端配置模板（~8 KB）

下载 ZIP

也可以单独查看：

SKILL.md — 给 AI 模型看的操作手册
README.md — 给教师看的安装指引
configs/workbuddy.json · openclaw.json · cursor.json · claude-desktop.json · cline.json

先决条件

你是知新平台的教师
已在教师端 → API Key 页面创建并保存了一把 Key（zxk_live_ 开头）

没创建过？看 API Key 与外部智能体接入先创建一把。

安装步骤

每个客户端两步：① 填 MCP 配置 ②把 SKILL.md 贴成系统指令。

WorkBuddy（推荐，国产）

设置 → MCP 服务器 → 添加，粘贴 configs/workbuddy.json 内容，把 YOUR_API_KEY 替换成你的 Key
新建对话/助手时，把 SKILL.md 内容贴到”助手指令”或”背景”


{
  "mcpServers": {
    "zxyun-teaching": {
      "url": "https://tea.z-xin.net/api/mcp/server/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

OpenClaw

设置 → MCP / 外部工具 → 添加服务，粘贴 configs/openclaw.json 内容，替换 YOUR_API_KEY
在助手的系统指令里贴入 SKILL.md


{
  "mcpServers": {
    "zxyun-teaching": {
      "url": "https://tea.z-xin.net/api/mcp/server/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Cursor

编辑 ~/.cursor/mcp.json，合并 configs/cursor.json
在项目根目录新建 .cursorrules 文件，粘贴 SKILL.md 内容（或 Settings → Rules for AI）

Claude Desktop

Claude Desktop 只支持 stdio，需要通过 mcp-remote 桥接（Node.js 18+）：


{
  "mcpServers": {
    "zxyun-teaching": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tea.z-xin.net/api/mcp/server/mcp",
        "--header",
        "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

放到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。

若默认 Node 版本低（如 v12），把 command 改为完整路径：/Users/xxx/.nvm/versions/node/v18.20.3/bin/npx。改完完全退出 Claude（Cmd+Q）再重启。

Cline / Roo Code（VS Code 扩展）

扩展设置 → MCP Servers，粘贴 configs/cline.json；SKILL.md 贴到 Custom Instructions。

Dify / Coze / n8n 等（HTTP 协议）

这些平台不原生支持 MCP，用 REST 接口：

Base URL：https://tea.z-xin.net/api/mcp/v1
Method：POST
Auth：Bearer Token = 你的 API Key
工具清单：GET https://tea.z-xin.net/api/mcp/v1

把 SKILL.md 贴到智能体的 System Prompt。

试试它学会了没

装完之后，随便问你的 AI 助手几个问题看它能不能搞定：

“帮我看看数据结构这门课班级学情”
“张三这次作业做得怎么样”
“这次作业哪些学生还没交，给他们发个催交提醒”
“给张三那次作业再延 3 天”
“我这门课学生掌握最差的 5 个知识点”
“最近 3 天要截止的作业”

如果它能一两步完成而不是反复问你要 id，说明装对了。

隐私与安全

API Key 只绑定你的教师身份，别人拿到也只能访问你的数据
不要把 Key 提交到公开仓库；一旦泄露，在管理页”撤销”再重建
所有写操作（发作业、批改、延期、删题、发通知）立即生效，让 AI 助手执行前先口头确认

反馈

技能包会随平台新能力持续更新。有问题或建议请通过帮助文档右上角的反馈入口提交。