fix(sk): 恢复 SKILL.md 到团队版 (607445b)

pack 误用源码 SKILL.md.tmpl (中文详细版) 覆盖了分发仓库的英文工作流版,

丢失了 Standard Workflow / Gitee仓库规范 / 错误知识库等内容。

本次只恢复 SKILL.md; 2.3.0 代码更新 (info 字段) 保留。

SKILL.md

@@ -1,332 +1,238 @@
 ---
 name: sap-cli
-description: "Use when you need to operate SAP ABAP development objects — syncing code, querying metadata, managing transports, reading tables, or any task involving SAP ADT REST API. Trigger on: ABAP objects, SAP development, transport requests, DDIC types, SE11/SE16N/SE38/SE80 equivalents, 'sync to SAP', 'download from SAP', 'activate ABAP', 'read SAP table'. NOT for developing sap-cli itself."
+description: "SAP ABAP ADT CLI for AI agents. Trigger when: operating ABAP objects, syncing code to/from SAP, managing transports, querying DDIC, running ABAP programs, reading SAP tables, or any SAP development task via terminal."
 version: "2.3.0"
 author: WuRangyu
 license: MIT
+triggers:
+  - "ABAP development"
+  - "sync to SAP"
+  - "download from SAP"
+  - "SAP transport request"
+  - "DDIC/SE11/SE16N/SE38/SE80"
+  - "SAP ADT REST API"
 ---
 
-# sap-cli — SAP ABAP 开发对象管理工具
+# sap-cli — SAP ABAP Development Object Management
 
-sap-cli 是一个 Python CLI，封装 SAP ADT REST API，让你在终端完成 ABAP 开发对象的完整生命周期管理。
+Python CLI wrapping the SAP ADT REST API. Manages the full lifecycle of ABAP development objects from the terminal. Core loop: **download → local edit → sync back to SAP**.
 
-核心工作流：**download → 本地编辑 → sync 回 SAP**
-
----
-
-## 首次使用：安装与配置
-
-### 第 1 步：安装 sap-cli
-
-如果 `python main.py --help` 无法执行，先运行安装脚本：
+## Quick Start
 
 ```bash
-python <SKILL_DIR>/scripts/setup.py install
-```
-
-此脚本会：
-1. 安装依赖（`requests`）
-2. 将 sap-cli 安装为可编辑的 Python 包
-3. 创建配置文件模板
-
-安装完成后验证：
-```bash
-python main.py --help
-```
-
-### 第 2 步：配置 SAP 连接
-
-编辑配置文件 `assets/config.ini`（从 `config.ini.example` 复制）：
-
-```ini
-[SAP]
-host = http://your-sap-server:8000
-client = 100
-user = your_username
-password = your_password
-```
-
-也可通过环境变量配置（优先级高于配置文件）：
-- `SAP_HOST` / `SAP_CLIENT` / `SAP_USER` / `SAP_PASSWORD`
-
-### 第 3 步：验证连接
-
-```bash
-python main.py config show
-python main.py transport list
-```
-
----
-
-## 调用方式
-
-```bash
-cd <SKILL_DIR>/assets && python main.py <command> [options]
-```
-
-全局参数（在命令之前）：
-
-| 参数 | 说明 |
-|------|------|
-| `--profile <name>` | 使用指定配置 profile |
-| `--verify-ssl` | 启用 SSL 验证（默认关闭） |
-
----
-
-## 命令速查
-
-### CRUD（对象生命周期）
-
-```bash
-# 创建新对象
-python main.py create --name ZMY_CLASS --type class --corr_nr DEVK901XXX
-python main.py create --name ZMY_DOMAIN --type domain --definition domain.json --corr_nr DEVK901XXX
-
-# 查询元数据
-python main.py info --name ZMY_CLASS --type class
-
-# 下载源码
+# 1. Single object: download → edit → sync
 python main.py download --name ZMY_CLASS --type class --path ./src
-
-# 同步到 SAP（lock → write → unlock → syntax check → activate）
+# edit ./src/zmy_class.abap
 python main.py sync --name ZMY_CLASS --type class --path ./src/zmy_class.abap --corr_nr DEVK901XXX
 
-# 删除对象
-python main.py delete --name ZMY_CLASS --type class
-
-# 单独激活（sap-cli 内置 NW 7.40 double-activate）
-python main.py activate --name ZMY_CLASS --type class --corr_nr DEVK901XXX
-
-# 单独上传（仅锁定→写入→解锁，不检查不激活）
-python main.py upload --name ZMY_CLASS --type class --path ./src/zmy_class.abap --corr_nr DEVK901XXX
-
-# 语法检查（检查远程对象，不上传不激活）
-python main.py syntax-check --name ZMY_CLASS --type class
-```
-
-**create 关键参数**：
-
-| 参数 | 说明 |
-|------|------|
-| `--description` | 对象描述 |
-| `--source <.abap>` | 自定义源码文件 |
-| `--definition <.json>` | DDIC 定义文件（domain/dataelement/table/structure/tabletype） |
-| `--package <name>` | SAP 包（默认 `$TMP`） |
-| `--corr_nr` | 传输请求号 |
-
-### 批量操作
-
-```bash
-# 初始化项目结构
-python main.py init --path ./my_project
-
-# 刷新对象状态
-python main.py refresh --path ./my_project
-
-# 批量同步（自动按依赖拓扑排序）
+# 2. Batch project sync (auto dependency-ordered)
+python main.py init --path ./my_project          # add objects under src/
 python main.py sync --all --path ./my_project --corr_nr DEVK901XXX
-python main.py sync --all --path ./my_project --corr_nr DEVK901XXX --dry-run
-```
 
