mcpField
S
skill-hide

skill-hide

github.com/steelan9199Agent 工作流1035 次安装今天更新
代码仓库

关于 skill-hide

skill-hide 是用于管理本地技能隐藏状态的技能，适合维护多个技能目录的用户。它提供配置、隐藏、恢复、状态预览和历史查询，并要求对“显示”“展示”等歧义指令先确认意图。

主要功能

  1. 01配置一个或多个技能目录
  2. 02隐藏或恢复单个及多个技能
  3. 03预览技能状态并列出隐藏项
  4. 04查看操作历史记录
  5. 05对歧义指令要求先确认

适用场景

  1. 01在多个技能目录中隐藏指定技能
  2. 02恢复已隐藏的技能
  3. 03检查各目录技能的隐藏状态
  4. 04查询隐藏与恢复操作记录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/steelan9199/wechat-publisher --skill skill-hide

安装后在 Claude Code 中输入/skill-hide确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
config_manager.py
hide_skill.py
list_hidden.py
list_history.py
unhide_skill.py

详细介绍

来自项目 README

技能隐藏管理 (Skill Hide Manager)

⚠️ 强制规则（AI 必须遵守）

规则 1：歧义词必须询问

当用户输入包含以下歧义词时，禁止直接执行任何操作，必须先询问确认：

歧义词必须询问
"显示"✅ 必须询问
"展示"✅ 必须询问

正确流程：

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

错误行为（禁止）：

  • ❌ 直接列出技能
  • ❌ 直接恢复技能
  • ❌ 假设用户意图
规则 2：非歧义词直接执行
用户输入意图直接执行
"隐藏 xxx"隐藏技能hide_skill.py xxx
"查看/列出 xxx"预览技能--show-all
"恢复 xxx" / "取消隐藏 xxx"恢复技能unhide_skill.py xxx
"哪些被隐藏了"查看已隐藏列表list_hidden.py

术语说明

术语含义对应操作
隐藏将技能标记为隐藏状态hide_skill.py
恢复取消隐藏，让技能重新显示unhide_skill.py
预览/查看/列出仅查看技能列表，不修改--show-all

前置准备

  • 依赖: Python 标准库，无需额外依赖

配置管理

首次使用需配置技能父文件夹路径。

配置方法

路径格式说明：使用正斜杠 / 兼容 Windows CMD、PowerShell 和类 Unix shell（Git Bash、MSYS2、WSL）

# 添加单个路径
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 - 查看操作历史记录

注意事项

  1. 禁止隐藏自己: skill-hide 不能隐藏自身
  2. 路径规范化: 自动统一使用正斜杠 /
  3. 多目录支持:
    • 配置文件中可保存多个技能父文件夹路径
    • 隐藏/恢复技能时会搜索所有配置的文件夹
    • --show-all 不指定 --folder 时会显示所有配置文件夹的状态
  4. 同名技能: 不同文件夹中可以有同名技能，隐藏/恢复时会操作所有匹配的技能
  5. 配置文件: skill-hide/.skill-config.json

⚠️ 重要：AI 使用指南

如何判断技能是否隐藏

不要仅依赖工具输出，必须通过文件系统验证：

# 正确：直接检查文件存在性
ls -la skill-folder/
# 显示状态: SKILL.md 存在
# 隐藏状态: SKILL.md.hide 存在, SKILL.md 不存在

判断逻辑：

文件存在情况状态
SKILL.md 存在✅ 显示
SKILL.md.hide 存在，且 SKILL.md 不存在❌ 隐藏
已知问题
  1. Windows 控制台编码问题: 脚本输出中文可能出现乱码（不影响实际功能）
  2. 验证机制: 所有隐藏/恢复操作后应验证文件状态，确保操作成功

快速参考表

用户输入歧义？AI 行动
"隐藏 xxx"❌直接执行隐藏
"查看/列出 xxx"❌直接执行预览
"恢复/取消隐藏 xxx"❌直接执行恢复
"显示 xxx"✅必须询问
"展示 xxx"✅必须询问
"哪些被隐藏了"❌直接执行 list_hidden.py

评论

支持 Markdown