SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场skill-hide

skill-hide

部署与运维

查看项目

更新于 10-16 08:30

技能介绍

用途

skill-hide 是一个技能隐藏管理工具（Skill Hide Manager），用于将技能标记为隐藏状态或恢复显示。它适合需要对已安装技能进行可见性管理的场景，例如临时屏蔽部分技能、按目录批量管理技能显示状态，或查看当前有哪些技能处于隐藏状态。

主要能力

  • 隐藏技能：将技能标记为隐藏状态（对应 hide_skill.py）。支持隐藏单个、多个或全部技能，也可限定在指定文件夹内操作。
  • 恢复技能：取消隐藏，让技能重新显示（对应 unhide_skill.py）。同样支持单个、多个、全部以及指定文件夹。
  • 预览技能：仅查看技能列表与状态，不做修改，通过 --show-all 实现，可查看所有配置文件夹或指定文件夹。
  • 查看已隐藏列表：跨所有配置文件夹列出所有已隐藏技能（list_hidden.py）。
  • 操作历史记录：查看操作历史，以及操作过的文件夹列表（list_history.py，含 --folders 参数）。
  • 配置管理：通过 config_manager.py 添加、覆盖、列出、清空技能父文件夹路径。配置文件为 skill-hide/.skill-config.json。
  • 多目录支持：配置文件中可保存多个技能父文件夹路径，隐藏/恢复时会搜索所有配置的文件夹。
  • 防止隐藏自身：skill-hide 不能隐藏自己。
  • 路径规范化：自动统一使用正斜杠 /，兼容 Windows CMD、PowerShell 以及类 Unix shell（Git Bash、MSYS2、WSL）。

使用方式

依赖：Python 标准库，无需额外依赖。首次使用需配置技能父文件夹路径。

配置示例：

# 添加单个路径
python skill-hide/scripts/config_manager.py --add "C:/path/to/skills"

# 添加多个路径
python skill-hide/scripts/config_manager.py --add "C:/path1" --add "D:/path2"

# 覆盖设置所有路径（逗号分隔）
python skill-hide/scripts/config_manager.py --set "C:/path1,D:/path2,E:/path3"

# 列出当前配置
python skill-hide/scripts/config_manager.py --list

# 清空所有配置
python skill-hide/scripts/config_manager.py --clear

# 不带参数运行，显示当前配置和参考路径
python skill-hide/scripts/config_manager.py

隐藏技能示例：

# 隐藏单个
python skill-hide/scripts/hide_skill.py <skill-name>

# 隐藏多个
python skill-hide/scripts/hide_skill.py <skill1> <skill2>

# 隐藏所有（所有配置文件夹）
python skill-hide/scripts/hide_skill.py --all

# 隐藏指定文件夹下的所有技能
python skill-hide/scripts/hide_skill.py --all --folder <path>

# 指定文件夹
python skill-hide/scripts/hide_skill.py <skill-name> --folder <path>

恢复技能示例：

# 恢复单个
python skill-hide/scripts/unhide_skill.py <skill-name>

# 恢复多个
python skill-hide/scripts/unhide_skill.py <skill1> <skill2>

# 恢复所有（所有配置文件夹）
python skill-hide/scripts/unhide_skill.py --all

# 恢复指定文件夹下的所有技能
python skill-hide/scripts/unhide_skill.py --all --folder <path>

# 指定文件夹
python skill-hide/scripts/unhide_skill.py <skill-name> --folder <path>

预览与查询示例：

# 查看所有配置文件夹的技能状态（多文件夹场景）
python skill-hide/scripts/hide_skill.py --show-all

# 查看指定文件夹的技能状态
python skill-hide/scripts/hide_skill.py --show-all --folder <path>

# 查看所有已隐藏的技能（跨所有配置文件夹）
python skill-hide/scripts/list_hidden.py

# 查看操作历史记录
python skill-hide/scripts/list_history.py

# 查看操作过的文件夹列表
python skill-hide/scripts/list_history.py --folders

资源索引：

  • scripts/config_manager.py - 读取/写入配置
  • scripts/hide_skill.py - 隐藏技能 / 查看所有技能状态（支持多文件夹）
  • scripts/unhide_skill.py - 恢复技能
  • scripts/list_hidden.py - 列出所有已隐藏技能（跨文件夹）
  • scripts/list_history.py - 查看操作历史记录

AI 使用规则

该工具对 AI 使用有强制规则：

规则 1：当用户输入包含歧义词时必须先询问确认，禁止直接执行。歧义词包括“显示”和“展示”。正确流程示例：

用户: "显示所有技能"
AI:  "'显示'有两种含义：
     [1] 恢复（取消隐藏）技能
     [2] 查看/列出技能列表
     请回复 1 或 2："

禁止直接列出技能、直接恢复技能或假设用户意图。

规则 2：非歧义词直接执行。例如“隐藏 xxx”直接隐藏，“查看/列出 xxx”直接预览，“恢复 xxx”/“取消隐藏 xxx”直接恢复，“哪些被隐藏了”执行 list_hidden.py。

适用场景

  • 需要临时屏蔽某些技能、之后再恢复。
  • 需要在多个技能目录中批量管理技能可见性。
  • 需要查看当前隐藏了哪些技能或操作历史。

限制与注意事项

  • 禁止隐藏自身：skill-hide 不能隐藏自己。
  • 同名技能：不同文件夹中可以有同名技能，隐藏/恢复时会操作所有匹配的技能。
  • 判断技能是否隐藏不应仅依赖工具输出，须通过文件系统验证：SKILL.md 存在为显示状态；SKILL.md.hide 存在且 SKILL.md 不存在为隐藏状态。
  • 所有隐藏/恢复操作后应验证文件状态，确保操作成功。
  • Windows 控制台编码问题：脚本输出中文可能出现乱码（不影响实际功能）。
  • 配置文件位置：skill-hide/.skill-config.json。
  • 术语对应：隐藏对应 hide_skill.py；恢复（取消隐藏）对应 unhide_skill.py；预览/查看/列出对应 --show-all，仅查看不修改。