-依赖排序：`domain(10) → dataelement(20) → table(30) → tabletype(40) → interface(50) → class(60) → function(70) → report(80)`
-
-### 数据查询
-
-```bash
-# 表结构（SE11 等价）
+# 3. Table query: structure (SE11) + data (SE16N)
 python main.py show-table --name ZMY_TABLE
-
-# 表数据（SE16N 等价）
-python main.py read-table --name ZMY_TABLE
-python main.py read-table --name ZMY_TABLE --fields "FIELD1,FIELD2" --where "FIELD1 = 'X'" --max-rows 50
-
-# 列出对象
-python main.py list --type class --package ZSAPILOT
-
-# Where-Used
-python main.py whereused --name ZMY_CLASS --type class
-
-# 源码搜索
-python main.py search --query "CALL FUNCTION 'Z_MY_FUNC'"
+python main.py read-table --name ZMY_TABLE --fields "F1,F2" --where "F1 = 'X'" --max-rows 50
 ```
 
-### 远程执行
+## Command Reference
 
+Global params (before command): `--profile <name>`, `--verify-ssl`. Optional params in `[ ]`.
+
+| Category | Command | Key Parameters |
+|----------|---------|----------------|
+| CRUD | `create` | `--name --type [--description --source <.abap> --definition <.json> --package <$TMP> --corr_nr]` |
+| CRUD | `info` | `--name --type` [^1] |
+| CRUD | `download` | `--name --type --path` |
+| CRUD | `sync` | `--name --type --path --corr_nr` **(REQUIRED)** |
+| CRUD | `delete` | `--name --type` |
+| CRUD | `activate` | `--name --type --corr_nr` (built-in NW 7.40 double-activate) |
+| CRUD | `upload` | `--name --type --path --corr_nr` (lock→write→unlock only; no check/activate) |
+| CRUD | `syntax-check` | `--name --type` (remote object; no upload/activate) |
+| Batch | `init` | `--path` |
+| Batch | `refresh` | `--path` |
+| Batch | `sync --all` | `--path --corr_nr [--dry-run]` |
+| Batch | `analyze` | `--path` (dependency analysis) |
+| Query | `show-table` | `--name` (SE11 structure) |
+| Query | `read-table` | `--name [--fields --where --max-rows]` (SE16N data) |
+| Query | `list` | `--type [--package --prefix]` |
+| Query | `whereused` | `--name --type` |
+| Query | `search` | `--query` |
+| Query | `diff` | `--name --type --path` (local vs SAP) |
+| Transport | `transport list` | — |
+| Transport | `transport info` | `--corr_nr` |
+| Transport | `transport release` | `--corr_nr` |
+| Transport | `transport objects` | `--corr_nr` |
+| Config | `config show` | — |
+| Config | `config list-profiles` | — |
+| Config | `config set` | `<key> <val>` |
+| Config | `auth login` / `auth status` | password stored in keyring |
+| Other | `run-program` | `--name` (SA38) |
+| Other | `check` | `--name --type` (ATC) |
+| Other | `format` | `--name --type` (Pretty Printer) |
+| Other | `package create` | `--name` |
+| Other | `cds download` | `--name --path` |
+| Other | `scaffold` | `--name --template <t>` — alv-report, bapi-wrapper, interface-class, data-model |
+
+[^1]: ⚠️ `info` 不返回 `package`/`packageRef` 字段。需通过 ADT API 查询：`GET /sap/bc/adt/programs/programs/<name>` 返回 XML 中含 `<adtcore:packageRef>`。也可用 `list --package <pkg>` 反向查找。
+
+Batch sync dependency order: `domain(10) → dataelement(20) → table(30) → tabletype(40) → interface(50) → class(60) → function(70) → report(80)`.
+
+Step-wise sync for lock-heavy automation — split the atomic `sync` when lock conflicts are frequent; upload now, verify, activate later:
 ```bash
-# 执行 ABAP 程序（SA38 等价）
-python main.py run-program --name ZSAPILOT_SETUP
-
-# 本地 vs SAP 差异
-python main.py diff --name ZMY_CLASS --type class --path ./src/zmy_class.abap
+python main.py upload --name ZMY_CLASS --type class --path ./src/zmy_class.abap --corr_nr DEVK901XXX   # lock→write→unlock only
+python main.py syntax-check --name ZDEPENDENT_REPORT --type report                                    # verify dependents (no upload)
+python main.py activate --name ZMY_CLASS --type class --corr_nr DEVK901XXX                            # activate once clean
 ```
 
