Files
skillshare/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/commands/enable.md
T
Willie cf36965cea feat(website): add zh-Hant/zh-Hans/ja/ko locales with initial docs translation
Sets up Docusaurus i18n for Traditional Chinese, Simplified Chinese,
Japanese, and Korean: locale config, navbar/footer/sidebar UI chrome,
and translated content for intro, getting-started, understand, and
reference/commands. Untranslated pages fall back to English.

Pins explicit heading anchors ({#id}) on English source pages that are
linked to by fragment, so translated headings don't change the anchor
id and break cross-page links. Converts a handful of relative .md
links that crossed from an untranslated page into a now-translated
one, since Docusaurus resolves those per-locale and they'd otherwise
404 outside English.
2026-09-20 11:08:48 +08:00

4.9 KiB
Raw Blame History

sidebar_position
sidebar_position
5

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 之外。

flowchart LR
    DIS["skillshare disable my-skill"]
    IGN[".skillignore += my-skill"]
    SYNC["sync skips my-skill"]
    DIS --> IGN --> SYNC
flowchart LR
    EN["skillshare enable my-skill"]
    IGN[".skillignore -= my-skill"]
    SYNC["sync includes my-skill"]
    EN --> IGN --> SYNC

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

:::tip 给模式加上引号 始终用引号包裹文件夹模式("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。

另请参阅