enable / disable
临时启用或禁用 skills,而不将其删除。
skillshare disable draft-* # 按模式禁用
skillshare enable draft-* # 重新启用
skillshare disable "frontend/**" # 禁用某个文件夹中的所有 skill
skillshare disable my-skill -p # Project mode
何时使用
- 临时将某个 skill 从同步中隐藏,而不卸载它
- 在所有 targets 中静音某个草稿或实验性的 skill
- 从 list TUI 中用
E键切换 skills 的启用/禁用状态
工作原理
disable 会向 .skillignore 添加一个模式;enable 则将其移除。被禁用的 skills 仍保留在 source 目录中,但会被排除在 sync 和 collect 之外。
启用或禁用之后,运行 skillshare sync 将更改应用到 targets。
选项
| 标志 | 描述 |
|---|---|
<name|pattern> | 一个或多个 skill 名称或 glob 模式(例如 draft-*、frontend/**) |
--project, -p | 使用 project 的 .skillignore(.skillshare/skills/.skillignore) |
--global, -g | 使用 global 的 .skillignore(~/.config/skillshare/.skillignore) |
--dry-run, -n | 预览而不写入 |
--help, -h | 显示帮助 |
当既未指定 -p 也未指定 -g 时会自动检测模式(与其他命令相同)。
示例
# 禁用单个 skill
$ skillshare disable my-draft
Disabled: my-draft (added to .skillignore)
Run 'skillshare sync' to apply changes.
# 按 glob 模式禁用
$ skillshare disable "experimental-*"
Disabled: experimental-* (added to .skillignore)
Run 'skillshare sync' to apply changes.
# 重新启用
$ skillshare enable my-draft
Enabled: my-draft (removed from .skillignore)
Run 'skillshare sync' to apply changes.
# 预览而不写入
$ skillshare disable my-skill --dry-run
Would add 'my-skill' to ~/.config/skillshare/skills/.skillignore
# 已经被禁用
$ skillshare disable my-draft
warning: my-draft is already disabled
禁用整个文件夹
disable/enable 使用与 .skillignore 相同的 glob 语法,因此没有单独的“group”标志——将模式指向文件夹,其中的所有 skill 就会一并被切换。
# 禁用 frontend/ 下的所有 skill(任意深度)
$ skillshare disable "frontend/**"
Disabled: frontend/** (added to .skillignore)
Run 'skillshare sync' to apply changes.
# 重新启用整个文件夹
$ skillshare enable "frontend/**"
Enabled: frontend/** (removed from .skillignore)
Run 'skillshare sync' to apply changes.
始终用引号包裹文件夹模式("frontend/**"),这样你的 shell 就不会在 skillshare 看到之前展开 *。
frontend/** 会向 .skillignore 写入一行,并持续覆盖你之后添加到该文件夹中的任何内容。使用相同的模式执行 enable 会移除那一行。如果想改为禁用单个 skill,请按名称列出它们(skillshare disable a b c)。完整的 glob 参考(*、**、?、[abc]、!negation、锚定的 /、仅目录的 pattern/)参见 .skillignore pattern syntax。
TUI 切换
在交互式的 skillshare list TUI 中,按 E 切换所选 skill 的启用/禁用状态。更改会立即写入 .skillignore——无需先退出 TUI。
被禁用的 skills 会在详情面板中显示红色的 disabled 徽章。
.skillignore 在哪里?
| 模式 | 路径 |
|---|---|
| Global | ~/.config/skillshare/skills/.skillignore |
| Project | .skillshare/skills/.skillignore |
该文件会在首次执行 disable 时自动创建。
Agent 支持
使用 --kind agent 来启用或禁用 agents。这会写入 .agentignore 而不是 .skillignore:
skillshare disable --kind agent draft-reviewer # 禁用一个 agent
skillshare enable --kind agent draft-reviewer # 重新启用
skillshare disable --kind agent "experimental-*" # 按模式禁用
| 模式 | .agentignore 路径 |
|---|---|
| Global | ~/.config/skillshare/agents/.agentignore |
| Project | .skillshare/agents/.agentignore |
关于 agent 管理的背景信息,参见 Agents。
另请参阅
- list — 查看被禁用的 skills,并用
E键切换 - Filtering Skills — 所有过滤层
- .skillignore — 模式语法
- sync — 在 enable/disable 之后应用更改
- Agents — Agent 概念