-### 传输请求
+### Supported Object Types (16)
 
-```bash
-python main.py transport list
-python main.py transport info --corr_nr DEVK901XXX
-python main.py transport release --corr_nr DEVK901XXX
-python main.py transport objects --corr_nr DEVK901XXX
-```
-
-### 配置与认证
-
-```bash
-python main.py config show
-python main.py config list-profiles
-python main.py config set host s4h.example.com
-python main.py auth login      # 密码保存到 keyring
-python main.py auth status
-```
-
-### 其他
-
-```bash
-python main.py check --name ZMY_CLASS --type class          # ATC 检查
-python main.py format --name ZMY_CLASS --type class         # Pretty Printer
-python main.py package create --name ZSAPILOT               # 创建包
-python main.py cds download --name ZMY_CDS --path ./src     # CDS View
-python main.py analyze --path ./src                          # 依赖分析
-python main.py scaffold --name ZMY_RPT --template alv-report  # 项目模板
-# 模板: alv-report, bapi-wrapper, interface-class, data-model
-```
-
----
-
-## 支持的对象类型（16 种）
-
-| 分类 | 类型 | 有源码 |
-|------|------|--------|
-| 程序 | `report`, `include` | ✅ |
+| Category | Types | Has source |
+|----------|-------|------------|
+| Programs | `report`, `include` | ✅ |
 | OOP | `class`, `interface` | ✅ |
