本地 Skill 管家

本技能是 skills/ 目录的集中管理工具，提供查询、监控、创建和删除 Skill 的能力，帮助你保持开发环境的整洁有序。

前置依赖

使用本技能前，请确认已安装依赖：

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/ 目录：

执行规则

> 重要：必须使用以下脚本执行操作，禁止直接使用 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