SAP ABAP Agent (Tiếng Việt)

Plugin Claude Code + MCP server tự động kết nối SAP BTP / S/4HANA Cloud để thao tác ABAP (đọc / tìm / syntax-check / activate). Hỗ trợ multi-profile — mỗi project SAP có profile riêng (URL, tenant, secret), lưu trong folder user trên máy (%USERPROFILE%\.mcp-sap-connect\ Windows, ~/.mcp-sap-connect/ macOS/Linux).

Nổi bật

🧠 SAP Consultant System (28 agents): Routing tự động bằng auto-scoring engine. 25 module consultants cho SD, FI, MM, CO, PP, QM, PM, WM, PS, HCM, BW, Basis, TM, TR, Ariba, CA, GTS, EHS, IBP, EWM, Fiori/UI5, CAP, CPI, SuccessFactors, BTP Admin + Docs Researcher + Daily Learner + Reviewer.
🔌 SAP BTP Connection: mcp-sap-connect — kết nối S/4HANA Cloud, đọc/activate ABAP, multi-profile.
🧱 DDIC Dictionary Bridge: sap-dict-bridge MCP server (sap_create_domain/sap_create_data_element/ sap_create_table) — tạo Domain/Data Element/Table trực tiếp qua cookie auth của mcp-sap-connect (xem skill sap-cloud-dictionary).
📚 CDS Knowledge Base: Tra cứu 7,355 CDS views released qua semantic search.
📖 SAP Docs Research: Tra cứu SAP Help, Community, API Hub, Fiori App Library.
🔒 Process Discipline: SessionStart hook ép routing trước khi trả lời, verification-before-completion, systematic-debugging, finish-ticket checklist — chặn lại kiểu lỗi "code đọc ổn nhưng chưa chạy thật".
🧠 Context Engineering (v0.6.2): trim MCP output (observation masking), scaffold summary giữa các layer, 2-layer module routing (CORE+DEEP), 3-tier memory cho daily-learner — lấy pattern từ agent-skills-for-context-engineering.
🖥️ GUI desktop native (Tauri) — khuyến nghị Windows: installer NSIS từ tag gui-v* / rolling gui-latest, PATH-only (cần mcp-sap-connect trên PATH). Profile / Reauth / Connect / Ping / MCP Servers / License dashboard / system tray + in-app updater (minisign). Xem gui-native/README.md. Legacy Tkinter (extra [gui] của wheel MCP server) vẫn hỗ trợ ≥2 minor — không khuyến nghị user mới.
⏱️ Early-finish cho reauth auto mode (Playwright): thay vì đợi 30s timeout, tool kết thúc sớm khi (1) user bấm Enter/OK, (2) session cookie + ADT discovery OK, hoặc (3) URL ổn định 3s. Test real timing URL-stable: 4.6s thay vì 30s.
⚡ SAML fast-path cho cookie auth (port từ vibing-steampunk): đăng nhập qua HTTP form-fill trực tiếp (~1–3s chỉ khi IAS không MFA, KHÔNG mở browser). Nếu IAS yêu cầu MFA/OTP/FIDO → fast-path thất bại và tự fallback browser (chậm hơn, không còn 1–3s). Thành công thì username/password được mã hóa lưu lại (cùng cơ chế với authMode=password) để tự dùng lại cho mọi lần reauth sau khi vẫn không MFA. Có ở cả wizard tương tác (option 1, mặc định) và setup --from-file (samlBootstrapUsername/samlBootstrapPassword). Chi tiết: KNOWN_LIMITATIONS.md.
🔁 Auto-reauth cho MỌI MCP tool call: trước đây chỉ mcp-sap-connect connect/reauth (lệnh CLI thủ công) mới tự đăng nhập lại khi session hết hạn — các tool sap_* thật (gọi từ Claude) không có cơ chế này, lỗi thẳng giữa chừng. create_sap_client() (factory dùng chung cho mọi tool handler + keep-alive) giờ tự chọn đúng reauth handler theo config profile, nên session hết hạn giữa lúc Claude đang dùng tool sẽ tự phục hồi (SAML fast-path trước, browser sau) thay vì rớt giữa chừng.
🛡️ Ctrl+C handling an toàn (ReauthCancelled / UserCancelled): không in traceback 10+ dòng nữa, cookie cũ KHÔNG bị save đè khi user hủy giữa luồng, browser Playwright luôn được đóng, cơ chế 2-lần Ctrl+C (lần 1 cảnh báo, lần 2 trong 2s mới hủy thật).

Đóng góp

Dự án là open-source, mọi đóng góp đều được chào đón!

File	Mục đích
`CONTRIBUTING.md`	Hướng dẫn đóng góp skill, agent, docs
`SKILL_TEMPLATE.md`	Template chuẩn để tạo skill / agent / reference module
`CODE_OF_CONDUCT.md`	Quy tắc ứng xử của cộng đồng

Cấu trúc

sap-abap-agent/
+-- .claude-plugin/            # Manifest plugin Claude Code
+-- commands/                  # /sap-setup, /sap-connect, /register-mcp-servers,
|                              # /sync-skills, /sap-new-object, /sap-generate-report, …
+-- skills/
|   +-- sap-ask-consultant/    # 🧠 Auto-scoring routing engine (28 agents)
|   +-- sap-daily-learner/     # 📚 Daily SAP Learning — Hermes-like (self-improving)
|   +-- sap-btp-setup/         # Setup & troubleshoot SAP BTP connection
|   +-- sap-clean-code/        # ABAP Cloud naming conventions & clean code
|   +-- sap-extensibility/     # Extensibility bậc thang cho Public Cloud
|   +-- sap-key-user-toolkit/  # Key User Extensibility handbook
|   +-- sap-cds-kb/            # Tra cứu CDS view qua cds-kb-mcp
|   +-- sap-docs-research/     # Tra cứu SAP Docs qua mcp-sap-docs
|   +-- sap-doc-to-md/         # Convert Word/Excel sang Markdown (markitdown)
|   +-- sap-analyze-function-spec/  # FS.docx -> INTAKE.md (bước 1 codegen pipeline)
|   +-- sap-write-technical-spec/   # INTAKE.md -> TECHNICAL_SPEC.md (bước 2)
|   +-- sap-cloud-dictionary/       # Tạo Domain/Data Element/Database Table (DDIC)
|   +-- sap-bootstrap-system-context/ # Dò hệ thống thật qua MCP trước khi scaffold
|   +-- sap-scaffold-rap/           # TECHNICAL_SPEC.md -> RAP 3-layer skeleton (bước 3)
|   +-- sap-scaffold-cds/           # -> CDS view skeleton, pattern read-only (bước 3)
|   +-- sap-scaffold-cds-analytics/ # -> Cube/Dimension/Text + Analytical Query
|   +-- sap-virtual-element/        # Calculated field trong CDS view
|   +-- sap-atc-review/             # Lint naming/released-API/clean-ABAP (bước 4)
|   +-- sap-unit-test/              # Sinh ABAP Unit test class (bước 5)
|   +-- sap-cds-unit-test/          # Test CDS view/RAP BO (bước 5)
|   +-- sap-migrate-segw-to-rap/    # Reverse-engineer SEGW -> RAP
|   +-- sap-finish-ticket/          # Checklist đóng ticket (bước 6)
|   +-- sap-verification-before-completion/  # Bằng chứng chạy thật
|   +-- sap-systematic-debugging/   # Debug runtime có hệ thống
|   +-- sap-routing-discipline/     # SessionStart hook - ép check routing
|   +-- sap-mcp-status/             # Audit MCP server registration
|   +-- sap-security-review/        # Quét bảo mật ABAP Cloud (OWASP-style, gọi từ abap-reviewer)
|   +-- sap-package-backup/         # Backup source Z*/YY1 qua ADT REST (cảm hứng abapGit)
|   +-- ... (7 skills khác: sap-released-classes, sap-abap-sql,
|   |       sap-badi-enhancement, sap-authorization, sap-odata-service,
|   |       sap-rap-events, sap-cloud-migration)
+-- agents/                    # 28 file .md — dispatch tự động qua skill sap-ask-consultant ở trên
|   +-- 25 module consultants (SD, FI, MM, CO, PP, QM, PM, WM, PS, HCM,
|   |   BW, Basis, TM, TR, Ariba, CA, GTS, EHS, IBP, EWM, Fiori, CAP,
|   |   CPI, SuccessFactors, BTP Admin)
|   +-- sap-docs-researcher       # CDS view & Docs Research
|   +-- sap-daily-learner         # Daily SAP Learning (Hermes-like)
|   +-- abap-reviewer             # Review code ABAP Cloud
+-- hooks/                   # Cảnh báo SELECT * (PostToolUse) + routing (SessionStart)
+-- reference/
    +-- modules/             # Kiến thức module cho từng consultant
    |   +-- sap-[module]-cloud/SKILL.md
    |   +-- sap-steampunk-cloud/SKILL.md
    +-- process/             # Context engineering (đã chuyển từ skills/)
    |   +-- sap-context-tool-result-trim.md   # Observation masking
    |   +-- sap-scaffold-context-summary.md   # Compact giữa các layer scaffold
    |   +-- sap-context-module-routing.md     # 2-layer core+deep routing
    |   +-- sap-multi-system-context.md       # Chọn backend theo routingHints
    |   +-- sap-service-type-context.md       # Xác định edition trước khi trả lời
    +-- mcp-guides/          # MCP setup reference (đã chuyển từ skills/)
    |   +-- mcp-sap-adt.md              # ADT MCP (3 options)
    |   +-- mcp-sap-gui.md              # SAP GUI Automation
    |   +-- mcp-sap-successfactors.md   # SuccessFactors MCP
    |   +-- mcp-sap-cdata-setup.md      # CData MCP common setup
    |   +-- mcp-sap-notes.md            # SAP Notes/KBA lookup MCP
    |   +-- mcp-sap-concur.md           # SAP Concur MCP (CData)
    |   +-- mcp-sap-fieldglass.md       # SAP Fieldglass MCP (CData)
    +-- scripts/             # Lint, validate, cleanup, update
    |   +-- agent_home.py, check_service_type.py, cleanup_agent_home.py,
    |   +-- mcp_common.py, mcp_status.py, mcp_inventory.json,
    |   +-- validate_plugin.py, sync_skills.py, office_to_md.py,
    |   +-- security_scan.py, update.ps1, update.sh, ...
    +-- mcp-server/          # MCP server Python (multi-profile)
        +-- mcp_sap_connect/
        |   +-- config/        # paths, profile (registry), store, secrets
        |   +-- sap/           # auth (OAuth2), client (REST + auto-reconnect)
        |   +-- tools/         # registry các tool MCP (có tham số `profile`)
        |   +-- cli/           # wizard setup + quản lý profile
        +-- pyproject.toml

