<div align="center">
<h3>실제로 운영하는 SAP ABAP 환경을 위한 거버넌스 기반 AI 배포</h3>
<h4><i>결정론적 CLI로서의 ADT 기능 · 포터블한 Skill로서의 배포 시나리오 · 모든 변경 사항은 바인딩되고(bound), 검증되며(verified) 추적 가능함</i></h4>
AI 에이전트는 이미 ABAP 코드를 작성할 수 있습니다. 하지만 이를 실제 SAP 시스템에 안전하게 전달하는 것은 별개의 문제입니다: 잠금(locks) 및 상태 유지 세션(stateful sessions), 트랜스포트(transports), 릴리스 게이트(release gates), 감사 증적(audit evidence), 그리고 여전히 대부분 ECC 및 온프레미스 S/4HANA인 환경이 존재합니다. 이 프로젝트는 ADT REST API를 거버넌스가 적용된 명령줄 계약(governed command-line contract)으로 변환하고, 그 위에 SKILL.md 워크플로우를 계층화합니다 — 코드 검토(code review), 트랜스포트 게이트(transport gate), 진단(diagnosis), 통합 노하우(integration know-how) 등입니다. 이를 통해 Claude Code, Codex, WorkBuddy 및 모든 Skill을 인식하는 에이전트가 기업이 기대하는 통제 하에 SAP 배포에 참여할 수 있게 합니다.
ADT REST API · 코드 검토 · 트랜스포트 게이트 · 통합 지식 · 증적 우선(Evidence-First)
MIT · 자체 호스팅(Self-hosted) · ECC 6.0 & S/4HANA
<h4>오프라인 검토는 SAP 없이 작동하지만, 실시간 운영에는 CLI와 연결이 필요함</h4>
License
Python
SAP
Skills
Agents
English · 中文
이 프로젝트가 필요한 이유 · 할 수 있는 것 · 빠른 시작 · 사용 예시 · 작동 방식 · 지원 및 안전성 · 로드맵 · 문서화 · 라이선스
</div>
이 프로젝트가 필요한 이유
The ABAP 툴링 시장은 빠르게 변화하고 있습니다. SAP는 이제 VS Code용 ADT에 내장된 MCP 서버를 제공하며, 커뮤니티에서는 여러 ADT 기반의 MCP 서버를 제공합니다. 이들은 대부분 에이전트가 호출할 수 있는 도구의 개수를 기준으로 경쟁합니다. 본 프로젝트는 다른 축에서 경쟁합니다: 에이전트가 수행한 작업이 신뢰할 수 있고, 증명 가능하며, 승인(sign off) 받을 수 있는지 여부입니다.
<table>
<thead>
<tr>
<th></th>
<th>SAP ADT MCP (VS Code / Eclipse)</th>
<th>Community ADT MCP servers</th>
<th><strong>sap-engineering-skill</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>Primary focus</td>
<td>ABAP Cloud, RAP generation, clean core</td>
<td>에이전트를 위한 광범위한 도구 지원</td>
<td><strong>기존 환경에서의 거버넌스 기반 배포</strong></td>
</tr>
</tbody>
<sub style="font-size: 0.8em;">¹ SAP가 VS Code 및 해당 MCP 서버용 ADT에 대해 문서화한 내용 (2026년 기준). 사용 중인 버전에 대해서는 SAP의 최신 문서를 확인하십시오.</sub>
설계 원칙 (Design principles)
- 주장보다 증거 기반 (Evidence over assertion). HTTP 2xx 코드는 *수락됨(accepted)*을 의미할 뿐, *완료됨(done)*을 의미하지 않습니다. 쓰기 작업은 읽어와지며(read back), 활성화는 활성 버전과 비교되고, 잠금 해제(unlock), 배포(release) 및 활성화 결과는 각각
수락됨(accepted), 검증됨(verified), 실패함(failed) 또는 알 수 없음(unknown)으로 보고됩니다. 증거가 누락된 경우 가정에 의해 채워지지 않고 격차(gap)로 보고됩니다.
- 기본적으로 거버넌스 적용 (Governed by default). 프로필이 쓰기 기능을 부여하기 전까지는 읽기 전용입니다. 운영(production) 프로필은 모든 쓰기 클래스 작업(write-class operation)을 거부하며, 모든 변경 사항은 미리보기를 보여주고 확인을 요청합니다. 비밀번호는 설정 파일이나 채팅에 저장되지 않고 OS 키 저장소(OS keystore)에 보관됩니다.
- 바인딩된 의도 (Bound intent). 쓰기 작업은 대상 시스템(target system), 클라이언트, 사용자, 객체, 트랜스포트(transport), 원격 기준선(remote baseline) 및 업로드 해시와 바인딩됩니다. 검토 단계와 실행 단계 사이에 어떠한 이탈이 발생하면 아무것도 기록되지 않습니다. 자동화(
--yes)는 프롬프트를 건너뛸 뿐, 검사 과정 자체를 생략하지 않습니다. (CLI 1.6.2+.)
- 결정론적 계약, 포터블 오케스트레이션 (Deterministic contract, portable orchestration). CLI는 에이전트에게 안정적인 JSON 엔벨로프(JSON envelope), 폐쇄된 오류 코드 세트(closed error-code set) 및 계층화된 종료 코드(tiered exit codes)를 제공합니다. 시나리오는 일반
SKILL.md 폴더에 존재하여 벤더 종속성(vendor lock-in)이 없고, 토큰 오버헤드가 낮으며, CI(Continuous Integration)에서 스크립팅이 가능합니다.
- 가정하지 않고 측정 (Measured, not assumed). SAP가 문서화하지 않은 ADT 동작 방식—예: 소유권 잠금(lock ownership), 무음 해제 작업(silent unlock no-ops), 활성화 응답 형식(activation reply formats)—은 실제 시스템에서 측정되고, 정제된 테스트 데이터(sanitized fixtures)와 함께 기록되며, 검증된 릴리스 버전과 레이블링됩니다. 검증되지 않은 내용은 그 사실 그대로 명시합니다.
설계 단계부터 상호 보완적입니다(Complementary by design). S/4HANA 2025+ 및 SAP BTP 환경에서, SAP 자체의 ADT 툴링이 가장 자연스러운 에디터입니다. 본 프로젝트는 기업들이 여전히 운영하는 환경과, 모든 에디터나 툴 서버 위에 존재하는 거버넌스 계층—게이트(gates), 증거(evidence), 승인(sign-off)—에 중점을 둡니다.
할 수 있는 작업 (What you can do)
| 작업 (Task) | 기술 (Skill) | SAP 연결 (SAP connection) |
|---|
| 배포 전 ABAP 코드 검토 | abap-code-review | 필요 없음 — 소스 코드를 제공합니다 |
| ... | | |
abap-code-review는 9가지 검토 차원(review dimensions)을 다루며, sap-transport-gate는 10가지를 다룹니다. 각 차원에 대한 검사, 지원되는 객체 유형 및 리포트 계약은 각 기술의 README 파일과 references/ 파일에 문서화되어 있으며, 본 페이지에서는 이를 반복하지 않습니다.
두 검토 기술 모두 심각도 순위가 매겨진 발견 사항(severity-ranked findings)과 명시적인 결정—코드 검토의 경우 GO / CONDITIONAL GO / NO-GO, 트랜스포트 게이트의 경우 GO / CONDITIONAL_GO / NO_GO / NEED_MORE_EVIDENCE—을 포함하는 Markdown 보고서를 생성합니다. 발견 사항은 출처가 된 코드 또는 자료를 인용합니다. 누락된 증거는 안전하다고 가정되는 것이 아니라 격차(gap)로 나열됩니다.
빠른 시작 (Quick start)
두 가지 독립적인 단계가 있습니다: 기술을 에이전트(agent)에 설치하고, — 라이브 SAP 접근이 필요한 경우에만 — CLI를 설치 및 구성합니다.
1. 기술 추가하기 (Add the skills)
Claude Code는 이 리포지토리의 플러그인 마켓플레이스에서 이를 설치합니다:
/plugin marketplace add shrek-abaper/sap-engineering-skill
/plugin install sap-engineering-skills@sap-engineering
이후 네 가지 기술은 sap-engineering-skills 네임스페이스 아래에 나타납니다(예: /sap-engineering-skills:sap-adt-cli). 업데이트는 /plugin → Manage를 통해 하거나, claude plugin update sap-engineering-skills@sap-engineering을 사용합니다. 이 플러그인은 기술 문서만 배포하며 CLI를 설치하지 않습니다. 이 플러그인 소스는 Claude Code ≥ 2.1.224가 필요합니다.
**다른 에이전트(Other agents)**는 일반적인 SKILL.md 폴더를 로드합니다: 스킬 폴더 전체—SKILL.md 파일만 포함하는 것이 아니라 참조까지 모두 포함하여—를 사용자의 에이전트가 스캔하는 디렉터리에 복사해야 합니다. 일부는 ~/.agents/skills/ 경로를 발견하고, 다른 일부는 자체 디렉터리나 가져오기(import) UI를 사용합니다. 문서화된 흐름은 docs/agents/generic-skills.md를 참조하고, 아래의 지원되는 에이전트 섹션을 참고하십시오.
2. CLI 설치 (실제 SAP 액세스 시에만)
sap-adt-cli는 모든 온라인 작업에 CLI가 필요하며, sap-transport-gate 역시 온라인 트랜스포트 수집을 위해 CLI가 필요합니다. 반면, abap-code-review와 sap-integration-wiki는 절대 필요하지 않습니다.
Node.js ≥ 18 사용 시 (이 채널에서는 Python 불필요):
pm install -g "sap-adt-cli@^1.5.0"
sap-adt install
sap-adt --version
이 npm 패키지는 런처(launcher)를 설치하며, sap-adt install은 플랫폼 런타임(platform runtime)을 가져오고(fetch), 검증하며(verify), 설치합니다. 일반적인 sap-adt 호출은 절대 다운로드하거나 업그레이드를 수행하지 않습니다. Linux x86_64 및 Windows x86_64 런타임이 사용 가능하며, Windows의 경우 CLI 1.5.3 이상이 필요합니다. CLI 1.6.0에는 Intel용과 Apple Silicon용 실험적인 macOS 15+ 런타임이 추가되었습니다.
Node.js나 Python 없이 Windows에서 사용하는 경우, 릴리스(releases)에서 서명되지 않은 sap-adt-<ver>-windows-x86_64-setup.exe 파일을 다운로드하십시오. 검증된 범위와 제한 사항은 Windows 가이드를 참조하십시오.
전역 설치(global install) 없이 사용하는 경우, npx는 아무것도 PATH에 남기지 않습니다: npx "sap-adt-cli@^1.5.0" install을 실행하고 이후 모든 호출에서 해당 패키지 접두사(package prefix)를 유지하십시오.
Python ≥ 3.10 사용 시, Node.js가 필요하지 않습니다:
pip install "sap-adt-cli>=1.5.0,<2.0.0"
sap-adt --version
그런 다음 시스템을 지정합니다:
sap-adt configure
sap-adt status
sap-adt credentials doctor
비밀번호를 명령줄(command line)에 전달하거나 채팅창에 붙여넣지 마십시오. 여러 환경을 사용할 경우 --profile dev|qas|prd를 사용하십시오. SAP_ADT_DOTENV로 선언된 환경 변수 또는 dotenv 파일이 CI/CD용 프로필을 덮어씁니다(override).
전체 채널 목록(Full channel list), 휴대용 리눅스 아카이브(portable Linux archive), 자격 증명 우선순위(credential precedence) 및 진단 매트릭스(diagnostics matrix): docs/installation/runtime-setup.md.
사용 예시 (Usage examples)
이들은 기록된 실행이 아닌 예시 요청입니다.
이미 가지고 있는 코드 검토 (SAP 연결 없음):
Review the ABAP report I'm pasting below for release. It reads VBAK/VBAP and
writes an ALV list. Flag security, authorization, performance and standards
issues, and tell me whether anything blocks release.
...
예상 출력: 심각도별로 그룹화된 발견 사항(findings), 각 항목에는 코드 발췌 부분(code excerpt), 위치(location), 인용 규칙 ID(cited rule ID) 및 수정 사항이 포함됩니다. 또한 서명 테이블과 함께 GO / CONDITIONAL GO / NO-GO 추천을 제공하며, 검토할 수 없었던 객체 또는 INCLUDE 목록도 제시합니다.
제공하는 자료를 기반으로 트랜스포트 요청 평가:
Assess transport DEVK900123 before import to QAS. I'm attaching the object list
and the source files; there is no functional spec and no test evidence.
예상 출력: 검토 범위(코드 품질만인지, 기능적 + 코드 품질인지)에 대한 질문, 명시적인 증거 수준(evidence level), 누락된 사양 및 테스트 증거에 대한 EVIDENCE_GAP 발견 사항, 그리고 낮은 증거로는 GO로 진행할 수 없다는 결정이 포함됩니다. 보고서는 Markdown 보고서와 JSON 요약으로 reports/DEVK900123_package/ 아래에 작성됩니다.
통합 질문하기:
How do I create a purchase order in S/4HANA from Python?
예상 출력: 사용자의 SAP 버전 및 시나리오에 대한 권장 기술(recommended technology), SAP 측 전제 조건(prerequisites), 작동하는 코드 스니펫이 포함된 구현 단계(implementation steps), 그리고 2~3가지 일반적인 함정(common pitfalls)입니다.
실패한 단위 테스트 실행 진단 (Unit run) (CLI 1.6.1 이상):
qas 환경에서 제공된 ZCL_EXAMPLE 단위 테스트 실패 진단. 반환되는 테스트 포함 위치를 읽고, 덤프 세부 정보는 이 실행에 기인하는 경우에만 사용하십시오. 코드를 변경하거나 재실행하지 않고 증거(evidence), 격차(gaps) 및 다음 조치(next actions)를 제시해 주십시오...
The Skill은 run-unit-test --require-tests, get-source 및 get-dump를 구성하며, 워크플로우 엔진을 도입하지 않습니다. 빈 실행(Empty runs)은 성공이 아니며, 지원되지 않는 덤프 세부 정보는 명시적으로 ST22로 저하됩니다. Python 및 네이티브 npm 런타임은 동일한 명령과 JSON 계약을 노출합니다. 업그레이드하기 전에 진단 참조와 릴리스 상태를 확인하십시오.
검토 출력물(Review output)은 승인 자체가 아니라 릴리스 프로세스에 대한 입력값입니다. 개발자, 기술 리드 또는 릴리스 관리자는 여전히 서명하고, 테스트하고, 가져와야 합니다(import).
작동 방식 (How it works)
| 구성 요소 (Component) | 설명 (What it is) |
|---|
| Skill | SKILL.md 폴더를 포함하며 (워크플로우 단계, 하드 제약 조건), 검사 규칙 및 참조 파일을 담고 있습니다. 에이전트가 이를 로드하며, 실행 가능한 코드는 관여하지 않습니다. |
| ... | |
해당 리포지토리는 네 가지 Skill과 CLI 소스에 대한 단일 배포 지점이지만, 둘 중 어느 것을 사용하기 위해서도 그 빌드 레이아웃이 필요하지는 않습니다. 동일한 skill 폴더는 SKILL.md를 지원하는 다른 에이전트에 의해 로드될 수 있습니다. 발견 경로는 다릅니다(vary).
지원 및 안전성 (Support and safety)
| Platform | 오늘 사용 가능 여부 |
|---|
| Linux x86_64 | npm 런타임, 휴대용 아카이브 (Ubuntu 24.04에서 검증된 glibc 2.39 빌드), PyPI |
| ... | |
| Windows의 경우, WSL 상호 운용성(interop)을 통해 npm 설치 및 데스크톱 설치 관리자의 사용자별 무인 설치(silent per-user install), 동일 버전 업그레이드, 제거가 검증되었습니다. 그래픽 마법사 클릭, 실제 PATH 변경 및 권한 상승 설치는 여전히 미검증 상태입니다. 이 설치 관리자는 서명되지 않았습니다(unsigned). macOS 릴리스는 네이티브 GitHub Actions 빌드, 오프라인 테스트 및 두 아키텍처 모두에서의 격리된 npm 설치 검사를 통해 제한됩니다(gated). 개인용 Mac, 구형 macOS, 키체인(Keychain), 게이트키퍼/격리(Gatekeeper/quarantine), 서명/공증(signing/notarization) 및 macOS에서의 실제 SAP 사용은 여전히 미검증 상태입니다. 모든 플랫폼에서 스킬 폴더는 CLI와 별도로 설치하십시오. | |
SAP 사전 요구 사항 (prerequisites)
대상 시스템은 ECC 6.0 및 S/4HANA입니다. 온라인 사용을 위해서는 시스템에서 ADT 서비스가 활성화되어 있어야 하며(ICF 노드 /sap/bc/adt), 사용자 기기에서 네트워크 경로가 확보되어야 하고, 요청하는 객체 및 작업을 위한 권한이 부여된 사용자가 필요합니다. 개별 ADT 엔드포인트는 릴리스마다 다릅니다. sap-adt discovery와 sap-adt credentials doctor --coverage가 주어진 시스템이 노출하는 내용을 보고합니다. 여기에서 모든 ECC/S/4HANA 릴리스 및 엔드포인트 조합이 검증된 것은 아닙니다.
안전 기본값 (Safety defaults)