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 重写为单源开发流程。
2026-09-11 00:40:15 +08:00
parent e786742bcb
commit c5905a5b1e
104 changed files with 20744 additions and 10 deletions
@@ -0,0 +1,4 @@
+schema: spec-driven
+change: p2-atc-format-analyze-scaffold
+status: archived
+archived_at: "2026-06-09"
@@ -0,0 +1,24 @@
+# Proposal: P2 — ATC 检查 + 代码格式化 + 依赖分析 + 项目脚手架
+
+## Why
+
+代码质量保障和开发者效率是工具成熟的标志。ATC 检查提供专业级代码审查，Pretty Printer 统一代码风格，依赖分析自动化项目管理，脚手架加速项目初始化。
+
+## What Changes
+
+- ATC (ABAP Test Cockpit) 代码检查集成
+- ABAP Pretty Printer 代码格式化
+- 项目级依赖自动分析
+- 预定义模板项目脚手架
+
+## Capabilities
+
+### Modified Capabilities
+- `quality`: 新增 ATC 检查、代码格式化、依赖分析、项目脚手架
+
+## Impact
+
+- 新增 check、format、analyze、scaffold 四个命令
+- client.py 新增 ATC check、Pretty Printer ADT API 方法
+- 新增 quality.py、analyze.py、scaffold.py 命令模块
+- analyze 和 scaffold 不需要 SAP 连接（本地操作）
@@ -0,0 +1,41 @@
+## MODIFIED Requirements
+
+### Requirement: ATC Code Check
+
+系统 SHALL 对 SAP 开发对象执行 ABAP Test Cockpit (ATC) 代码检查。
+
+#### Scenario: Check with findings
+- **WHEN** 用户执行 check 命令并指定对象名称和类型
+- **THEN** 系统显示 ATC 检查发现的问题列表（优先级、位置、描述）
+
+#### Scenario: Check clean
+- **WHEN** ATC 检查未发现任何问题
+- **THEN** 系统显示检查通过的信息
+
+### Requirement: Code Formatting
+
+系统 SHALL 对 SAP 开发对象执行 ABAP Pretty Printer 格式化。
+
+#### Scenario: Format source code
+- **WHEN** 用户执行 format 命令并指定对象名称和类型
+- **THEN** 系统对 SAP 中的源码执行格式化并报告结果
+
+### Requirement: Dependency Analysis
+
+系统 SHALL 自动分析项目中对象的依赖关系。
+
+#### Scenario: Analyze project dependencies
+- **WHEN** 用户执行 analyze 命令并指定项目路径
+- **THEN** 系统扫描源码中的依赖引用并生成依赖报告
+
+### Requirement: Project Scaffolding
+
+系统 SHALL 根据预定义模板创建 ABAP 项目结构。
+
+#### Scenario: Scaffold from template
+- **WHEN** 用户执行 scaffold 命令并指定名称和模板类型
+- **THEN** 系统基于模板生成包含源码文件的项目结构
+
+#### Scenario: List available templates
+- **WHEN** 用户执行 scaffold 命令但未指定模板
+- **THEN** 系统显示可用的模板列表
@@ -0,0 +1,26 @@
+## 1. ATC Code Check
+
+- [x] 1.1 Implement check command with name and type parameters
+- [x] 1.2 Integrate ADT ATC checkruns API
+- [x] 1.3 Parse and display findings with priority, location, description
+- [x] 1.4 Handle clean check result
+
+## 2. Code Formatting
+
+- [x] 2.1 Implement format command with ABAP Pretty Printer integration
+- [x] 2.2 Integrate ADT Pretty Printer API
+- [x] 2.3 Report formatting result
+
+## 3. Dependency Analysis
+
+- [x] 3.1 Implement analyze command for project-level scanning
+- [x] 3.2 Parse TYPE REF TO, CALL METHOD, PERFORM statements
+- [x] 3.3 Generate dependency report
+- [x] 3.4 Work without SAP connection (local-only)
+
+## 4. Project Scaffolding
+
+- [x] 4.1 Implement scaffold command with template parameter
+- [x] 4.2 Create predefined templates (alv-report, bapi-wrapper, interface-class, data-model)
+- [x] 4.3 Display available templates when none specified
+- [x] 4.4 Work without SAP connection (local-only)