-| 函数 | `function` | ✅ |
-| DDIC 基础 | `domain`, `dataelement`, `table`, `structure` | ✅ |
-| DDIC 扩展 | `cdsview`, `view` | ✅ |
-| DDIC 无源码 | `tabletype`, `messageclass`, `searchhelp`, `lockobject` | ❌ |
-| 程序组 | `functiongroup` | ❌ |
+| Functions | `function` | ✅ |
+| DDIC base | `domain`, `dataelement`, `table`, `structure` | ✅ |
+| DDIC ext | `cdsview`, `view` | ✅ |
+| DDIC no-source | `tabletype`, `messageclass`, `searchhelp`, `lockobject` | ❌ |
+| Groups | `functiongroup` | ❌ |
 
-**函数命名格式**：必须使用 `组名/模块名` 格式，如 `ZMY_FGROUP/Z_MY_FUNC`
+**Function naming**: must use `group/module`, e.g. `ZMY_FGROUP/Z_MY_FUNC`.
 
----
+## ⚠️ Constraints (HARD RULES — DO NOT VIOLATE)
 
-## 常用工作流
+Full rules: `references/sap-tool-constraints.md`. Violations are intercepted by hooks.
+质检标准: `references/abap-coding-rules.md`（28条规则，6大类：安全/性能/可维护性/错误处理/NW740兼容/风格）。质检员在代码审计时以此文档为唯一标准，判定体系：✅合规 / ❌违反（必须修复） / ⚠️建议（推荐修复）。
 
-### 1. 单对象编辑同步
+1. **Only `python main.py <cmd>` touches SAP** — no `requests`/`urllib`, no curl to ADT/SOAP/RFC, no `python -c` inline, no importing `ADTClient` internals, no hand-built ADT XML. Exceptions: `run-program` custom reports, explicit user request, or developing sap-cli itself.
+2. **Never modify SAP standard objects** (`CL_*`, `CX_*`, `IF_*`, `SAPL*`, or any non-user original system) — read-only only: download/info/list/search/whereused/show-table/read-table/diff. When unsure, ask the user.
+3. **Never write system tables** (TADIR, E071, SEOCLASS, REPOSRC, D010SINF, T000, TDEVC, TSTC) — read-only SELECT is fine; any write needs explicit authorization.
+4. **`sync` must carry `--corr_nr`** — otherwise it triggers an interactive transport-request prompt.
+5. **Non-interactive `delete` needs piped confirm** — `echo "yes" | python main.py delete ...` (else EOFError).
+6. **DDIC `sync` failure on NW 7.40 (HTTP 406) is a system limit** — do not retry; report to the user for SE09.
 
-```bash
-python main.py download --name ZMY_CLASS --type class --path ./src
-# 用编辑器修改 ./src/zmy_class.abap
-python main.py sync --name ZMY_CLASS --type class --path ./src/zmy_class.abap --corr_nr DEVK901XXX
+## 🔄 Standard Workflow（SAP 对象操作标准流程）
+
+> 所有 SAP 对象修改操作必须按此顺序执行，不得跳过或调整步骤顺序。
+
+```
+步骤1  info — 确认程序存在、已激活、关联请求号
+       ├─ 有请求号 → 记录
+       └─ 无请求号 → transport list 找老板的请求号推荐
+                      → 无合适的则帮老板新建（含请求描述）
+
+步骤2  download — 源码下载到本地
+
+步骤3  五角色流水线：研究员 → 创作者 → 质检 → 老板批准
+
+步骤4  建 Gitee 仓库（ADT 层级：src/包/类型/对象/）+ 同步确认请求号
+       └─ 请求号写入 doc 文档
+
+步骤5  工程师改代码（本地，不 commit）
+
+步骤6  请求号绑定对象（如 SE09 未自动绑定）
+
+步骤7  sync --corr_nr → 语法检查 → 迭代修复 → 激活成功
+       └─ 全程带请求号，不要到编译阶段才关联
+
+步骤8  激活成功 → git commit + tag → push
+       └─ git = 细粒度变更追溯 / 请求号 = 系统大版本管理
 ```
 
-### 2. 批量项目同步
+**核心原则：**
+- info 同时查请求号，不单独处理
+- 建 Gitee 仓库同时确认请求号，不滞后
+- sync 全程带 `--corr_nr`，不等编译阶段补
+- 只有激活成功才 git commit，不是每次本地改就提交
+- git 管变更细节，请求号管系统大版本
 
-```bash
-python main.py init --path ./my_project
-# 添加对象到 src/ 目录
-python main.py sync --all --path ./my_project --corr_nr DEVK901XXX
+## 📦 Gitee仓库规范
+
+### 目录结构（ADT 层级）
+
+每个 SAP 项目的 Gitee 仓库按 ADT 层级组织源码：
+
+```
+sap-<project-name>/
+├── src/
+│   └── <package>/              # SAP 包名（如 $ZIDTR）
+│       ├── report/             # 程序类型目录
+│       │   └── ZXXX.abap       # ABAP 源码（.abap 扩展名）
+│       ├── class/
+│       │   └── ZCL_XXX.abap
+│       ├── interface/
+│       │   └── ZIF_XXX.abap
+│       ├── function/
+│       │   └── ZGROUP_ZFUNC.abap
+│       ├── domain/
+│       ├── dataelement/
+│       ├── table/
+│       └── ...
+├── doc/                        # 文档（请求号记录、设计说明）
+│   └── transport-<corr_nr>.md  # 每次传输的请求号记录
+├── references/                 # 参照文档
+└── log/                        # 错误知识库
 ```
 