Migration từ bản 1.x

Nếu bạn đã cài sap-btp-agent (bản 1.x): binary + package đã đổi tên thành mcp-sap-connect. Lần đầu chạy binary mới, dữ liệu profile của bạn tự động chuyển từ %USERPROFILE%\.sap-btp-agent\ (Windows) / ~/.sap-btp-agent/ (macOS/Linux) sang %USERPROFILE%\.mcp-sap-connect\ / ~/.mcp-sap-connect/ — không cần thao tác gì thêm, không mất profile/secret đã lưu (nếu thư mục mới đã tồn tại từ trước, tool sẽ báo lỗi rõ và yêu cầu bạn tự merge tay thay vì ghi đè âm thầm).

Binary cũ sap-btp-agent/sap-btp-agent-gui vẫn hoạt động trong 1 release nữa — in cảnh báo deprecation ra stderr rồi gọi thẳng logic mới, không đổi hành vi — đủ thời gian cập nhật CI/script của bạn sang mcp-sap-connect/mcp-sap-connect-gui. Binary cũ sẽ bị gỡ ở bản sau (xem CHANGELOG.md).

Hỗ trợ đa hệ thống (5 edition)

mcp-sap-connect nhận diện 5 kiểu hệ thống SAP khi chạy setup, mỗi kiểu có authMode mặc định và routingHints (khả năng backend nào dùng được — CRUD ABAP qua sap-connect, phân tích sâu qua sap-vsp, DDIC qua sap-dict-bridge) riêng. Xem reference/process/sap-multi-system-context.md để biết chi tiết cách chọn đúng backend theo edition hiện tại:

Service type	Mô tả
`s4hc_(public)`	S/4HANA Cloud Public Edition (multi-tenant SaaS)
`s4hc_(private)`	S/4HANA Cloud Private Edition (single-tenant, SAP-managed)
`btp`	SAP BTP ABAP Environment (Steampunk) — runtime riêng trên CF/Kyma
`onprem`	On-premise (customer-managed infrastructure)
`rise_with_sap`	RISE with SAP (SAP-managed trên infrastructure của khách hàng)

Cài đặt (1 lần)

Happy path end-user: xem docs/onboarding-guide.md (3 persona: ABAP Dev / Functional / Key user) — ≤ 15 phút / persona. Team / công ty: docs/rollout-guide.md + docs/team-troubleshooting.md. Host matrix: Claude Code = plugin + hooks đầy đủ; Cursor / VS Code = MCP docs-only (không skill pack / SessionStart hooks) — chi tiết trong onboarding.

Tóm tắt kỹ thuật (reference):

Cài MCP server từ wheel mới nhất (lệnh ở mục "Wheel pin" dưới) rồi python -m mcp_sap_connect.doctor
Windows GUI: ưu tiên NSIS tag gui-v* / rolling gui-latest (PATH-only — không embed Python; MSI cần admin / Error 1925 nếu không elevate)
Claude Code (mỗi máy):
```
/plugin marketplace add StormShynn/sap-abap-agent
/plugin install sap-abap-agent
```
rồi đăng ký MCP Core (sap-connect, sap-dict-bridge, …). N users = N lần marketplace add trên máy/account đó. Cursor: chỉ MCP — bỏ bước /plugin. Team rollout: docs/rollout-guide.md.

Wheel pin (MCP package chưa publish lên PyPI, có thể lệch patch so với plugin — lệnh dưới tự lấy release mcp-server-v* mới nhất, không cần biết version):

WHL=$(python -c "import json,urllib.request as u; r=json.load(u.urlopen('https://api.github.com/repos/StormShynn/sap-abap-agent/releases')); rel=next(x for x in r if x['tag_name'].startswith('mcp-server-v')); print(next(a['browser_download_url'] for a in rel['assets'] if a['name'].endswith('.whl')))")
pip install "mcp_sap_connect @ $WHL"
pip install "mcp_sap_connect[win-dpapi] @ $WHL"
# Cookie browser auto-login (tùy chọn):
pip install "mcp_sap_connect[playwright] @ $WHL"
playwright install chromium

Muốn pin cứng 1 version cụ thể? Lấy URL wheel trực tiếp từ trang Releases (tag mcp-server-v*) rồi dùng thay cho $WHL.

Cùng OS account = cùng vault .mcp-sap-connect (không tách người dùng trong một login). Cách ly: OS user riêng hoặc MCP_SAP_CONNECT_HOME.

Dev / contributor: cài từ source (editable install)

git clone https://github.com/StormShynn/sap-abap-agent.git
cd sap-abap-agent/reference/mcp-server
pip install -e .[win-dpapi,playwright]

Dùng khi bạn muốn sửa code MCP server (reference/mcp-server/mcp_sap_connect/) và thay đổi có hiệu lực ngay không cần build lại wheel. Build wheel mới để release:

pip install build
python -m build --wheel
# -> dist/mcp_sap_connect-<version>-py3-none-any.whl

Kiểm tra ngay sau khi cài (khuyến dùng, dành cho mọi người — không cần dùng AI để debug):

python -m mcp_sap_connect.doctor

Lệnh này chạy được ngay cả khi mcp-sap-connect chưa nằm trong PATH (lỗi thường gặp nhất trên Windows: pip cài vào user-scheme site-packages vì không có quyền viết vào Python gốc, VD %APPDATA%\Python\PythonXY\Scripts, folder này thường không tự động có trong PATH). Doctor sẽ tự phát hiện và in sẵn lệnh PowerShell để fix, kèm kiểm tra các dependency hay bị thiếu ngầm (pywin32/DPAPI, playwright+chromium...). Sau khi đã cài xong và PATH đúng, có thể gọi lại qua mcp-sap-connect doctor.

Thêm project SAP mới

Cách 2 — điền file, không cần trả lời wizard từng bước (khuyến dùng nếu muốn ít thao tác tương tác nhất): copy 1 trong 4 file mẫu ở reference/templates/mcp-sap-connect-profile-sample/ (theo đúng phương thức xác thực bạn có) ra thư mục local của bạn, điền các field <...>, rồi:

mcp-sap-connect setup --from-file duong-dan-file-da-dien.json

Lệnh này gọi đúng logic lưu trữ/mã hóa như wizard tương tác bên dưới — chỉ khác là không hỏi từng câu trong terminal. Xem reference/templates/mcp-sap-connect-profile-sample/README.md để biết chi tiết từng field + ví dụ cho cả 5 edition. /sap-setup tự làm bước copy này giúp bạn.

Cách 1 — wizard tương tác (trả lời từng câu hỏi), truyền URL trực tiếp:

mcp-sap-connect setup https://project1.s4hana.cloud.sap

Wizard sẽ tự sinh profile id từ hostname (project1.s4hana.cloud.sap) và hỏi phương thức xác thực (chọn 1-4):

OAuth2 (client_credentials) — client_id + client_secret, mặc định/khuyến dùng
Password — username + password
Bearer token — token có sẵn, nhập tay
Cookie-based — session cookie SAP (MYSAPSSO2, SAP_SESSIONID, sap-usercontext...). Wizard hỏi tiếp lấy cookie từ đâu:
- (1) SAML fast-path (mặc định) — nhập username/password IAS, tự POST form qua HTTP (~1–3s chỉ khi không MFA, KHÔNG mở browser). Có MFA/OTP → thất bại và tự rơi xuống (2) (browser, chậm hơn — đừng kỳ vọng 1–3s). Thành công thì lưu (mã hóa) để tự dùng lại cho lần reauth sau khi vẫn không MFA.
- (2) Auto — tự mở browser cho bạn đăng nhập (hỗ trợ cả MFA/SSO), tự lấy cookie (cần extra playwright)
- (3) File cookie Netscape format
- (4) Paste tay (F12 -> Application -> Cookies)
Sau khi có cookie, tự động re-auth (SAML fast-path trước nếu có credential đã lưu, fallback browser popup/Playwright) mỗi lần session hết hạn (401) — kể cả khi hết hạn giữa lúc Claude đang gọi tool sap_* thật, không chỉ qua lệnh connect/reauth thủ công.

Sau đó hỏi thêm Region, service type (s4hc_(private) / s4hc_(public) / btp / onprem).

Thông tin được lưu riêng trong profiles/<id>/:

%USERPROFILE%\.mcp-sap-connect\profiles\project1.s4hana.cloud.sap\
+-- config.json     <- URL, tenant, client_id, region, service (không nhạy cảm)
+-- secrets.json    <- client_secret / token (ĐÃ MÃ HÓA)

Thêm project thứ 2, 3... cũng dễ:

mcp-sap-connect setup https://project1.s4hana.cloud.sap

Mỗi project sẽ có profile riêng, secret riêng (mã hóa độc lập).

