Add minio-upload skill and update README.md to match actual project structure
This commit is contained in:
57
README.md
57
README.md
@@ -10,28 +10,36 @@
|
||||
|
||||
```
|
||||
claudeskill/
|
||||
├── .claude/ # Claude 配置目录
|
||||
│ └── skills/ # Skill 创建器引用
|
||||
├── .claude/ # Claude 配置目录(已安装的 Skills)
|
||||
│ └── skills/ # Skills 创建器引用
|
||||
│ ├── skill-creator/ # Skill 创建指南和工具
|
||||
│ ├── excel-to-markdown/ # Excel 转 Markdown Skill
|
||||
│ └── excel-report-converter/ # Excel 报表转换 Skill
|
||||
├── scripts/ # 独立脚本目录
|
||||
│ ├── excel_to_markdown.py # Excel 转 Markdown 转换器
|
||||
│ └── report_to_db_format.py # 报表格式转数据库格式脚本
|
||||
├── skills/ # 开发中的 Skills
|
||||
│ └── excel-report-converter/ # Excel 报表转换器
|
||||
│ ├── excel-report-converter/ # Excel 报表转换 Skill
|
||||
│ └── minio-upload/ # MinIO 文件上传 Skill
|
||||
├── demo_scripts/ # 演示脚本目录
|
||||
│ └── excel_to_markdown.py # Excel 转 Markdown 转换器
|
||||
├── skills/ # 开发中的 Skills(用于测试和版本控制)
|
||||
│ ├── excel-to-markdown/ # Excel 转 Markdown Skill
|
||||
│ ├── excel-report-converter/ # Excel 报表转换 Skill
|
||||
│ └── minio-upload/ # MinIO 文件上传 Skill
|
||||
├── temp/ # 临时文件目录
|
||||
├── .venv/ # Python 虚拟环境
|
||||
├── CLAUDE.md # Claude Code 项目指南
|
||||
└── README.md # 本文档
|
||||
```
|
||||
|
||||
**说明:**
|
||||
- `.claude/skills/` - 已安装的 Skills,由 Claude Code 自动加载(被 gitignore)
|
||||
- `skills/` - Skills 的开发版本,用于版本控制和协作
|
||||
- `demo_scripts/` - 可独立运行的脚本文件
|
||||
|
||||
## 目录说明
|
||||
|
||||
### `scripts/`
|
||||
### `demo_scripts/`
|
||||
存放可独立使用的脚本文件,这些脚本可以被 Skills 引用。
|
||||
|
||||
**当前脚本:**
|
||||
- `excel_to_markdown.py` - 将 Excel 文件转换为 Markdown 表格格式
|
||||
- `report_to_db_format.py` - 将报表格式的 Excel 文件转换为数据库记录格式
|
||||
|
||||
### `skills/`
|
||||
存放已创建的 Skills,每个 Skill 都是一个独立的功能模块。
|
||||
@@ -69,6 +77,31 @@ claudeskill/
|
||||
- 创建自定义的 Excel 报表转换脚本
|
||||
- 将层级报表数据(表头 + 明细行 + 表尾)转换为规范化数据库记录
|
||||
|
||||
#### minio-upload
|
||||
上传文件到 MinIO obsidian 桶的 Skill,支持灵活的路径配置。
|
||||
|
||||
**功能:**
|
||||
- 上传任意文件到 MinIO 的 obsidian 桶
|
||||
- 支持自定义子路径(如 `notes/2024`, `archive/projects`)
|
||||
- 默认上传到 `main` 路径
|
||||
- 自动处理路径规范化和文件名附加
|
||||
- 完善的错误处理和验证
|
||||
|
||||
**使用场景:**
|
||||
- 快速上传 Markdown 文档到云存储
|
||||
- 按年份/分类组织文件
|
||||
- 备份文件到 MinIO
|
||||
- 批量上传文件到指定路径
|
||||
|
||||
**示例:**
|
||||
```bash
|
||||
# 上传到默认 main 路径
|
||||
.claude/skills/minio-upload/scripts/upload_to_obsidian.sh file.md
|
||||
|
||||
# 上传到自定义子路径
|
||||
.claude/skills/minio-upload/scripts/upload_to_obsidian.sh file.md "notes/2024"
|
||||
```
|
||||
|
||||
## 工作流程
|
||||
|
||||
### 1. 创建新 Skill
|
||||
@@ -100,7 +133,7 @@ python3 .claude/skills/skill-creator/scripts/init_skill.py <skill-name> --path s
|
||||
|
||||
```bash
|
||||
# 测试 Excel 转 Markdown
|
||||
python3 scripts/excel_to_markdown.py demo.xlsx -o demo.md --show-rows --show-cols
|
||||
python3 demo_scripts/excel_to_markdown.py demo.xlsx -o demo.md --show-rows --show-cols
|
||||
```
|
||||
|
||||
### 4. 打包 Skill(当用户主动要求才打包)
|
||||
@@ -164,7 +197,7 @@ python3 .claude/skills/skill-creator/scripts/init_skill.py excel-to-markdown --p
|
||||
|
||||
### 步骤 2:添加脚本
|
||||
```bash
|
||||
cp excel_to_markdown.py skills/excel-to-markdown/scripts/
|
||||
cp demo_scripts/excel_to_markdown.py skills/excel-to-markdown/scripts/
|
||||
```
|
||||
|
||||
### 步骤 3:编写 SKILL.md
|
||||
|
||||
Reference in New Issue
Block a user