-### 3. DDIC 对象创建
+### 请求号同步确认
 
-```bash
-# 准备 JSON 定义文件
-python main.py create --name ZMY_DOMAIN --type domain --definition domain.json --corr_nr DEVK901XXX
-```
+1. **创建仓库时**：确认传输请求号（`transport list` 或 `transport info --corr_nr DEVK9XXXXX`），写入 `doc/transport-<corr_nr>.md`
+2. **每次 sync 前**：确认请求号仍有效（未释放、未满），检查 `transport objects --corr_nr DEVK9XXXXX` 确保对象已绑定
+3. **激活成功后**：更新 `doc/` 记录本次变更摘要
+4. **仓库命名建议**：`sap-<package-name>`，小写、hyphen 分隔，如 `sap-zidtradmin`
 
-### 4. 数据查询
+### Git 提交时机
 
-```bash
-python main.py show-table --name ZMY_TABLE           # 结构
-python main.py read-table --name ZMY_TABLE --max-rows 100  # 数据
-```
+- **只有 `sync` 激活成功后才 git commit**，不是每次本地修改就提交
+- commit message 包含：对象名 + 请求号 + 变更摘要
+- tag 使用请求号命名：`DEVK9XXXXX`
+- git 管变更细节追溯，请求号管系统大版本管理
 
-### 5. 远程执行 ABAP 程序
+## Error Handling (Quick Reference)
 
-```bash
-python main.py run-program --name ZSAPILOT_SETUP
-```
+错误知识库: `log/` 目录（LLM-WIKI 格式），每个错误独立一页。**先查 log/，再查 `references/error-handling.md`**。新错误按 `log/SCHEMA.md` 规范入库。
 
-### 6. 分步操作（上传→检查→激活）
+Full flow: `references/error-handling.md`.
 