Quản lý nhiều profile

mcp-sap-connect profiles list             # liệt kê profile (* = active)
mcp-sap-connect profiles use project1     # chọn profile active
mcp-sap-connect profiles show             # xem chi tiết profile active
mcp-sap-connect profiles remove project2  # xóa 1 profile
mcp-sap-connect reset                     # xóa TẤT CẢ (cẩn thận!)

Kiểm tra kết nối

mcp-sap-connect connect                            # test profile active
mcp-sap-connect connect project1.s4hana.cloud.sap  # test 1 profile cụ thể

GUI desktop (khuyến nghị: native Tauri)

PATH-only: cài CLI trước, rồi cài installer GUI (không embed Python).

$WHL = python -c 'import json,urllib.request as u; r=json.load(u.urlopen("https://api.github.com/repos/StormShynn/sap-abap-agent/releases")); rel=next(x for x in r if x["tag_name"].startswith("mcp-server-v")); print(next(a["browser_download_url"] for a in rel["assets"] if a["name"].endswith(".whl")))'
pip install "mcp_sap_connect[win-dpapi] @ $WHL"
python -m mcp_sap_connect.doctor

Sau đó cài bản native từ Release tag gui-v* (hoặc About → Check for updates) — ưu tiên NSIS .exe (current-user, không cần admin). MSI thường cần elevation (Error 1925 nếu cài silent không có quyền). Hoặc build từ gui-native/. Chi tiết: gui-native/README.md.

App mở ra: kiểm tra runtime → Add profile → Ping/Connect → MCP Servers.

Legacy: Tkinter GUI (pip extra `[gui]`)

Vẫn hỗ trợ ≥2 minor sau GA native; không khuyến nghị cho user mới:

WHL=$(python -c "import json,urllib.request as u; r=json.load(u.urlopen('https://api.github.com/repos/StormShynn/sap-abap-agent/releases')); rel=next(x for x in r if x['tag_name'].startswith('mcp-server-v')); print(next(a['browser_download_url'] for a in rel['assets'] if a['name'].endswith('.whl')))")
pip install "mcp_sap_connect[gui] @ $WHL"
mcp-sap-connect-gui

Xem thêm reference/mcp-server/mcp_sap_connect/gui/README.md.

License dashboard (xem cookie/token còn hạn bao lâu)

CLI mới mcp-sap-connect license in trạng thái license của tất cả profile hoặc 1 profile cụ thể:

mcp-sap-connect license                                # bảng tóm tắt tất cả profile
mcp-sap-connect license project1.s4hana.cloud.sap      # chi tiết 1 profile

Output mẫu (danh sách):

======================================================================================
  Profile                                  Type     Status       Expires
======================================================================================
  *project1.s4hana.cloud.sap               cookie   ok           6h 59m
   old.s4hana.cloud.sap                    cookie   warning      29m 57s
   expired.s4hana.cloud.sap                cookie   expired      expired 1m 5s ago
======================================================================================
  (*) = active profile. Dung `mcp-sap-connect license <id>` de xem chi tiet.

Output mẫu (chi tiết):

============================================================
  License: project1.s4hana.cloud.sap
============================================================
  Type        : cookie
  Has creds   : True
  Expires at  : 2026-07-18 16:30:00 (7h 59m)
  Saved at    : 2026-07-18 08:30:00
  session_cookies: ['MYSAPSSO2', 'sap-usercontext']
  total_cookies: 6
  max_age_hours: 8.0

  OK

Cookie expires được ước lượng = last_saved + cookie_max_age_hours (mặc định 8h, override bằng cách thêm "cookieMaxAgeHours": N vào config.json của profile) — SAP không gửi kèm thời gian hết hạn thật trong session cookie (SAP_SESSIONID_*/ sap-usercontext là session cookie thuần, expires=None, đã verify trực tiếp qua cookie jar thật), nên đây là giới hạn kỹ thuật thật sự, không phải làm ẩu. Bù lại, cơ chế keep-alive (ping mỗi 5 phút) giờ tự "gia hạn" ước lượng mỗi lần ping thành công (bằng chứng thật session còn sống), và đánh dấu hết hạn ngay lập tức khi ping thất bại — thay vì luôn hiển thị số giờ tĩnh từ lúc đăng nhập, không phản ánh thực tế.
OAuth2 token expires được lưu chính xác từ response expires_in của token endpoint.
Tray notification tự động khi mở GUI nếu có profile sắp hết hạn (<1h) hoặc đã hết hạn.

Đăng ký MCP với Claude Code

Quản lý nhiều MCP server cùng lúc? Các phần dưới đây hướng dẫn claude mcp add từng server riêng lẻ. Nếu bạn dùng nhiều coding agent (Claude Code, Claude Desktop, Codex CLI, Gemini CLI...) và muốn 1 chỗ bật/tắt MCP server cho tất cả thay vì sửa tay từng file config, xem thử mcp-switch — desktop app (Tauri + Rust) riêng của tác giả plugin này, dùng 1 store trung tâm (~/.mcp-switch/store.json) rồi ghi lại config native của từng tool khi bạn bật/tắt. Độc lập với plugin này, không bắt buộc.

mcp-sap-connect gọi không có argument sẽ chạy MCP stdio server (mcp_sap_connect/server.py), serve các tool bên dưới qua JSON-RPC. Đã test end-to-end (initialize -> tools/list -> tools/call) trước khi công bố.

Dùng lệnh claude mcp add (Claude Code không còn dùng file mcp_servers.json):

claude mcp add --transport stdio sap-connect -- mcp-sap-connect

Mặc định là scope local (chỉ máy này, chỉ project hiện tại). Dùng --scope user để dùng được ở mọi project, hoặc --scope project để lưu vào .mcp.json và chia sẻ qua git cho cả team.

Mở Claude Code với plugin, các tool sau sẽ xuất hiện:

Tool	Mô tả
`sap_list_profiles`	Liệt kê các profile đã cấu hình
`sap_ping`	Test kết nối profile (có tham số `profile`)
`sap_list_packages`	Liệt kê package ABAP
`sap_search`	Tìm object ABAP theo tên
`sap_read_source`	Đọc source code (class, program, include...)
`sap_syntax_check`	Syntax check (không activate)
`sap_activate`	Activate object (transport local)

MCP server phụ trợ: tra cứu CDS view & SAP docs

Theo mặc định, Claude Code chỉ chấp nhận 1 MCP server stdio. Để sử dụng thêm các MCP server remote (cds-kb-mcp và mcp-sap-docs), dùng claude mcp add với transport http / sse:

CDS Knowledge Base (released CDS views, cds-kb-mcp):

Cách 1 — claude mcp add (Streamable HTTP, khuyến nghị):

claude mcp add --transport http cds-kb --url https://mcp.tringhia.io.vn/mcp

Cách 2 — cấu hình trực tiếp trong .mcp.json / Cursor mcp.json:

{
  "mcpServers": {
    "cds-kb": {
      "type": "http",
      "url": "https://mcp.tringhia.io.vn/mcp"
    }
  }
}

Cách 3 — supergateway (chỉ khi IDE chưa hỗ trợ HTTP MCP native; mcp-sap-docs-btp vẫn dùng SSE):

{
  "mcpServers": {
    "mcp-sap-docs-btp": {
      "command": "npx",
      "args": ["-y", "supergateway@2.0.0", "--sse", "https://sap-docs-extend-mcp.cfapps.ap21.hana.ondemand.com/sse"]
    }
  }
}

SAP Docs Research (SAP Help, Community, API Hub, Fiori App, Clean Core):

Cách 1 — claude mcp add:

claude mcp add --transport sse mcp-sap-docs-btp --url https://sap-docs-extend-mcp.cfapps.ap21.hana.ondemand.com/sse
# Nếu có SAP-API-HUB-KEY:
# claude mcp add --transport sse mcp-sap-docs-btp --url https://sap-docs-extend-mcp.cfapps.ap21.hana.ondemand.com/sse --headers "{\"SAP-API-HUB-KEY\": \"<YOUR_KEY>\"}"

Cách 2 — supergateway:

{
  "mcpServers": {
    "mcp-sap-docs-btp": {
      "command": "npx",
      "args": ["-y", "supergateway@2.0.0", "--sse", "https://sap-docs-extend-mcp.cfapps.ap21.hana.ondemand.com/sse"],
      "disabled": false
    }
  }
}

Windows users: Nếu dùng supergateway, có thể cần dùng supergateway.cmd thay vì supergateway hoặc chỉ định đường dẫn tuyệt đối.

Notion — skill notes dùng chung cho team

notion — Workspace Notion làm nơi ghi/tra skill notes bổ sung (AI ghi tóm tắt, bạn ghi tay), qua MCP server chính chủ của Notion (makenotion/notion-mcp-server). Đã auto-bundle sẵn trong .mcp.json của plugin này (không cần claude mcp add thủ công) — mỗi thành viên team chỉ cần chạy 1 lệnh trong Claude Code để đăng nhập tài khoản Notion của riêng họ:

/mcp

Chọn notion trong danh sách rồi làm theo OAuth flow (mở browser đăng nhập). Không có token/secret nào được lưu trong repo — mỗi người tự xác thực bằng chính tài khoản Notion của mình.

Chia sẻ cho team: invite từng thành viên vào page/workspace Notion tương ứng (thao tác ở phía Notion — Share → nhập email), không liên quan gì đến file .mcp.json/repo. Xem chi tiết cách đăng ký và cấu hình khác ở developers.notion.com/guides/mcp.

👥 Mời thêm người vào dùng chung database "SAP Skills" — làm sao cho đúng

Setup phía người được mời, theo đúng thứ tự:

