local-skill-manager
# 本地 Skill 管家
本技能是 `skills/` 目录的集中管理工具,提供查询、监控、创建和删除 Skill 的能力,帮助你保持开发环境的整洁有序。
## 前置依赖
使用本技能前,请确认已安装依赖:
```bash
pip install -r requirements.txt
```
> `requirements.txt` 包含:`pyyaml`(用于解析 SKILL.md 的 YAML frontmatter)
---
## 功能说明
### 1. 查询与列出 Skill
列出所有已安装的 Skill(含系统级和用户级),显示名称、版本和描述。
**触发示例:**
- "列出我的 Skill"
- "我有哪些 Skill"
- "查询所有 Skill"
### 2. 版本检查
检查每个 Skill 的版本号,确认是否为最新版本。
**触发示例:**
- "检查 Skill 版本"
- "我的 Skill 是什么版本"
### 3. 创建新 Skill
使用标准目录结构(`scripts/`、`references/`、`assets/`)和 `SKILL.md` 模板快速脚手架一个新 Skill。
**触发示例:**
- "创建一个名为 'data-analyzer' 的新 Skill"
- "新建一个 Skill"
### 4. 删除 Skill
安全地移除一个 Skill 目录,内置多层安全保护:路径名格式校验、受保护 Skill 拦截、路径遍历防护、软链接警告、二次确认提示。
**触发示例:**
- "删除 'old-test-skill' 这个 Skill"
**可用参数:**
- `--dry-run`:预览将要删除的路径,不实际执行(推荐先用此参数确认)
- `--force`:跳过确认提示,直接删除(谨慎使用)
---
## 脚本说明
所有脚本位于 `scripts/` 目录:
| 脚本 | 功能 |
|------|------|
| `list_skills.py` | 扫描并列出所有 Skill |
| `check_versions.py` | 检查各 Skill 的版本元数据 |
| `create_skill.py` | 初始化新 Skill 的标准目录结构 |
| `delete_skill.py` | 安全移除指定 Skill 目录 |
---
## 执行规则
> **重要**:必须使用以下脚本执行操作,禁止直接使用 `ls` 或 `glob` 命令操作 `skills/` 目录。
脚本路径结构(从 Skill 根目录相对引用):
```
# 列出所有 Skill
python scripts/list_skills.py
# 检查版本
python scripts/check_versions.py
# 创建新 Skill(将 skill-name 替换为你的 Skill 名称)
python scripts/create_skill.py "skill-name"
# 删除 Skill(将 skill-name 替换为要删除的 Skill 名称)
# 推荐先用 --dry-run 预览,确认无误后再实际删除
python scripts/delete_skill.py "skill-name" --dry-run
python scripts/delete_skill.py "skill-name"
```
**注意**:如果你的平台将 Skills 存放在特定子目录下(如 `.trae/skills/`),请在命令前加上对应的完整路径前缀,例如:
```
python .trae/skills/local-skill-manager/scripts/list_skills.py
```
标签
skill
ai