---

name: sapcli-skill version: 1.0.1 description: | 管理 SAP 系统和 ABAP 开发。创建程序、类、表，执行 RFC 函数，管理传输请求。 当用户提到 SAP、ABAP、程序开发、CDS、RAP、传输请求、SAP 连接配置时使用此 skill。 支持通过 sapcli 工具管理 SAP 系统的完整开发生命周期。 author: miki license: MIT

SAP CLI Skill

管理 SAP 系统和 ABAP 开发的 AI Agent 工具集。

快速开始

1. 初始化环境: 运行 sap初始化 或说 "初始化 SAP 环境"
2. 验证连接: python scripts/validate.py
3. 开始使用: 参考 skills/ 目录下的子 skills

功能模块

模块	子 skills	主要功能
ADT 核心对象	6	program, class, interface, functiongroup, functionmodule, include
ADT 数据字典	6	table, structure, dataelement, ddl, dcl, bdef
ADT 传输部署	5	package, cts, checkout, checkin, activation
ADT 测试质量	2	aunit, atc
ADT 高级功能	6	abapgit, rap, badi, featuretoggle, datapreview, adt
RFC 工具	3	startrfc, strust, user
REST/OData	3	gcts, bsp, flp

总计: 31 个工具，详见 references/tools-overview.md

环境配置

详见 references/environment-setup.md

必需环境变量

• SAP_ASHOST: SAP 服务器地址
• SAP_CLIENT: 客户端编号 (3位数字)
• SAP_USER: 用户名
• SAP_PASSWORD: 密码

可选环境变量

• SAP_SYSNR: 系统编号 (默认: 00)
• SAP_PORT: HTTP 端口 (默认: 8000)
• SAP_SSL: 是否使用 SSL (默认: no)
• SAP_LANGUAGE: 登录语言 (默认: zh)
• SAPNWRFC_HOME: RFC SDK 路径 (RFC 功能需要)

SAP 环境初始化

当用户说 "sap初始化"、"初始化 SAP 环境"、"配置 SAP 连接" 时执行：

流程

1. 检测现有环境: 在 skill 目录下查找 .env.* 文件
2. 收集配置: 使用 AskUserQuestion 一次性收集：
   • 环境名称 (默认: erp-dev)
   • SAP_ASHOST (服务器地址)
   • SAP_CLIENT (客户端)
   • SAP_USER (用户名)
   • SAP_PASSWORD (密码)
3. 创建配置文件: 写入 skill 目录下的 .env.{env_name}
4. 验证连接: 运行 python scripts/validate.py -e {env_name}

多环境支持

配置文件位于 skill 目录（.claude/skills/sapcli-skill/）下：

• .env.erp-dev - ERP 开发环境
• .env.erp-test - ERP 测试环境
• .env.erp-prod - ERP 生产环境

常用操作

创建程序

sapcli program create ZPROGRAM --package $TMP
sapcli program write ZPROGRAM ./code.abap --activate

读取类代码

sapcli class read ZCL_TEST --type main

执行 RFC 函数

sapcli startrfc BAPI_USER_GET_DETAIL --param USER_NAME=DEVELOPER

管理传输请求

sapcli cts list
sapcli cts create --description "新功能开发"

Windows 使用注意事项

编码问题

Windows 控制台默认使用 GBK 编码，必须设置 PYTHONIOENCODING=utf-8 以避免中文乱码。

运行 sapcli

sapcli 通过 Python 直接运行，需要设置 PYTHONPATH 和环境变量：

# 设置环境变量
PYTHONIOENCODING=utf-8
PYTHONPATH=/path/to/sapcli-skill/tools/sapcli
SAP_ASHOST=YourSapHost
SAP_CLIENT=112
SAP_USER=YourUsername
SAP_PASSWORD=YourPassword
SAP_PORT=8000
SAP_SSL=no

# 运行 sapcli
python /path/to/sapcli-skill/tools/sapcli/bin/sapcli program read ZSDR136

环境配置文件

配置文件位于 skill 目录下 .claude/skills/sapcli-skill/.env.erp-dev：

SAP_ASHOST=YourSapHost
SAP_CLIENT=112
SAP_USER=YourUsername
SAP_PASSWORD=YourPassword
SAP_PORT=8000
SAP_SSL=no

故障排除

详见 references/troubleshooting.md

常见问题

问题	解决方案
连接失败	检查 SAP_ASHOST、SAP_PORT、网络连通性
认证失败	检查 SAP_USER、SAP_PASSWORD、SAP_CLIENT
RFC 不可用	检查 SAPNWRFC_HOME 是否正确设置
激活失败	检查语法错误，使用 atc run 检查代码

目录结构

sapcli-skill/
├── SKILL.md              # 本文件
├── references/           # 详细文档
│   ├── getting-started.md
│   ├── environment-setup.md
│   ├── tools-overview.md
│   └── troubleshooting.md
├── skills/               # 31 个子 skills
│   ├── adt-core/
│   ├── adt-ddic/
│   ├── adt-transport/
│   ├── adt-test/
│   ├── adt-advanced/
│   ├── rfc/
│   ├── rest/
│   └── odata/
├── agents/
│   └── sapcli-init-agent.md
├── scripts/
│   ├── validate.py
│   └── generate_skills.py
├── evals/
│   └── evals.json
└── tools/
    ├── sapcli/
    └── sapSdk/

相关文档

• 快速开始: references/getting-started.md
• 环境配置: references/environment-setup.md
• 工具参考: references/tools-overview.md
• 故障排除: references/troubleshooting.md