Accept invite/mở link share Notion trước (thao tác tay trong trình duyệt, ngoài Claude Code) — xác nhận thấy đúng nội dung database.
Tự chạy /mcp trong Claude Code, chọn notion, đăng nhập bằng tài khoản Notion của chính họ (không dùng chung tài khoản với người tạo database).

Default đã gắn trong plugin: StormShynn shared DB 9d54b58613ad485f8b8f19909adbb219 — sau bước 1–2, notion_skills_db.py get đã ra id này (không bắt buộc set). Muốn DB riêng (công ty): python reference/scripts/notion_skills_db.py set "<id-or-url>" hoặc env SAP_ABAP_AGENT_NOTION_SKILLS_DB. Quay về default: notion_skills_db.py clear.

Chi tiết đầy đủ: skills/sap-daily-learner/SKILL.md mục 3b.

Ví dụ prompt:

"Tóm tắt skill sap-cloud-dictionary vừa học vào page Notion 'SAP Skills'"
"Tra trong Notion xem có note nào về BAdI enhancement không"

Tự động đồng bộ 2 chiều với sap-daily-learner: skill sap-daily-learner (Auto-Skill Creation Engine) tự tra database "SAP Skills" trên Notion trước khi tự giải 1 vấn đề từ đầu — nếu thành viên khác trong team đã hỏi và tạo skill tương tự rồi thì lấy ra dùng luôn; sau khi tự tạo 1 skill mới, tự động đẩy lên Notion (không cần thao tác gì thêm ngoài /mcp đã làm 1 lần ở trên). Chi tiết quy trình: skills/sap-daily-learner/SKILL.md mục "3b. Đồng bộ Notion".

Mở rộng cho cả 25 agent tư vấn: skills/sap-ask-consultant/SKILL.md (Bước 5) cũng tra kho local + Notion này trước khi dispatch bất kỳ agent tư vấn nào (SD/FI/MM/...) — local trước (offline, nhanh), Notion khi local chưa có (online), tự cache lại local sau khi tìm thấy trên Notion. Mất local (vd đổi máy) không sao — lần hỏi lại đầu tiên sẽ tự lấy lại từ Notion. Phần ghi skill mới vẫn chỉ riêng sap-daily-learner (agent duy nhất có quyền ghi file).

🤖 Continuous Improvement Engine — Tự động phát hiện lỗi & tạo issue

Error reporter (hooks/error_reporter.py) chạy ngầm qua hook system, tự động phát hiện lỗi runtime trong quá trình dùng plugin và tạo GitHub issue trên repo chính để theo dõi, fix lỗi liên tục — mỗi ngày plugin càng ít lỗi hơn:

⚠️ Mặc định TẮT (opt-in). Cài plugin không bắt buộc bạn phải có GitHub auth, và việc thu thập error/code âm thầm mà không hỏi trước là vi phạm quyền riêng tư — nên tính năng này chỉ chạy khi bạn bật rõ ràng bằng 1 trong 2 cách: Cách 1 — tạm thời (chỉ trong session terminal hiện tại):
PowerShell (Windows — khuyến nghị)
$env:SAP_ABAP_AGENT_ERROR_REPORTING = "1"
CMD (Windows — Command Prompt)
set SAP_ABAP_AGENT_ERROR_REPORTING=1
bash / zsh / Git Bash / WSL (macOS, Linux)
export SAP_ABAP_AGENT_ERROR_REPORTING=1
Cách 2 — vĩnh viễn (tạo file marker, không cần set env mỗi lần):
PowerShell (Windows)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.sap-abap-agent\error-reports"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.sap-abap-agent\error-reports\ENABLED"
CMD (Windows)
if not exist "%USERPROFILE%\.sap-abap-agent\error-reports" mkdir "%USERPROFILE%\.sap-abap-agent\error-reports"
echo. > "%USERPROFILE%\.sap-abap-agent\error-reports\ENABLED"
bash / zsh / Git Bash / WSL (macOS, Linux)
mkdir -p ~/.sap-abap-agent/error-reports && touch ~/.sap-abap-agent/error-reports/ENABLED
Ngoài ra, phần "đính code fix vào issue" **chỉ hoạt động khi bạn sửa chính code của plugin này** (VD đang dev fix bug plugin) — không bao giờ đính kèm code ABAP/project nội bộ của bạn lên issue public, dù đã bật opt-in.

User chạy lệnh → PostToolUse detect → ghi error_log.jsonl
                                           ↓
Stop hook → gom nhóm 24h → dedup (SHA256) → tạo GitHub issue (nếu mới)
                                           ↓
Khi Claude viết code sửa lỗi → detect-fix → ghi fix_log.jsonl
                                           ↓
Stop → match fix với issue → add comment "cách sửa" vào issue có sẵn
                                           ↓
Issue = [🐛 error] + [✅ fix solution] → Dev fix → release → user update → ít lỗi hơn

Các chế độ hook

Hook event	Mode	Chức năng
PostToolUse (Bash)	`detect-bash`	Phát hiện lỗi từ Bash command (exit code ≠ 0, stderr)
PostToolUse (sap_*)	`detect-tool`	Phát hiện lỗi từ MCP tool (syntax check fail, activate fail, connection error)
PostToolUse (Edit/Write)	`detect-fix`	Khi Claude viết code, kiểm tra có phải đang fix lỗi cũ không → ghi fix record
Stop	`report`	Gom error → dedup → tạo issue + Gom fix → add comment

Matching fix với error

detect-fix chỉ xét tiếp nếu file đang sửa nằm trong chính thư mục cài đặt plugin này (_is_plugin_file()) — sửa code của bạn (VD class ABAP nội bộ) sẽ bị bỏ qua ngay từ bước này, không bao giờ vào fix_log.jsonl. Nếu qua được gate đó, mới quét error_log 7 ngày, scoring:

file_path match → +3
session_id match → +1
Code keywords (tên class, table, method) match với error message → +1 đến +3
Threshold ≥2 → tạo fix record (đã redact chuỗi giống secret/token), sẽ được add comment vào GitHub issue ở Stop hook

Kiểm tra trạng thái

Không cần stdin, chạy tay được:

PowerShell (Windows — khuyến nghị)

"{}" | python hooks/error_reporter.py status

CMD (Windows — Command Prompt)

echo {} | python hooks\error_reporter.py status

bash / zsh / Git Bash / WSL (macOS, Linux)

echo '{}' | python hooks/error_reporter.py status

Output mẫu:

{
  "plugin_version": "1.23.1",
  "total_logged_errors": 12,
  "total_logged_fixes": 3,
  "active_error_groups_24h": 2,
  "known_issues_created": 1,
  "error_breakdown": {
    "a1b2c3d4e5f6": {
      "type": "abap_syntax_error",
      "count": 5,
      "message_preview": "Syntax error in ZCL_MY_CLASS...",
      "has_issue": true,
      "has_fix": true,
      "fix_count": 1
    }
  }
}

Ai cũng có local report — không cần GitHub

Dù có GitHub auth hay không, error report luôn được save thành file Markdown tại ~/.sap-abap-agent/error-reports/reports/ — ai cũng đọc được, không cần Dù có GitHub auth hay không, error report luôn được save thành file Markdown tại ~/.sap-abap-agent/error-reports/reports/ — ai cũng đọc được, không cần token.

PowerShell / CMD (Windows)

# PowerShell
Get-ChildItem "$env:USERPROFILE\.sap-abap-agent\error-reports\reports\"

:: CMD
dir "%USERPROFILE%\.sap-abap-agent\error-reports\reports\"

bash / zsh / Git Bash / WSL (macOS, Linux)

ls ~/.sap-abap-agent/error-reports/reports/

Mỗi report là 1 file .md hoàn chỉnh: error message + context + fix solution (nếu có) + hướng dẫn share lên GitHub Issues.

Tạo GitHub issue (optional — có auth thì tự động)

Fallback chain — không có auth cũng không sao, mọi thứ vẫn hoạt động:

1. gh CLI (gh issue create)?           → có → tạo issue
2. GITHUB_TOKEN / GH_TOKEN env var?    → có → REST API → tạo issue
3. Không có cả 2?                      → local report + pending queue → retry sau

Luôn có local report — bước 3 vẫn lưu file .md đầy đủ, không mất gì.

Chỉ cần chạy 1 lần, cần GITHUB_TOKEN (không cần gh CLI):

PowerShell (Windows — khuyến nghị)

$env:GITHUB_TOKEN = "ghp_xxx"
python reference/scripts/setup_labels.py

CMD (Windows — Command Prompt)

set GITHUB_TOKEN=ghp_xxx
python reference\scripts\setup_labels.py

bash / zsh / Git Bash / WSL (macOS, Linux)

export GITHUB_TOKEN=ghp_xxx
python reference/scripts/setup_labels.py

Tạo 2 label: auto-reported 🟣 + auto-fix 🟢

Đánh dấu riêng tư: nếu không muốn 1 skill nào đó bị đẩy lên Notion (vd nội dung gắn với khách hàng/hệ thống cụ thể), đánh dấu bằng thẻ <private>...</private> quanh câu hỏi hoặc nói thẳng "đừng đồng bộ lên Notion" / "giữ local thôi" — sap-daily-learner sẽ chỉ lưu local, bỏ qua bước đẩy Notion.

Từ Notion vào thẳng project (quarantine -> active -> promote): skill nào được cả team dùng lại nhiều lần (mặc định >=3, đếm trên Notion) trở thành "ứng viên promote" — lệnh "liệt kê ứng viên promote" / "promote skill [topic]" đưa nó vào reference/modules/<module>-cloud/SKILL.md (git- tracked, đi kèm plugin cho mọi người dùng public, không chỉ riêng team bạn qua Notion). Luôn hỏi xác nhận trước khi ghi file, không tự commit/push — bạn tự xem diff + tự commit theo đúng flow trong CONTRIBUTING.md.

