Files
sap-cli-skill/README.md
T
吴让宇 c5905a5b1e 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

54 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SAP-CLI-SKILL
## 🎯 项目价值
SAP-CLI-SKILL 是一个让 AI 助手直接操作 SAP ABAP 系统的技能。
**核心价值**
- **AI 驱动的 SAP 开发**:AI 助手可以读取、分析、修改 ABAP 开发对象
- **代码质量自动化**:自动化审计 ABAP 代码,发现潜在问题
- **开发效率提升**:AI 帮助完成重复性开发任务
- **持续集成支持**:集成到 CI/CD 流程,实现代码质量门禁
**适用场景**
- SAP ABAP 代码审计和质量检查
- 批量对象处理和转换
- AI 辅助开发和重构
- 自动化测试和代码审查
---
## 🚀 快速启动
### 一键安装
```bash
请帮我安装 sap-cli-skill: https://gitee.com/markwury168/sap-cli-skill/blob/master/INSTALL.md
```
复制给你的 Agent,几分钟后它就安装好了。
---
## 📚 详细文档
- **[INSTALL.md](INSTALL.md)** - 完整安装指南
- **[SKILL.md](SKILL.md)** - AI Agent 使用指南
- **[references/](references/)** - 技术文档
- **[docs/RELEASING.md](docs/RELEASING.md)** - 开发与发布
---
## 🗂 本仓是唯一来源
本仓同时是**技能分发包**与**工具源码仓**——`SKILL.md` 手工维护,工具源码在
`assets/`,测试在 `tests/`692 例)。原 `sap-cli` 源码仓已于 2026-09-11 归档。
```bash
pip install -e "./assets[dev]"
python -m unittest discover -s tests -p "test_*.py"
```
---
**当前版本**: 2.5.1
**维护者**: SwiftCode Creative Technology