-```bash
-# 适合锁定冲突频繁的自动化场景：先安全上传，稍后再激活
-python main.py upload --name ZMY_CLASS --type class --path ./src/zmy_class.abap --corr_nr DEVK901XXX
+| Error Pattern | Action |
+|---|---|
+| HTTP 406 (DDIC Lock) | System limit — report to user → SE09 manual DDIC sync |
+| HTTP 403 (Locked) | Residual enqueue lock — try `run-program` clear-locks report, then SM12 |
+| HTTP 400 (SaveFailure) | Class DEFINITION mismatch — diff local vs SAP source |
+| HTTP 404 (DDIC download/sync) | NW 7.40 has no `/source/main` endpoint (7.50+) — DDIC objects only create/info/delete |
+| HTTP 423 (Transport lock) | Object bound to transport — report to user → SE09 |
+| HTTP 500 (set_source) | Lock 成功但写入 500，传输请求中无对象 → SE09 手动添加对象到请求 → `log/adt-set-source-500.md` |
+| Activate fails, still inactive | double-activate built-in; still fails → report → SE09 |
+| Open SQL @ 转义不一致 | 语法检查 2 错误——一处用 `@` 则全局必须一致（`WHERE field = @lv_var` → `INTO TABLE @lt_data`） → `log/adt-nw740-open-sql-consistency.md` |
+| `WITH EMPTY KEY` dump | NW 7.40 unsupported — use `WITH NON-UNIQUE KEY` / `WITH DEFAULT KEY` |
+| Function name error | Missing `/` separator — use `ZGROUP/Z_FUNC` |
+| EOFError on delete | Non-interactive — prepend `echo "yes" \|` |
 
-# 修改表结构后验证关联程序语法
-python main.py syntax-check --name ZDEPENDENT_REPORT --type report
+General flow: **diagnose** (params / file / transport / network / object existence) → **usage error**: fix & retry → **sap-cli limit**: report, never bypass → **SAP limit**: exhaust automation below → **confirmed un-automatable**: request SAP GUI op.
 
-# 确认无问题后单独激活
-python main.py activate --name ZMY_CLASS --type class --corr_nr DEVK901XXX
-```
+Automation fallbacks — exhaust in order before requesting any SAP GUI action:
+1. **Adjust params** — different `--corr_nr`, or `--dry-run` to preview a batch before committing.
+2. **`run-program` workaround** — sync + run a helper report (e.g. `ZSAPILOT_CLEAR_LOCKS`) to clear residual enqueue locks.
+3. **`delete` + recreate** — only if the object needs a full rewrite; `delete` may fail with HTTP 423 (transport-bound) → then it is SE09.
+4. **`activate` retry** — double-activate is built in; if it still fails, stop retrying and report — do not chase other activation strategies.
 
----
+- **Never bypass sap-cli** (no requests / curl / ADTClient) — report the failure and its cause.
+- **Give the complete change checklist at once** — do the full comparison first (`show-table` vs code field refs); never surface issues incrementally.
+- **System-table writes** — 4-step authorization: explain *** → list exact statements → state risks & alternatives → await explicit approval.
 
-## ⚠️ 使用约束（必须遵守）
+## NW 7.40 Compatibility (E2E verified — v2.3.0)
 
-> 详细规则见 `references/sap-tool-constraints.md` 和 `references/error-handling.md`
+Full matrix: `docs/NW740-COMPATIBILITY.md`.
 
-1. **只使用 `python main.py <命令>` 操作 SAP** — 禁止用 requests、curl 直接调 ADT/SOAP
-2. **禁止修改 SAP 标准对象**（`CL_*`、`SAPL*` 等）— 只允许只读操作
-3. **禁止未授权操作系统表**（TADIR、E071、SEOCLASS 等）— SELECT 诊断可以
-4. **sync 必须带 `--corr_nr`** — 否则触发交互提示
-5. **非交互 delete 用管道确认** — `echo "yes" | python main.py delete ...`（否则 EOFError）
+| Availability | Types |
+|---|---|
+| Full (download → edit → sync closed loop) | `report`, `class`, `interface`, `function`, `functiongroup`, `include` |
+| CRUD only (create/info/delete, no source edit) | `domain`, `dataelement` — DDIC stored as XML at object URI, no `/source/main` endpoint (7.50+ feature) |
+| Endpoint missing (404/415) | `table`, `structure`, `tabletype`, `view`, `messageclass`, `searchhelp`, `lockobject`, `cdsview` |
 