Lưu ý bảo mật: repo này là public — KHÔNG bao giờ dán token Notion (hoặc bất kỳ API key nào) trực tiếp vào .mcp.json/mcp_inventory.json rồi commit. Với server nào thực sự cần 1 secret tĩnh (vd SAP-API-HUB-KEY ở trên, hoặc ADT_USER/ADT_PASS...), dùng reference/scripts/mcp_register.py (hỏi riêng từng người, đăng ký qua claude mcp add --scope user) — giá trị chỉ nằm trong ~/.claude.json của từng máy, không bao giờ vào file commit. Xem python reference/scripts/mcp_status.py để đối chiếu nhanh server nào đang thiếu env var mong đợi.

MCP server mới: tra cứu SAP Notes

mcp-sap-notes — Tra cứu SAP Notes và KB articles trực tiếp từ SAP Support Portal:

# Cài đặt từ source
git clone https://github.com/marianfoo/sap-mcp-servers.git
cd sap-mcp-servers/packages/notes
npm install
npm run build

# Đăng ký MCP
claude mcp add --transport stdio sap-notes -- node /abs/path/to/dist/mcp-server.js \
  --env SAP_USERNAME=your@s-user.com --env SAP_PASSWORD=your_pass

Tool	Mô tả
`search`	Tìm SAP Note theo keyword / error code / component
`fetch`	Lấy nội dung đầy đủ SAP Note + ABAP correction instructions

MCP server mới: SAP GUI Automation (Windows)

mcp-sap-gui (kts982) — Điều khiển SAP GUI for Windows qua MCP (57 tools):

# Cài đặt bằng uvx (khuyến dùng)
pip install uvx

# Đăng ký MCP
claude mcp add --transport stdio sap-gui -- uvx mcp-sap-gui[screenshots] \
  --read-only --allowed-transactions MM03 VA03 IW33

Yêu cầu: Windows + SAP GUI + SAP GUI Scripting enabled (xem reference/mcp-guides/mcp-sap-gui.md).

Tool	Mô tả
`sap_connect`	Kết nối SAP GUI
`sap_run_transaction`	Mở transaction (/nMM03)
`sap_read_field`	Đọc giá trị field
`sap_read_table`	Đọc toàn bộ ALV/Grid table

MCP server mới: ADT ABAP Development (3 lựa chọn)

Lựa chọn	Lệnh cài đặt	Phù hợp
SAP Official ADT (VS Code)	Cài extension ADT → Settings → Enable ADT MCP Server	VS Code users, enterprise
ARC-1 (enterprise)	`npx arc-1@latest`	Team/doanh nghiệp cần security
mcp-abap-adt (community)	`npx -y mcp-abap-adt`	Cá nhân, POC nhanh

# ARC-1
claude mcp add --transport stdio arc-1 -- npx -y arc-1@latest

# mcp-abap-adt
claude mcp add --transport stdio mcp-abap-adt -- npx -y mcp-abap-adt \
  --env ADT_URL=https://my-system.s4hana.cloud.sap --env ADT_USER=user --env ADT_PASS=pass

MCP server mới: SAP SuccessFactors (2 options)

sf-mcp (aiadiguru2025) — Open-source MCP server cho SAP SuccessFactors OData API (62+ tools):

# Yêu cầu: Python 3.10+, uv package manager
git clone https://github.com/aiadiguru2025/sf-mcp.git
cd sf-mcp
uv sync

# Đăng ký MCP
claude mcp add --transport stdio sf-mcp -- uv --directory /path/to/sf-mcp run main.py

Tool	Mô tả
`get_employee_info`	Tra cứu thông tin nhân viên theo ID
`search_employees`	Tìm nhân viên theo criteria (name, department...)
`get_org_structure`	Lấy sơ đồ tổ chức công ty
`get_time_off_balance`	Kiểm tra ngày nghỉ còn lại của nhân viên
`get_role_permissions`	Kiểm tra RBP permissions của nhân viên

Option 2: CData SF MCP — Java-based, SQL read-only (cần CData JDBC driver license):

claude mcp add --transport stdio sf-cdata -- java -jar /path/to/CDataMCP-jar-with-dependencies.jar /path/to/sap-successfactors.prp

MCP server mới: SAP Concur Travel & Expense

CData SAP Concur MCP — Query expense reports, travel requests, bookings, vendor data qua SQL:

# Yêu cầu: Java 11+, Maven
git clone https://github.com/CDataSoftware/sap-concur-mcp-server-by-cdata.git
cd sap-concur-mcp-server-by-cdata
mvn clean install

# Đăng ký MCP
claude mcp add --transport stdio sap-concur -- java -jar /path/to/CDataMCP-jar-with-dependencies.jar /path/to/sap-concur.prp

Tool	Mô tả
`concur_get_tables`	Liệt kê các bảng SAP Concur instance
`concur_get_columns`	Liệt kê columns của 1 table
`concur_run_query`	Thực thi SQL SELECT query

MCP server mới: SAP Fieldglass Services Procurement

CData SAP Fieldglass MCP — Query contingent workforce, SoW, timesheets, invoices qua SQL:

# Yêu cầu: Java 11+, Maven
git clone https://github.com/CDataSoftware/sap-fieldglass-mcp-server-by-cdata.git
cd sap-fieldglass-mcp-server-by-cdata
mvn clean install

# License JDBC Driver
java -jar cdata.jdbc.sapfieldglass.jar --license

# Đăng ký MCP
claude mcp add --transport stdio sap-fieldglass -- java -jar /path/to/CDataMCP-jar-with-dependencies.jar /path/to/sap-fieldglass.prp

Tool	Mô tả
`fieldglass_get_tables`	Liệt kê các bảng SAP Fieldglass instance
`fieldglass_get_columns`	Liệt kê columns của 1 table
`fieldglass_run_query`	Thực thi SQL SELECT query

MCP server mới: Chrome DevTools (debug web / Fiori-UI5)

chrome-devtools-mcp — MCP server chính chủ của Google/ChromeDevTools team, điều khiển 1 Chrome thật (qua Puppeteer) để debug trang web: console log, network request, performance trace, screenshot, thao tác DOM. Không phải tool SAP-specific, nhưng hữu ích khi cần debug Fiori/UI5 app chạy trên browser — việc mà WebFetch/WebSearch không làm được vì chỉ đọc HTML tĩnh, không chạy được JS/SPA:

# Yêu cầu: Node.js LTS + Google Chrome (bản stable) đã cài sẵn máy
claude mcp add --transport stdio chrome-devtools -- npx -y chrome-devtools-mcp@latest

# Khuyến dùng: thêm --isolated để dùng profile Chrome tạm (tự xóa sau khi đóng),
# không đụng tới cookie/session Chrome thật bạn đang dùng hàng ngày
claude mcp add --transport stdio chrome-devtools -- npx -y chrome-devtools-mcp@latest --isolated

Hoặc dùng script chung của plugin (hỏi Y/n rồi tự chạy lệnh trên giúp bạn, không cần gõ tay):

python reference/scripts/mcp_register.py

Server này không nằm trong .mcp.json bundled sẵn của plugin (khác sap-connect/cds-kb/notion) — dù không cần credential, nó vẫn cần 1 bước xác nhận (Y/n) vì là năng lực điều khiển 1 Chrome thật, không nên tự động bật cho mọi người cài plugin.

Tool	Mô tả
`navigate_page`	Mở 1 URL (VD: Fiori Launchpad app)
`take_snapshot`	Chụp DOM snapshot (đọc cấu trúc trang, phục vụ click/fill tiếp theo)
`list_console_messages`	Liệt kê console log/error của trang (debug UI5 runtime error)
`list_network_requests`	Liệt kê network request (kiểm tra OData call bị lỗi 400/500)
`performance_start_trace` / `performance_stop_trace`	Ghi performance trace (debug app load chậm)
`take_screenshot`	Chụp màn hình trang hiện tại

Chi tiết đầy đủ (toàn bộ nhóm tool, CLI flags, security notes): xem reference/mcp-guides/mcp-chrome-devtools.md.

Sau khi cấu hình, AI sẽ có thêm các tool:

Tool	Server	Mô tả
`search_cds`	cds-kb	Tìm CDS view theo business meaning
`get_cds_view`	cds-kb	Lấy definition đầy đủ của 1 CDS view
`get_views_by_tag`	cds-kb	Liệt kê CDS view theo tag (BO, LOB, module)
`get_taxonomy`	cds-kb	Khám phá Lines of Business → Business Objects
`kb_info`	cds-kb	Kiểm tra version KB
`search`	mcp-sap-docs-btp	Tra cứu SAP Help Portal + offline docs
`sap_community_search`	mcp-sap-docs-btp	Tìm kiếm SAP Community Q&A
`sap_search_objects`	mcp-sap-docs-btp	Tra cứu Clean Core Released Objects
`abap_feature_matrix`	mcp-sap-docs-btp	Kiểm tra ABAP syntax support
`sap_accelerator_hub_*`	mcp-sap-docs-btp	Khám phá API trên SAP Accelerator Hub
`sap_fiori_library_*`	mcp-sap-docs-btp	Tra cứu Fiori App Reference Library
`sap_discovery_center_*`	mcp-sap-docs-btp	Khám phá BTP services & pricing
`abap_lint`	mcp-sap-docs-btp	Kiểm tra chất lượng code ABAP

Lưu ý: Server mcp-sap-docs-btp cần SAP-API-HUB-KEY để các tool sap_accelerator_hub_* hoạt động đầy đủ. Các tool còn lại vẫn chạy không cần key.

Mọi tool đều có tham số profile (để trống = profile active). Ví dụ:

"Liệt kê các package trong project project1"
-> Claude gọi sap_list_packages({ profile: "project1.s4hana.cloud.sap" })

