为支持 Skill 机制的 AI Agent（Claude Code、openclaw、hermes 等）注入金蝶云星空的表单字段、查询模式和工作流知识，大幅减少试错次数。配合 kingdee-k3cloud-mcp 使用效果最佳。
Gives any Skill-capable AI agent (Claude Code, openclaw, hermes, etc.) the form fields, query patterns, and workflow knowledge it needs to use Kingdee K3Cloud correctly — pairs best with kingdee-k3cloud-mcp.
整体架构
Architecture
Skill（本项目） = 知识库 + 工作流决策树，让 Agent 自动掌握正确的 API 用法，避免字段名错误。MCP Server = 执行引擎，提供 15 个实际的 API 工具，适用于所有 MCP 客户端。两者可分别使用，但在支持 Skill 机制的 Agent（Claude Code、openclaw、hermes 等）中组合使用效果最佳。
Skill (this project) = knowledge base + workflow decision trees, so the agent picks the right API usage automatically. MCP Server = the execution engine with 15 real API tools, usable from any MCP client. Best combined inside a Skill-capable agent (Claude Code, openclaw, hermes, etc.).
安装方式
Installation
前往 Releases 页面下载 kingdee-k3cloud.skill，放入你的 Agent 的 skills 目录（Claude Code 为 ~/.claude/skills/），重启生效。
Download kingdee-k3cloud.skill from the latest release, drop it in your agent's skills directory (Claude Code uses ~/.claude/skills/), then restart.
待 Anthropic Skill Hub 正式上架后，可在支持的客户端中搜索 kingdee 一键安装。
Once Anthropic's Skill Hub launches, search kingdee in a supporting client for one-click install.
克隆仓库后运行 make build 打包，将生成的 .skill 文件复制到 skills 目录。
Clone the repo, run make build to package, then copy the resulting .skill file into your skills directory.
# 从源码安装Build from source
git clone https://github.com/adamzhang1987/kingdee-k3cloud-skill.git
cd kingdee-k3cloud-skill
make build
cp kingdee-k3cloud.skill ~/.claude/skills/
覆盖场景
Coverage
销售订单、采购订单、库存、物料、客户、供应商。
Sales orders, purchase orders, inventory, materials, customers, suppliers.
标准 5 步查询流程，最优 token 路径。
A standardized 5-step query flow optimized for token usage.
客户查询、生日筛选、类别/专员映射。
Customer lookups, birthday filters, category/rep mappings.
创建、提交、审核、反审核、下推。
Create, submit, audit, unaudit, push.
字段名验证、500 错误处理、数据量控制。
Field-name verification, 500-error handling, result-size control.
销售分析、库存分析、订单追踪、周期性报表。
Sales analysis, inventory analysis, order tracking, periodic reports.
设计理念
Design Philosophy
主文件保持精简（<300 行），详细的字段验证表、查询模板、错误处理等放在 references/ 中按需引用。
The main file stays lean (<300 lines); detailed field tables, query templates, and error handling live in references/ and load on demand.
| 层级 | Level | 内容 | Content | 加载时机 | Loaded When |
|---|---|---|---|---|---|
| Level 1 | Skill name + description | Skill name + description | 始终在上下文中 | Always in context | |
| Level 2 | SKILL.md（140 行） | SKILL.md (140 lines) | Skill 触发时加载 | Loaded when the skill triggers | |
| Level 3 | references/ 详细文档 | references/ detail docs | 按需加载 | Loaded on demand |
目录结构
Directory Structure