----
-
-## 常见问题速查
-
-| 问题 | 原因 | 解决 |
-|------|------|------|
-| HTTP 406（DDIC sync Lock） | NW 7.40 DDIC sync 路径 lock 仍 406（delete 已修复） | 报告用户 → SE09 手动同步 DDIC |
-| HTTP 403（Locked） | 残留 enqueue lock | 先试 `run-program` 清锁，不行 → SM12 |
-| HTTP 400（SaveFailure） | 类 DEFINITION 与 SAP 不一致 | 对比本地 vs SAP 源码 |
-| HTTP 404（DDIC download/sync） | NW 7.40 无 `/source/main` 端点（7.50+ 特性） | DDIC 对象只能 create/info/delete，不能 download/sync |
-| HTTP 423（Transport lock） | 对象绑定在传输请求中 | 报告用户 → SE09 |
-| 激活失败 | NW 7.40 ADT 限制 | sap-cli 内置 double-activate，仍失败 → SE09 |
-| `WITH EMPTY KEY` dump | NW 7.40 不支持 | 改用 `WITH NON-UNIQUE KEY` |
-| 函数名格式错误 | 缺少 `/` 分隔符 | 使用 `ZGROUP/Z_FUNC` 格式 |
-
-## NW 7.40 兼容性（真实系统 E2E 验证 — v2.2.1）
-
-> 完整矩阵见 `docs/NW740-COMPATIBILITY.md`
-
-### 完整可用（download → 编辑 → sync 全闭环）
-
-`report` · `class` · `interface` · `function` · `functiongroup` · `include`
-
-### 仅 CRUD 可用（create/info/delete，无源码编辑）
-
-`domain` · `dataelement` — NW 7.40 的 DDIC 对象以 XML 存储于对象 URI，没有独立的 source/main 端点（7.50+ 特性）。即便 Eclipse ADT 在 7.40 上也无法编辑 DDIC 源码。
-
-### 端点缺失（代码已就位，待更高版本验证）
-
-`table` · `structure` · `tabletype` · `view` · `messageclass` · `searchhelp` · `lockobject` · `cdsview` — NW 7.40 ADT 端点层返回 404/415，请求未到达 XML 解析。
-
-### 其他 NW 7.40 特性
-
-- **DDIC Lock**：delete 已修复（专用 Accept 头），sync 路径仍 406
-- **激活误报**：首次激活可能报失败但实际成功，sap-cli 已内置 double-activate
-- **ABAP 语法限制**：不支持字符串模板 `\|...\|`、inline 声明 `DATA(...)`、`WITH EMPTY KEY`
-- **CSRF Token**：所有写操作必须携带，sap-cli 自动处理
-
----
-
-## 分发与安装（团队成员）
-
-### 方式 1：Hermes Agent
-```bash
-git clone <gitee-url> ~/AppData/Local/hermes/skills/productivity/sap-cli
-python ~/AppData/Local/hermes/skills/productivity/sap-cli/scripts/setup.py all
-```
-
-### 方式 2：Claude Code
-```bash
-git clone <gitee-url> ~/.claude/skills/sap-cli
-python ~/.claude/skills/sap-cli/scripts/setup.py all
-```
-
-安装后验证：
-```bash
-cd <SKILL_DIR>/assets && python main.py --help
-```
+NW 7.40 specifics:
+- **DDIC Lock** — `delete` fixed (dedicated Accept header); `sync` still 406.
+- **Activation false-negative** — first activate may report failure but actually succeed; double-activate is built in.
+- **ABAP syntax limits** — no string templates `\|...\|`, no inline `DATA(...)`, no `WITH EMPTY KEY`.
+- **Open SQL @ 转义一致性** — NW 7.40 要求一处用 `@` 则全 SQL 必须一致（`WHERE field = @lv_var` → `INTO TABLE @lt_data`），混用导致语法检查 2 错误。详见 `log/adt-nw740-open-sql-consistency.md`。
+- **set_source HTTP 500（传输请求无对象）** — Lock 成功但写入 500，根因：Lock API 创建锁句柄但未绑定对象到传输请求。NW 7.40 需 SE09 手动添加对象。详见 `log/adt-set-source-500.md`。
+- **CSRF token** — all writes require it; sap-cli handles automatically.