completion
コマンド、サブコマンド、フラグをタブ補完するためのシェル補完スクリプトを生成・インストールします。
使うタイミング
- skillshare のコマンドとフラグをタブ補完したい
- 新しいマシンやシェル環境をセットアップする
- エイリアス（例:
ss）を使っていて、それでも補完を効かせたい
構文
# 自動インストール（推奨）
skillshare completion bash --install
skillshare completion zsh --install
skillshare completion fish --install
skillshare completion powershell --install
skillshare completion nushell --install
# スクリプトを標準出力に出力する（上級者向け）
skillshare completion bash
skillshare completion zsh > ~/.zsh/completions/_skillshare
対応シェル
| シェル | インストールパス |
|---|---|
| bash | ~/.local/share/bash-completion/completions/skillshare |
| zsh | ~/.zsh/completions/_skillshare |
| fish | ~/.config/fish/completions/skillshare.fish |
| powershell | ~/.config/powershell/completions/skillshare.ps1 |
| nushell | ~/.config/nushell/completions/skillshare.nu |
フラグ
| フラグ | 説明 |
|---|---|
--install | 標準のインストールパスに補完スクリプトを書き込む |
--help, -h | 使い方を表示 |
補完の範囲
生成されるスクリプトは、以下のタブ補完を提供します。
- コマンド — すべてのトップレベルコマンド（
sync、install、listなど） - サブコマンド —
target add/remove/list、trash list/restore/delete/empty、hub add/list/remove/default/index、extras init/list/remove/collect/source/mode、audit rules、backup restore - フラグ — コマンドごとのフラグと短縮形（
--dry-run/-n、--force/-fなど） - グローバルフラグ —
--project/-p、--global/-g
エイリアス対応
bash、zsh、PowerShell のスクリプトは、skillshare を指すエイリアスを自動的に検出し、それらに対しても補完を登録します。
alias ss=skillshare
source <(skillshare completion bash)
ss sy<Tab> # → ss sync
Fish のエイリアス（関数のラッパーとして実装されている）は自動的に補完を引き継ぎます。
Nushell では、設定で alias ss = skillshare を使っている場合、エイリアスの補完はネイティブに引き継がれます。
インストール後の手順
--install の後、補完を有効化するために追加の作業が必要になる場合があります。
Bash
# シェルを再起動するか、以下を実行してください:
source ~/.local/share/bash-completion/completions/skillshare
Zsh
.zshrc に以下を追加してください（まだ無ければ）。
fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit
その後、シェルを再起動するか exec zsh を実行してください。
Fish
新しい fish セッションでは補完が自動的に利用可能になります。
PowerShell
PowerShell のプロファイル（echo $PROFILE）に以下を追加してください。
. ~/.config/powershell/completions/skillshare.ps1
Nushell
Nushell の設定（$nu.config-path）に以下を追加してください。
source ~/.config/nushell/completions/skillshare.nu
例
$ skillshare completion bash --install
✔ Completion script installed to /home/user/.local/share/bash-completion/completions/skillshare
ℹ Restart your shell or run:
source /home/user/.local/share/bash-completion/completions/skillshare