Kingdee K3cloud Skill

Kingdee K3Cloud ERP Skill

[English](README.en.md) | [中文](README.md)

[](https://github.com/adamzhang1987/kingdee-k3cloud-skill/actions/workflows/ci.yml) [](LICENSE) [](https://github.com/adamzhang1987/kingdee-k3cloud-skill/releases/latest)

面向支持 Skill 机制的 AI Agent（Claude Code、Openclaw 等）的金蝶云星空 ERP Skill，把「哪个表单用哪个字段、怎么查最省 token」这类踩坑经验直接注入 Agent，大幅减少字段猜测导致的 500 错误和试错往返。

**核心价值：**

• 减少试错：内置各模块已验证字段名（references/verified-fields.md），避免因猜字段名触发金蝶 500 错误
• 封装你自己的二开知识：每家金蝶部署都有不同的自定义字段（F_ 前缀）和业务流程——references/customization-guide.md 教 Agent 用 query_metadata 自动发现你的实际字段结构，并沉淀成可复用的知识，而不是写死某一家公司的字段
• 完整工作流：经营日报、客户查询、销售/库存分析、订单追踪等场景的最优查询路径已预置好

**只用纯 MCP 客户端（Claude Desktop、Cursor、Cline、Cherry Studio 等不支持 Skill 机制）？** 直接配置 [kingdee-k3cloud-mcp](https://github.com/adamzhang1987/kingdee-k3cloud-mcp) 也能用全部 15 个工具——本 Skill 是可选增强，不是前提条件；但少了它，Agent 需要自己反复试错才能摸清字段名。

前提条件

本 Skill 需配合金蝶云星空 MCP Server 使用，推荐 [kingdee-k3cloud-mcp](https://github.com/adamzhang1987/kingdee-k3cloud-mcp)。

**整体架构：**

支持 Skill 的 Agent（安装本 Skill）
       │ 知识注入（表单ID、字段名、工作流）
       ↓
Agent + MCP 工具（query_bill_json、view_bill 等）
       │ Kingdee Web API
       ↓
金蝶云星空 K3Cloud

MCP Server 本身兼容所有支持 MCP 协议的客户端（Claude Desktop、Cursor、Cline、Openclaw 等）。本 Skill 面向支持 Skill 机制的 AI Agent（Claude Code、openclaw、hermes 等），为其提供额外的领域知识注入。

• Skill（本项目） = 知识库 + 工作流决策树，让 Agent 自动掌握正确的 API 用法，避免字段名错误
• MCP Server = 执行引擎，提供 15 个实际的 API 工具，适用于所有 MCP 客户端

两者可分别使用，但在支持 Skill 的 Agent 中组合使用效果最佳。

安装方式

方式一：手动安装（推荐）

1. 前往 Releases 页面，下载 kingdee-k3cloud.skill
2. 将文件放入你的 Agent 的 skills 目录（如 Claude Code 通常为 ~/.claude/skills/）
3. 重启 Agent 使 skill 生效

🚧 方式二：从 Skill Hub