skill-hide

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

技能隐藏管理 (Skill Hide Manager)

Skill Hide Manager

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

⚠️ Mandatory Rules (AI Must Comply)

规则 1：歧义词必须询问

Rule 1: Ambiguous Terms Must Be Confirmed

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

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

正确流程：

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

错误行为（禁止）：

❌ 直接列出技能
❌ 直接恢复技能
❌ 假设用户意图

When user input contains the following ambiguous terms, do not perform any operations directly; you must first confirm with the user:

Ambiguous Term	Must Confirm
"display"	✅ Must confirm
"show"	✅ Must confirm

Correct Process:

User: "Display all skills"
AI:  "'Display' has two meanings:
     [1] Restore (unhide) skills
     [2] View/list skill list
     Please reply with 1 or 2:"

Prohibited Incorrect Behaviors:

❌ Directly list skills
❌ Directly restore skills
❌ Assume user intent

规则 2：非歧义词直接执行

Rule 2: Non-Ambiguous Terms Are Executed Directly

用户输入	意图	直接执行
"隐藏 xxx"	隐藏技能	`hide_skill.py xxx`
"查看/列出 xxx"	预览技能	`--show-all`
"恢复 xxx" / "取消隐藏 xxx"	恢复技能	`unhide_skill.py xxx`
"哪些被隐藏了"	查看已隐藏列表	`list_hidden.py`

User Input	Intent	Direct Execution
"Hide xxx"	Hide skill	`hide_skill.py xxx`
"View/list xxx"	Preview skills	`--show-all`
"Restore xxx" / "Unhide xxx"	Restore skill	`unhide_skill.py xxx`
"Which skills are hidden?"	View hidden list	`list_hidden.py`

术语说明

Term Explanations

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

Term	Meaning	Corresponding Operation
Hide	Mark skill as hidden	`hide_skill.py`
Restore	Cancel hiding, make skill visible again	`unhide_skill.py`
Preview/View/List	Only view skill list, no modifications	`--show-all`

前置准备

Prerequisites

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

Dependencies: Python standard library, no additional dependencies required

配置管理

Configuration Management

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

Configure the skill parent folder path on first use.

配置方法

Configuration Methods

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

bash

undefined

Path Format Note: Use forward slash
/
to be compatible with Windows CMD, PowerShell, and Unix-like shells (Git Bash, MSYS2, WSL)

bash

undefined

添加单个路径

Add a single path

python skill-hide/scripts/config_manager.py --add "C:/path/to/skills"

添加多个路径

Add multiple paths

python skill-hide/scripts/config_manager.py --add "C:/path1" --add "D:/path2"

覆盖设置所有路径（逗号分隔）

Override and set all paths (comma-separated)

python skill-hide/scripts/config_manager.py --set "C:/path1,D:/path2,E:/path3"

列出当前配置

List current configuration

python skill-hide/scripts/config_manager.py --list

清空所有配置

Clear all configurations

python skill-hide/scripts/config_manager.py --clear

不带参数运行，显示当前配置和参考路径

Run without parameters to display current configuration and reference paths

python skill-hide/scripts/config_manager.py

undefined

python skill-hide/scripts/config_manager.py

undefined

操作步骤

Operation Steps

隐藏技能

Hide Skills

bash

undefined

bash

undefined

隐藏单个

Hide a single skill

python skill-hide/scripts/hide_skill.py <skill-name>

隐藏多个

Hide multiple skills

python skill-hide/scripts/hide_skill.py <skill1> <skill2>

隐藏所有（所有配置文件夹）

Hide all skills (all configured folders)

python skill-hide/scripts/hide_skill.py --all

隐藏指定文件夹下的所有技能

Hide all skills in a specified folder

python skill-hide/scripts/hide_skill.py --all --folder <path>

指定文件夹

Specify folder

python skill-hide/scripts/hide_skill.py <skill-name> --folder <path>

undefined

python skill-hide/scripts/hide_skill.py <skill-name> --folder <path>

undefined

恢复技能

Restore Skills

bash

undefined

bash

undefined

恢复单个

Restore a single skill

python skill-hide/scripts/unhide_skill.py <skill-name>

恢复多个

Restore multiple skills

