跳到主要内容

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 目录中,但会被排除在 synccollect 之外。

提示

启用或禁用之后,运行 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

另请参阅