refactor: 本仓升为唯一源（原 sap-cli 源码仓归档）
方向反转：此前 SKILL.md 是「模板渲染产物」、sap-cli 是源；现 sap-cli 归档， sap-cli-skill 承接开发与分发，SKILL.md 回归手工维护的正本。 迁移（来自 sap-cli，共 104 文件）： - tests/ 692 例测试（15 个文件的内联 sys.path 改指 assets/） - openspec/ SDD 规格与归档变更（42 文件） - docs/ 开发文档与 ADT 原理（含 dev/CLAUDE.md、AGENTS.md） - .claude/ rules 副本 + settings.json（供 Claude Code） - .github/ .hermes/ .pre-commit-config.yaml .editorconfig CLAUDE.md - scripts/ 保持仅 setup.py（pack_skill.py 已随旧仓归档，不迁） 修复（迁移暴露的真实缺陷）： - assets/pyproject.toml 的 build-backend 写作 `setuptools.backends._legacy:_Backend`， 该模块在 setuptools 中不存在 → `pip install -e` 从来装不上。改为 build_meta。 实测：临时 venv 安装成功，sap-cli --help 正常列出 31 个命令 - pyproject readme 指向不存在的 assets/README.md（editable 安装会失败）→ 改内联文本 - pyproject urls 改指 sap-cli-skill 机制调整： - .github/workflows/ci.yml 适配 assets/ 布局；顶部注明该工作流仅 GitHub 执行， 本仓在 Gitee 不会自动跑 - pre-commit 增本地测试门禁（Gitee 上真正生效的那道） - .gitignore 合并旧仓完整规则（保留 log/ 下 md 知识库入库，只忽略运行日志） - 大文件上限 100KB→1MB（架构图 512KB） 守卫测试 tests/unit/test_repo_guards.py（10 → 18 例）： - SKILL.md 须记录 parser 全部 CLI 命令 / 铁律 1-5 须为真实小节标题 / 示例不得违反铁律 5 - references/ 规则齐备；.claude/rules 与 references 必须一致（实测抓到一次真实漂移） - VERSION == sapcli.__version__ == README 版本 - 仓内不得再出现 pack_skill.py / skill-src（防废弃流程回潮） 698 tests OK；editable 安装与 CLI 入口经临时 venv 实测通过。 docs/RELEASING.md 重写为单源开发流程。
This commit is contained in:
吴让宇
+4
@@ -0,0 +1,4 @@
|
||||
schema: spec-driven
|
||||
change: p1-cds-whereused-diff-transport-package
|
||||
status: archived
|
||||
archived_at: "2026-06-09"
|
||||
+26
@@ -0,0 +1,26 @@
|
||||
# Proposal: P1 — CDS View + Where-Used + Diff + 传输管理 + 包操作
|
||||
|
||||
## Why
|
||||
|
||||
S/4HANA 现代化开发以 CDS View 为核心，支持 CDS 是战略必需。Where-Used 引用查询帮助开发者评估变更影响。代码差异对比防止误覆盖。传输请求和包管理是 SAP 运维的基础能力。
|
||||
|
||||
## What Changes
|
||||
|
||||
- CDS View 的下载和创建
|
||||
- Where-Used 引用查询
|
||||
- 本地 vs SAP 代码差异对比
|
||||
- 传输请求高级管理（list/info/release/objects）
|
||||
- ABAP 包操作（create/info）
|
||||
|
||||
## Capabilities
|
||||
|
||||
### Modified Capabilities
|
||||
- `search-browse`: 新增 Where-Used 查询、代码差异对比、CDS View 操作、包操作
|
||||
- `transport`: 新增传输请求列表、详情、释放、对象查看
|
||||
|
||||
## Impact
|
||||
|
||||
- client.py 新增 CDS/Where-Used/Transport/Package 相关 ADT API 方法
|
||||
- 新增 search.py、diff_cmd.py、transport.py、package_cmd.py、cds.py 命令模块
|
||||
- 新增 5 个子命令：whereused、search、diff、cds、package
|
||||
- transport 命令新增 4 个子操作
|
||||
+61
@@ -0,0 +1,61 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Where-Used Query
|
||||
|
||||
系统 SHALL 查询指定对象在其他开发对象中的引用关系。
|
||||
|
||||
#### Scenario: Find references
|
||||
- **WHEN** 用户执行 whereused 命令并指定对象名称和类型
|
||||
- **THEN** 系统显示所有引用该对象的开发对象列表
|
||||
|
||||
#### Scenario: No references found
|
||||
- **WHEN** 指定对象没有被任何其他对象引用
|
||||
- **THEN** 系统显示无引用结果的信息
|
||||
|
||||
### Requirement: Source Code Search
|
||||
|
||||
系统 SHALL 在 SAP 系统中搜索源代码内容。
|
||||
|
||||
#### Scenario: Search by keyword
|
||||
- **WHEN** 用户执行 search 命令并提供搜索关键词
|
||||
- **THEN** 系统显示包含该关键词的对象名称、类型和匹配行
|
||||
|
||||
#### Scenario: Search no results
|
||||
- **WHEN** 搜索关键词没有匹配结果
|
||||
- **THEN** 系统显示无搜索结果的信息
|
||||
|
||||
### Requirement: Code Diff
|
||||
|
||||
系统 SHALL 对比本地源码与 SAP 系统中当前版本的差异。
|
||||
|
||||
#### Scenario: Diff with differences
|
||||
- **WHEN** 用户执行 diff 命令，本地文件与 SAP 版本存在差异
|
||||
- **THEN** 系统显示差异内容（新增、删除、修改的行）
|
||||
|
||||
#### Scenario: Diff identical
|
||||
- **WHEN** 本地文件与 SAP 版本完全一致
|
||||
- **THEN** 系统显示无差异的信息
|
||||
|
||||
### Requirement: CDS View Operations
|
||||
|
||||
系统 SHALL 支持 CDS View 的下载和创建操作。
|
||||
|
||||
#### Scenario: Download CDS view
|
||||
- **WHEN** 用户执行 cds download 命令并指定 CDS View 名称
|
||||
- **THEN** 系统下载 CDS View 定义并保存到本地
|
||||
|
||||
#### Scenario: Create CDS view
|
||||
- **WHEN** 用户执行 cds create 命令并指定名称和描述
|
||||
- **THEN** 系统在 SAP 中创建新的 CDS View
|
||||
|
||||
### Requirement: Package Operations
|
||||
|
||||
系统 SHALL 支持 ABAP 包的查询和创建操作。
|
||||
|
||||
#### Scenario: Query package info
|
||||
- **WHEN** 用户执行 package info 命令并指定包名
|
||||
- **THEN** 系统显示包的描述、包含的对象数量等信息
|
||||
|
||||
#### Scenario: Create package
|
||||
- **WHEN** 用户执行 package create 命令并指定包名和描述
|
||||
- **THEN** 系统在 SAP 中创建新的 ABAP 包
|
||||
+33
@@ -0,0 +1,33 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Transport Request Listing
|
||||
|
||||
系统 SHALL 列出 SAP 系统中的传输请求。
|
||||
|
||||
#### Scenario: List transport requests
|
||||
- **WHEN** 用户执行 transport list 命令
|
||||
- **THEN** 系统显示当前用户的传输请求列表（请求号、描述、状态）
|
||||
|
||||
### Requirement: Transport Request Info
|
||||
|
||||
系统 SHALL 查询指定传输请求的详细信息。
|
||||
|
||||
#### Scenario: Query transport info
|
||||
- **WHEN** 用户执行 transport info 命令并指定传输请求号
|
||||
- **THEN** 系统显示传输请求的所有者、状态、包含的对象数量等信息
|
||||
|
||||
### Requirement: Transport Request Release
|
||||
|
||||
系统 SHALL 释放传输请求。
|
||||
|
||||
#### Scenario: Release transport request
|
||||
- **WHEN** 用户执行 transport release 命令并指定传输请求号
|
||||
- **THEN** 系统释放该传输请求
|
||||
|
||||
### Requirement: Transport Objects Listing
|
||||
|
||||
系统 SHALL 列出传输请求中包含的对象。
|
||||
|
||||
#### Scenario: List objects in transport
|
||||
- **WHEN** 用户执行 transport objects 命令并指定传输请求号
|
||||
- **THEN** 系统显示该传输请求中包含的所有开发对象列表
|
||||
@@ -0,0 +1,36 @@
|
||||
## 1. CDS View Support
|
||||
|
||||
- [x] 1.1 Register CDS View type and ADT endpoints
|
||||
- [x] 1.2 Implement cds download subcommand
|
||||
- [x] 1.3 Implement cds create subcommand
|
||||
- [x] 1.4 Handle DDL source format (non-ABAP)
|
||||
|
||||
## 2. Where-Used Query
|
||||
|
||||
- [x] 2.1 Implement whereused command with name and type parameters
|
||||
- [x] 2.2 Parse ADT where-used XML response
|
||||
- [x] 2.3 Display referencing objects with type and name
|
||||
|
||||
## 3. Source Code Search
|
||||
|
||||
- [x] 3.1 Implement search command with keyword query
|
||||
- [x] 3.2 Parse ADT code search response
|
||||
- [x] 3.3 Display matching objects with context lines
|
||||
|
||||
## 4. Code Diff
|
||||
|
||||
- [x] 4.1 Implement diff command comparing local file vs SAP version
|
||||
- [x] 4.2 Download SAP version for comparison
|
||||
- [x] 4.3 Compute and display unified diff output
|
||||
|
||||
## 5. Transport Management
|
||||
|
||||
- [x] 5.1 Implement transport list subcommand
|
||||
- [x] 5.2 Implement transport info subcommand with --corr_nr
|
||||
- [x] 5.3 Implement transport release subcommand with --corr_nr
|
||||
- [x] 5.4 Implement transport objects subcommand with --corr_nr
|
||||
|
||||
## 6. Package Operations
|
||||
|
||||
- [x] 6.1 Implement package info subcommand
|
||||
- [x] 6.2 Implement package create subcommand with --description
|
||||
Reference in New Issue
Block a user