"Tìm class ZCL_* trong project đang dùng"
-> Claude gọi sap_search({ query: "ZCL_" })

📚 SAP Daily Learner — Skill Curator & Cron thật (Hermes-like)

skills/sap-daily-learner/SKILL.md là agent tự cải thiện (self-improving) lấy cảm hứng từ Hermes Agent (NousResearch/hermes-agent) — gia sư SAP hàng ngày + tự tạo skill document từ tương tác phức tạp (xem mục "Notion" ở trên cho phần đồng bộ team). 2 khả năng dưới đây (thêm 2026-07-16) đọc trực tiếp kiến trúc thật của Hermes trước khi build — không đoán mò tên gọi rồi tự chế cơ chế bên trong.

🧹 Skill Curator — vòng đời skill tự động

Skill tự tạo trong memory/procedural/skills/ càng tích luỹ càng dễ "chết" — không còn ai dùng nhưng vẫn nằm mãi, làm chậm việc tra cứu. reference/scripts/skill_curator.py xử lý việc này, đúng cơ chế Curator của Hermes: skill không dùng tới sau 30 ngày chuyển stale, sau 90 ngày chuyển archived (di chuyển vào memory/procedural/skills/.archive/, không bao giờ xoá thật — khôi phục được bất kỳ lúc nào bằng cách chuyển file trở lại). Dùng lại 1 skill sẽ tự đưa nó về active.

Chạy tự động mỗi khi sap-daily-learner được gọi (tự gate theo interval 7 ngày — gọi sớm hơn sẽ tự bỏ qua, không cần tự canh giờ) — không cần setup gì thêm. Muốn tự kiểm tra trạng thái:

python reference/scripts/skill_curator.py run "$(python reference/scripts/agent_home.py memory/procedural)" --dry-run

⏰ Cron thật — daily tip chạy nền qua Windows Task Scheduler

⚠️ Mặc định TẮT (opt-in tuyệt đối), cùng triết lý với Continuous Improvement Engine ở dưới. Mỗi lần cron thật sự chạy sẽ gọi 1 phiên Claude Code (claude -p) thật — tốn chi phí API thật trên tài khoản của bạn. Cài xong vẫn chưa chạy gì cả cho tới khi bạn bật rõ ràng.

Khác Hermes bản gốc (có gateway daemon chạy liên tục, tự poll mỗi 60 giây): plugin này không có tiến trình nền thật — dùng Windows Task Scheduler làm "cái luôn túc trực" thay cho daemon đó.

Bước 1 — Cài lịch Task Scheduler (chỉ đặt lịch, CHƯA chạy gì — cần quyền Administrator):

Click phải reference\scripts\install-daily-learner-cron.bat → Run as administrator

Sau khi cài, task sẽ tự "tick" mỗi 5 phút nhưng vẫn no-op (không làm gì) cho tới Bước 2.

Bước 2 — Bật opt-in thật sự (chọn 1 trong 2 cách):

PowerShell (Windows — khuyến nghị)

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.sap-abap-agent\cron"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.sap-abap-agent\cron\ENABLED"

CMD (Windows — Command Prompt)

if not exist "%USERPROFILE%\.sap-abap-agent\cron" mkdir "%USERPROFILE%\.sap-abap-agent\cron"
echo. > "%USERPROFILE%\.sap-abap-agent\cron\ENABLED"

Hoặc set biến môi trường hệ thống SAP_ABAP_AGENT_CRON_ENABLED=1 (System Properties → Environment Variables) thay vì tạo file marker — 2 cách tương đương.

Bước 3 — Thêm ít nhất 1 job (cron chỉ có việc để làm sau bước này):

⚠️ Prompt bắt đầu bằng / (gọi thẳng 1 skill) phải thêm qua PowerShell, không dùng Git Bash — đã xác nhận qua test thật: Git Bash tự "dịch" chuỗi bắt đầu bằng / thành đường dẫn Windows (MSYS path-mangling), làm hỏng nội dung prompt.

python reference\scripts\cron_manage.py add "$env:USERPROFILE\.sap-abap-agent" daily-tip "/sap-daily-learner cho toi 1 tip hoc SAP hom nay dua tren tien do hien tai" daily@08:00

Kiểm tra trạng thái / chi phí đã dùng (bất kỳ lúc nào):

python reference/scripts/cron_manage.py status "$(python reference/scripts/agent_home.py)"

Kết quả tick được ghi vào <agent-home>/cron/pending/, rồi tự bơm vào phiên chat Claude Code kế tiếp khi bạn mở lên (SessionStart hook hooks/cron_deliver.py) — không có tích hợp Telegram/ Slack như Hermes thật, nhưng không cần thêm thao tác nào.

Gỡ bỏ: schtasks /delete /tn "SAP ABAP Agent - Daily Learner Cron Tick" /f, xoá file ENABLED/cron_manage.py disable <job-id> là đủ.

Chi tiết đầy đủ (bao gồm bảng so sánh Memory/Skill Creation/Curator/Cron với Hermes thật): skills/sap-daily-learner/SKILL.md mục "Scheduling cơ chế" + "3d. Skill Curator".

Chạy nhiều instance cùng lúc (1 profile / instance)

Đặt env SAP_BTP_PROFILE=<id> trước mỗi lần chạy:

PowerShell (Windows — khuyến nghị)

# Terminal 1: Claude 1 với profile A
$env:SAP_BTP_PROFILE = "project1.s4hana.cloud.sap"
mcp-sap-connect

# Terminal 2: Claude 2 với profile B
$env:SAP_BTP_PROFILE = "project2.s4hana.cloud.sap"
mcp-sap-connect

CMD (Windows — Command Prompt)

:: Terminal 1: Claude 1 với profile A
set SAP_BTP_PROFILE=project1.s4hana.cloud.sap
mcp-sap-connect

:: Terminal 2: Claude 2 với profile B
set SAP_BTP_PROFILE=project2.s4hana.cloud.sap
mcp-sap-connect

bash / zsh / Git Bash / WSL (macOS, Linux)

# Terminal 1: Claude 1 với profile A
SAP_BTP_PROFILE=project1.s4hana.cloud.sap mcp-sap-connect

# Terminal 2: Claude 2 với profile B
SAP_BTP_PROFILE=project2.s4hana.cloud.sap mcp-sap-connect

Cấu hình folder

%USERPROFILE%\.mcp-sap-connect\   (Windows)
~/.mcp-sap-connect/               (macOS/Linux)
+-- profiles.json                <- registry (danh sách + active)
+-- profiles/
|   +-- <profile-id>/            <- 1 folder / project SAP
|       +-- config.json
|       +-- secrets.json         <- MÃ HÓA
+-- log/
+-- cache/

Windows: secrets mã hóa bằng DPAPI qua PowerShell (gắn với tài khoản Windows).
macOS/Linux: AES-256-GCM, key derive từ hostname + username.
File mode 0o600, chỉ owner đọc/ghi.

Lưu ý: %USERPROFILE%\.sap-abap-agent\ (tên gần giống nhưng KHÁC folder trên) là nơi lưu state riêng của plugin Claude Code (memory của sap-daily-learner, cache của sap-context-tool-result-trim, session/handoff đang làm dở) — không liên quan kết nối SAP BTP. Cache/log trong đó tự dọn theo tuổi (mặc định 7 ngày, xem reference/scripts/cleanup_agent_home.py). Chi tiết: CONTRIBUTING.md mục "SAP_ABAP_AGENT_HOME".

Env

Các biến môi trường quan trọng (đặt trước khi chạy mcp-sap-connect / claude):

Tên biến	Ý nghĩa
`SAP_BTP_PROFILE=<id>`	Khóa profile cho 1 lần chạy (ưu tiên registry)
`MCP_SAP_CONNECT_HOME=/path`	Đổi folder cấu hình (test, multi-tenant)
`GITHUB_TOKEN=ghp_xxx`	Token GitHub (tự tạo issue khi error reporter bật)
`SAP_ABAP_AGENT_ERROR_REPORTING=1`	Bật error reporter (xem mục Error Reporting ở trên)

Cách đặt env tùy theo shell

PowerShell (Windows — khuyến nghị):

# Tạm thời (chỉ session hiện tại)
$env:SAP_BTP_PROFILE = "project1.s4hana.cloud.sap"

# Vĩnh viễn (cho user hiện tại, mở lại shell mới vẫn còn)
[System.Environment]::SetEnvironmentVariable("SAP_BTP_PROFILE", "project1.s4hana.cloud.sap", "User")

CMD (Windows):

:: Tạm thời (chỉ session hiện tại)
set SAP_BTP_PROFILE=project1.s4hana.cloud.sap

:: Vĩnh viễn (cho user hiện tại)
setx SAP_BTP_PROFILE "project1.s4hana.cloud.sap"

bash / zsh / Git Bash / WSL (macOS, Linux):

# Tạm thời (chỉ session hiện tại)
export SAP_BTP_PROFILE=project1.s4hana.cloud.sap

# Vĩnh viễn: thêm vào ~/.bashrc (bash) hoặc ~/.zshrc (zsh)
echo 'export SAP_BTP_PROFILE=project1.s4hana.cloud.sap' >> ~/.bashrc

Sau khi đổi vĩnh viễn, đóng và mở lại terminal / shell mới để biến có hiệu lực.

🧠 SAP Consultant System (Auto-scoring Routing Engine)

skills/sap-ask-consultant/SKILL.md là skill trung tâm, dispatch câu hỏi user tới 25 module consultants + 1 researcher + 1 daily learner + 1 reviewer bằng cơ chế keyword scoring + parallel dispatch.

Cách hoạt động

