Add minio-upload skill and update README.md to match actual project structure

This commit is contained in:
Misaka Company
2026-01-28 09:20:17 +08:00
parent bdd2df7e75
commit 5f9d79fbb0
3 changed files with 148 additions and 12 deletions

View File

@@ -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