python skill-hide/scripts/unhide_skill.py <skill1> <skill2>

恢复所有（所有配置文件夹）

Restore all skills (all configured folders)

python skill-hide/scripts/unhide_skill.py --all

恢复指定文件夹下的所有技能

Restore all skills in a specified folder

python skill-hide/scripts/unhide_skill.py --all --folder <path>

指定文件夹

Specify folder

python skill-hide/scripts/unhide_skill.py <skill-name> --folder <path>

undefined

python skill-hide/scripts/unhide_skill.py <skill-name> --folder <path>

undefined

预览技能（仅查看，不修改）

Preview Skills (View Only, No Modifications)

bash

undefined

bash

undefined

查看所有配置文件夹的技能状态（多文件夹场景）

View skill status of all configured folders (multi-folder scenario)

python skill-hide/scripts/hide_skill.py --show-all

查看指定文件夹的技能状态

View skill status of a specified folder

python skill-hide/scripts/hide_skill.py --show-all --folder <path>

查看所有已隐藏的技能（跨所有配置文件夹）

View all hidden skills (across all configured folders)

python skill-hide/scripts/list_hidden.py

查看操作历史记录

View operation history

python skill-hide/scripts/list_history.py

查看操作过的文件夹列表

View list of folders that have been operated on

python skill-hide/scripts/list_history.py --folders

undefined

python skill-hide/scripts/list_history.py --folders

undefined

资源索引

Resource Index

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

```
scripts/config_manager.py
```
- Read/write configurations
```
scripts/hide_skill.py
```
- Hide skills / View status of all skills (supports multi-folders)
```
scripts/unhide_skill.py
```
- Restore skills
```
scripts/list_hidden.py
```
- List all hidden skills (cross-folder)
```
scripts/list_history.py
```
- View operation history

注意事项

Notes

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

Prohibit self-hiding: skill-hide cannot hide itself
Path normalization: Automatically unify to use forward slash
```
/
```
Multi-directory support:
- Multiple skill parent folder paths can be saved in the configuration file
- When hiding/restoring skills, all configured folders will be searched
- ```
--show-all
```
  will display the status of all configured folders when no
```
--folder
```
  is specified
Duplicate-named skills: Skills with the same name can exist in different folders; all matching skills will be operated on when hiding/restoring
Configuration file:
```
skill-hide/.skill-config.json
```

⚠️ 重要：AI 使用指南

⚠️ Important: AI Usage Guide

如何判断技能是否隐藏

How to Determine if a Skill is Hidden

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

bash

undefined

Do not rely solely on tool output; you must verify through the file system:

bash

undefined

正确：直接检查文件存在性

Correct: Directly check file existence

ls -la skill-folder/

显示状态: SKILL.md 存在

Visible state: SKILL.md exists

隐藏状态: SKILL.md.hide 存在, SKILL.md 不存在

Hidden state: SKILL.md.hide exists, SKILL.md does not exist


**判断逻辑**：
| 文件存在情况 | 状态 |
|-------------|------|
| `SKILL.md` 存在 | ✅ 显示 |
| `SKILL.md.hide` 存在，且 `SKILL.md` 不存在 | ❌ 隐藏 |


**Judgment Logic**:
| File Existence | Status |
|----------------|--------|
| `SKILL.md` exists | ✅ Visible |
| `SKILL.md.hide` exists and `SKILL.md` does not exist | ❌ Hidden |

已知问题

Known Issues

Windows 控制台编码问题: 脚本输出中文可能出现乱码（不影响实际功能）
验证机制: 所有隐藏/恢复操作后应验证文件状态，确保操作成功

Windows console encoding issue: Chinese output of the script may appear garbled (does not affect actual functionality)
Verification mechanism: File status should be verified after all hide/restore operations to ensure success

快速参考表

Quick Reference Table

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

User Input	Ambiguous?	AI Action
"Hide xxx"	❌	Execute hide directly
"View/list xxx"	❌	Execute preview directly
"Restore/Unhide xxx"	❌	Execute restore directly
"Display xxx"	✅	Must confirm
"Show xxx"	✅	Must confirm
"Which skills are hidden?"	❌	Execute list_hidden.py directly