Keyword Matrix: Mỗi module có keywords với weight 3/2/1.
Tính score: Module nào >= threshold (2) thì được dispatch.
Explicit mention: "hỏi SD", "hỏi FI" → dispatch mặc định.
Module coupling: Module thường đi cùng (FI↔CO, PP→QM→MM...) tự động dispatch.
Parallel dispatch: Tất cả module >= threshold dispatch song song trong 1 message.

Ví dụ

Câu hỏi	Module dispatch
"tìm CDS view cho sales order bị chậm giao hàng"	`sap-docs-researcher` + `sap-sd-consultant-cloud` song song
"cấu hình cost center và GL"	`sap-co-consultant-cloud` + `sap-fi-consultant-cloud` (coupling)
"làm sao tạo purchase order"	`sap-mm-consultant-cloud`
"hỏi PP, QM, MM"	`sap-pp` + `sap-qm` + `sap-mm` song song
"hỏi IBP: dự báo doanh thu quý sau"	`sap-ibp-consultant-cloud` (Demand Planning)
"EWM cấu hình wave management cho kho"	`sap-ewm-consultant-cloud`
"IBP inventory optimization cho supply chain"	`sap-ibp-consultant-cloud` + `sap-mm-consultant-cloud` (coupling)
"Fiori app cho sales order"	`sap-fiori-consultant-cloud` + `sap-sd-consultant-cloud` (coupling)
"CAP side-by-side extension cho S/4HANA"	`sap-cap-consultant-cloud` + `sap-btp-admin-consultant-cloud`
"iFlow tích hợp S/4HANA với SAP SuccessFactors"	`sap-cpi-consultant-cloud` + `sap-successfactors-consultant-cloud`
"BTP destination + Cloud Connector"	`sap-btp-admin-consultant-cloud`

Các module đã có

#	Agent	Module
1	`sap-sd-consultant-cloud`	Sales & Distribution
2	`sap-fi-consultant-cloud`	Financial Accounting
3	`sap-mm-consultant-cloud`	Materials Management
4	`sap-co-consultant-cloud`	Controlling
5	`sap-pp-consultant-cloud`	Production Planning
6	`sap-qm-consultant-cloud`	Quality Management
7	`sap-pm-consultant-cloud`	Plant Maintenance
8	`sap-wm-consultant-cloud`	Warehouse Management
9	`sap-ps-consultant-cloud`	Project Systems
10	`sap-hcm-consultant-cloud`	Human Capital Management
11	`sap-bw-consultant-cloud`	Analytics / BW
12	`sap-basis-consultant-cloud`	Basis / Technical Admin
13	`sap-tm-consultant-cloud`	Transportation Management
14	`sap-tr-consultant-cloud`	Treasury & Cash Management
15	`sap-ariba-consultant-cloud`	Procurement Collaboration
16	`sap-ca-consultant-cloud`	Cross-Application Functions
17	`sap-gts-consultant-cloud`	Global Trade Services
18	`sap-ehs-consultant-cloud`	Environment, Health & Safety
19 🆕	`sap-ibp-consultant-cloud`	Supply Chain Planning (IBP)
20 🆕	`sap-ewm-consultant-cloud`	Extended Warehouse Mgmt (EWM)
21 🆕	`sap-fiori-consultant-cloud`	Fiori/UI5 (Fiori Elements, Adaptation, SAP Build)
22 🆕	`sap-cap-consultant-cloud`	CAP (Cloud Application Programming Model)
23 🆕	`sap-cpi-consultant-cloud`	CPI (Cloud Platform Integration / Integration Suite)
24 🆕	`sap-successfactors-consultant-cloud`	SuccessFactors (HXM Cloud — EC, Recruiting, LMS)
25 🆕	`sap-btp-admin-consultant-cloud`	BTP Admin (Platform; CF, Kyma, Destinations, Security)
—	`sap-docs-researcher`	CDS view & Docs Research
—	`sap-daily-learner`	Daily SAP Learning, Hermes-like skill creation

🏗️ Codegen Pipeline (Function Spec -> ABAP code)

8 skill nối tiếp nhau, biến Function Spec (.docx khách hàng gửi) thành code ABAP đã activate, review, test và sẵn sàng release, theo chuẩn RAP/CDS. File trung gian đặt trong in//out/ — thư mục local per-user, KHÔNG nằm trong git repo: %USERPROFILE%\.mcp-sap-connect\in\ + ...\out\ (Windows) hoặc ~/.mcp-sap-connect/in/ + .../out/ (macOS/Linux), cùng nơi lưu profile/secrets kết nối SAP BTP (xem mục "Cấu hình folder"). Lý do: tài liệu FS và output sinh ra là dữ liệu nghiệp vụ/khách hàng, không nên nằm chung với source code plugin (rủi ro commit nhầm lên repo public). Có thể đổi qua env MCP_SAP_CONNECT_HOME. Lấy đúng đường dẫn: python -c "from mcp_sap_connect.config.paths import get_in_dir; print(get_in_dir())".

# 0. Đặt FS vào in/ (thư mục local per-user ở trên), convert sang markdown
cp /path/to/FS_xxx.docx "$(python -c 'from mcp_sap_connect.config.paths import get_in_dir; print(get_in_dir())')/"
# -> skill sap-doc-to-md (reference/scripts/office_to_md.py, không tham số) -> out/FS_xxx.md

# 1. Phân tích FS -> chuẩn hóa yêu cầu
# -> skill sap-analyze-function-spec -> out/<ticket>/INTAKE.md

# 2. Quyết định kiến trúc (managed/unmanaged/CDS/class)
# -> skill sap-write-technical-spec -> out/<ticket>/TECHNICAL_SPEC.md

# (gate an toàn) Đo hệ thống thật + xác nhận package/namespace trước khi tạo object thật
# -> skill sap-bootstrap-system-context + sap-deployment-target

# 3. Sinh skeleton code
# -> skill sap-scaffold-rap (CRUD/RAP) hoặc sap-scaffold-cds (chỉ-read)
#    hoặc sap-scaffold-cds-analytics (Cube/Dimension/Analytical Query)
#    hoặc sap-scaffold-report (báo cáo, tự chọn CDS+Fiori/classical ALV theo edition)
#    hoặc sap-scaffold-adobe-form (in PDF qua Adobe Document Services) -> out/<ticket>/src/

# 4. Review naming/released-API/clean-ABAP
# -> skill sap-atc-review -> out/<ticket>/ATC_REVIEW.md

# 5. Sinh ABAP Unit test
# -> skill sap-unit-test hoặc sap-cds-unit-test (CDS view/RAP BO qua Test Double Framework)

# 6. Checklist đóng ticket (activation/ATC/test/transport/abapGit)
# -> skill sap-finish-ticket -> out/<ticket>/FINISH_CHECKLIST.md

Skill phụ trợ: sap-virtual-element (calculated field trong CDS). Quy ước đặt tên & bậc thang extensibility dùng chung với sap-clean-code / sap-extensibility. Khi cần tìm CDS view/API chuẩn cho 1 phân hệ cụ thể (bước 2), hỏi agent consultant tương ứng (sap-fi-consultant-cloud, sap-mm-consultant-cloud...) hoặc sap-docs-researcher.

Kỷ luật xuyên suốt (không phải bước riêng, áp dụng mọi lúc trong pipeline): sap-routing-discipline (luôn check routing trước khi trả lời — bơm tự động qua SessionStart hook), sap-verification-before-completion (bằng chứng chạy thật trước khi báo "xong"), sap-systematic-debugging (khi có bug runtime, thay vì đoán-sửa-lặp-lại).

Skill (tự động) vs Command (gõ tường minh) — phân biệt thế nào

Plugin có 2 cơ chế kích hoạt khác nhau, dễ nhầm nếu chỉ đọc code:

	Skill (`skills/*/SKILL.md`)	Command (`commands/*.md`)
Cách gọi	Tự động — Claude Code tự nhận diện ý định từ câu hỏi tự nhiên (`when_to_use`), không cần gõ tên	Tường minh — phải gõ đúng `/tên-command`
Xem danh sách	Gõ `/skills` (hoặc `/`) — Claude Code hiện mô tả rút gọn từng skill	Gõ `/` — Claude Code hiện danh sách slash command, bao gồm command riêng của plugin này
Dùng khi nào	Hầu hết các bước trong Codegen Pipeline ở trên — cứ hỏi đúng ý là tự trigger, kể cả không nhớ tên skill	Khi muốn chủ động kích hoạt cả 1 chuỗi bước cùng lúc bằng 1 lệnh, hoặc thao tác hạ tầng (cài đặt/đồng bộ)
Số lượng hiện tại	42 skill	7 command

5 command hiện có:

Command	Dùng khi
`/sap-setup`	Cài đặt toàn bộ cho máy mới, tự động hết mức có thể (pip install, đăng ký MCP) — chỉ dừng lại đúng 1 chỗ: điền file config mẫu với credential thật
`/sap-connect`	Thiết lập/quản lý profile kết nối SAP BTP
`/register-mcp-servers`	Đăng ký MCP servers vào Claude Code (1 lần). Không phải `/mcp` (OAuth). Alias cũ: `/mcp-setup`
`/sync-skills`	Đồng bộ skill/agent/command mới nhất từ GitHub
`/sap-generate-report`	Chạy nguyên pipeline sinh báo cáo từ file đặc tả — tự chọn CDS+Fiori hay classical ALV theo edition
`/sap-generate-adobe-form`	Chạy nguyên pipeline sinh class in PDF qua Adobe Document Services
`/sap-new-object`	Bản tổng quát — để `sap-write-technical-spec` tự chọn pattern (RAP/CDS/Report/Adobe Form/class thường) khi chưa chắc ticket sẽ ra loại nào

Nếu không chắc nên gõ /lệnh hay chỉ cần hỏi tự nhiên: cứ hỏi tự nhiên trước — skill routing (sap-ask-consultant, sap-routing-discipline) sẽ tự tìm đúng skill. Command chỉ cần khi muốn tắt qua nhiều bước bằng 1 lần gõ, hoặc thao tác hạ tầng không phải nghiệp vụ SAP.

Riêng /sap-setup không cần bạn tự nhớ gõ — hook hooks/first_run_check.py (SessionStart) tự kiểm tra offline mỗi phiên xem máy đã có profile SAP nào chưa; nếu chưa, Claude sẽ chủ động hỏi bạn có muốn chạy /sap-setup không. Đã có profile rồi thì hook im lặng, không hỏi lại.

Test local

cd ..
claude --plugin-dir ./sap-abap-agent

Trong Claude:

"Setup SAP BTP cho project https://project1.s4hana.cloud.sap" -> gọi wizard
"Liệt kê các profile SAP của tôi" -> gọi sap_list_profiles
"Tìm class bắt đầu bằng ZCL_ trong project project1" -> gọi sap_search với profile="project1..."
"Hỏi SD: cấu hình pricing cho sales order" -> gọi sap-sd-consultant-cloud
"Tìm CDS view cho purchase order quá hạn và hỏi MM" -> sap-docs-researcher + sap-mm-consultant-cloud
"Học SAP hôm nay" -> sap-daily-learner (daily tip + learning path)
"Quiz MM cho tôi" -> sap-daily-learner (trắc nghiệm MM)
"Cấu hình cost center và cash management" -> sap-co-consultant-cloud + sap-tr-consultant-cloud
"Fiori app cho sales order" -> sap-fiori-consultant-cloud + sap-sd-consultant-cloud
"CAP side-by-side extension cho S/4HANA" -> sap-cap-consultant-cloud + sap-btp-admin-consultant-cloud
"iFlow tích hợp S/4HANA với SuccessFactors" -> sap-cpi-consultant-cloud + sap-successfactors-consultant-cloud
"BTP destination + Cloud Connector" -> sap-btp-admin-consultant-cloud

Cập nhật

Tự động (CI/CD): mỗi lần push code vào main, GitHub Actions bump version trong plugin.json, tạo git tag vX.Y.Z — Claude Code marketplace tự động phát hiện và nhắc bạn cập nhật plugin.

Local (1 lệnh):

# Windows (PowerShell)
.\reference\scripts\update.ps1

# Linux / macOS
bash reference/scripts/update.sh

Script tự động: git pull plugin → tải wheel .whl mới nhất từ GitHub Release → pip install --upgrade.

Lỗi thường gặp

Lỗi	Cách sửa
`401 Unauthorized`	Client_secret sai / hết hạn. Chạy `setup <profile-id>`
`404 /oauth/token`	Sửa `tokenUrl` trong `profiles/<id>/secrets.json`
`Khong giai ma duoc secret`	Đổi máy. Chạy `setup <profile-id>` để tạo lại
`Chua co profile nao`	Chạy `mcp-sap-connect setup <URL>`
`'mcp-sap-connect' is not recognized`	PATH thiếu folder chứa entry point. Chạy `python -m mcp_sap_connect.doctor` để tự phát hiện + lấy lệnh fix

Trạng thái

Xem CHANGELOG.md để biết trạng thái/tính năng mới nhất — mục này không còn duy trì số liệu riêng để tránh lệch với badge version ở đầu file.

Cảm hứng (Inspired by)

Plugin tham khảo và lấy cảm hứng từ các dự án open-source dưới đây (tất cả đều đã được tích hợp hoặc tham khảo pattern, không fork):

Cùng lĩnh vực SAP / ABAP

secondsky/sap-skills — plugin AI coding assistant production-ready (BTP, CAP, Fiori, ABAP, HANA, Analytics Cloud, Datasphere). Tham khảo cấu trúc skill/manifest.
marcellourbani/vscode_abap_remote_fs — VS Code agentic AI platform cho ABAP development.
google/ai-abap-assistant-sample — Genie for SAP (code explain / review / suggest). Tham khảo cho skill sap-atc-review mục "RAG Review Pattern".
microsoft/aisdkforsapabap — AI SDK cho ABAP.
oisee/zllm — LangChain-lite cho ABAP.
ClementRingot/ROSA — MCP server cho Released Objects. Tham khảo cho skill sap-released-classes mục "Released-Object search pattern".
google-cloud-abap/demo-hpro — RAG với Vertex AI SDK for ABAP.
Chirag-Dwivedi/SAP_ABAP_RAG_Chatbot — RAG chatbot SAP/ABAP. Tham khảo pattern retrieval.
IaManBel/sap-abap-rag-refactorer — RAG cho ABAP refactor.
Gixsy95/abap_wiki — Agent-driven knowledge base cho S/4HANA custom objects.

MCP servers tham khảo (xem chi tiết trong `docs/sap-mcp-recommendations.md`)

Curriculum / learning tham khảo (cho `sap-daily-learner`)

anfisc/abap-rap-introduction, msg-CareerPaths/sap-abap-internship, KlamGit/sap-basic-abap, skalmodiya/sap-ai-core-launchpad.

Công nghệ nền

NousResearch/hermes-agent — nguồn cảm hứng cho sap-daily-learner (persistent memory + auto-skill + curator).
agent-skills-for-context-engineering — pattern memory-systems + context engineering (đã nhắc trong README ở mục "Context Engineering").

Cách đóng góp thêm

Nếu bạn biết repo open-source khác cùng chủ đề, mở issue / PR thêm vào mục này. Tiêu chí:

Repo có tài liệu rõ ràng.
Mã nguồn công khai, license cho phép tham khảo (MIT / Apache-2.0 / BSD…).
Đã được maintain trong 6 tháng gần nhất.

Tài liệu

File	Mục đích
`docs/onboarding-guide.md`	Hướng dẫn end-user cài đặt + dùng thử
`docs/rollout-guide.md`	Rollout nhiều user / team (OS account, MCP Core)
`docs/sap-mcp-recommendations.md`	Khuyến nghị MCP server bổ sung (Tier 1/2/3, opt-in)
`CONTRIBUTING.md`	Hướng dẫn đóng góp skill/agent/docs
`SKILL_TEMPLATE.md`	Template chuẩn để tạo skill/agent/reference module
`CODE_OF_CONDUCT.md`	Quy tắc ứng xử cộng đồng
`CHANGELOG.md`	Lịch sử thay đổi
`SECURITY.md`	Chính sách bảo mật
`LICENSE`	MIT License

Name		Name	Last commit message	Last commit date
.claude-plugin		.claude-plugin
.github		.github
.reuse		.reuse
agents		agents
commands		commands
docs		docs
gui-native		gui-native
hooks		hooks
reference		reference
skills		skills
tests		tests
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.mcp.json		.mcp.json
.mcp.json.example		.mcp.json.example
.pre-commit-config.yaml		.pre-commit-config.yaml
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
KNOWN_LIMITATIONS.md		KNOWN_LIMITATIONS.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
REUSE.toml		REUSE.toml
SECURITY.md		SECURITY.md
SKILL_AUDIT.md		SKILL_AUDIT.md
SKILL_TEMPLATE.md		SKILL_TEMPLATE.md
index.html		index.html
pyproject.toml		pyproject.toml

Latest commit

History

Folders and files

Repository files navigation

SAP ABAP Agent (Tiếng Việt)

Nổi bật

Đóng góp

Cấu trúc

Migration từ bản 1.x

Hỗ trợ đa hệ thống (5 edition)

Cài đặt (1 lần)

Thêm project SAP mới

Quản lý nhiều profile

Kiểm tra kết nối

GUI desktop (khuyến nghị: native Tauri)

Legacy: Tkinter GUI (pip extra [gui])

License dashboard (xem cookie/token còn hạn bao lâu)

Đăng ký MCP với Claude Code

MCP server phụ trợ: tra cứu CDS view & SAP docs

Notion — skill notes dùng chung cho team

🤖 Continuous Improvement Engine — Tự động phát hiện lỗi & tạo issue

Các chế độ hook

Matching fix với error

Kiểm tra trạng thái

Ai cũng có local report — không cần GitHub

Tạo GitHub issue (optional — có auth thì tự động)

MCP server mới: tra cứu SAP Notes

MCP server mới: SAP GUI Automation (Windows)

MCP server mới: ADT ABAP Development (3 lựa chọn)

MCP server mới: SAP SuccessFactors (2 options)

MCP server mới: SAP Concur Travel & Expense

MCP server mới: SAP Fieldglass Services Procurement

MCP server mới: Chrome DevTools (debug web / Fiori-UI5)

📚 SAP Daily Learner — Skill Curator & Cron thật (Hermes-like)

🧹 Skill Curator — vòng đời skill tự động

⏰ Cron thật — daily tip chạy nền qua Windows Task Scheduler

Chạy nhiều instance cùng lúc (1 profile / instance)

Cấu hình folder

Env

Cách đặt env tùy theo shell

🧠 SAP Consultant System (Auto-scoring Routing Engine)

Cách hoạt động

Ví dụ

Các module đã có

🏗️ Codegen Pipeline (Function Spec -> ABAP code)

Skill (tự động) vs Command (gõ tường minh) — phân biệt thế nào

Test local

Cập nhật

Lỗi thường gặp

Trạng thái

Cảm hứng (Inspired by)

Cùng lĩnh vực SAP / ABAP

MCP servers tham khảo (xem chi tiết trong docs/sap-mcp-recommendations.md)

Curriculum / learning tham khảo (cho sap-daily-learner)

Công nghệ nền

Cách đóng góp thêm

Tài liệu

About

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Legacy: Tkinter GUI (pip extra `[gui]`)

MCP servers tham khảo (xem chi tiết trong `docs/sap-mcp-recommendations.md`)

Curriculum / learning tham khảo (cho `sap-daily-learner`)