/update

sidebar_position: 2

update

1 つ以上の skill または tracked repositories を最新バージョンに更新します。

skillshare update my-skill           # 単一の skill を更新
skillshare update a b c              # 複数を一度に更新
skillshare update --group frontend   # グループ内のすべての skill を更新
skillshare update team-skills        # tracked repo を更新
skillshare update --all              # すべてを更新
skillshare update agents --all       # すべての tracked/updatable agent を更新

使うタイミング

• tracked repository に新しいコミットがある（`check` で発見）
• インストール済みの skill に新しいバージョンが利用可能
• 元の source から skill を再ダウンロードしたい


実行内容

トラック対象リポジトリの場合

flowchart TD
    TITLE["skillshare update _team-skills"]
    S1["1. Check for uncommitted changes"]
    S2["2. Run git pull"]
    S3["3. Security audit gate"]
    S4["4. Show changes"]
    TITLE --> S1 -- clean --> S2 --> S3
    S3 -- pass --> S4
    S3 -- "At/above threshold" --> RB["Rollback"]

    style RB fill:#ef4444,color:#fff

通常の Skill の場合

flowchart TD
    TITLE["skillshare update my-skill"]
    S1["1. Read metadata"]
    S2["2. Re-install from source"]
    S3["3. Security audit gate"]
    TITLE --> S1 --> S2 --> S3

オプション

| フラグ | 説明 | |------|-------------| | `--all, -a` | すべての tracked repos/skills を更新、または `update agents --all` として使う場合はすべての agents を更新 | | `--group, -G <name>` | グループ内の更新可能なすべての skill、または agent サブディレクトリ内のすべての agent を更新 | | `--force, -f` | ローカルの変更を破棄し、audit の検出結果があっても続行 | | `--dry-run, -n` | 変更を加えずにプレビュー | | `--skip-audit` | 更新後の security audit gate をスキップ | | `--audit-threshold <t>`, `--threshold <t>`, `-T <t>` | update の audit ブロックしきい値を上書き（`critical|high|medium|low|info`；省略形: `c|h|m|l|i`、加えて `crit`、`med`） | | `--diff` | skill/repo 更新後にファイルレベルの変更サマリーを表示 | | `--audit-verbose` | batch mode で skill ごとの詳細な audit 検出結果を表示 | | `--prune` | 古い skill（upstream で削除済み）を警告ではなく削除 | | `--project, -p` | カレントディレクトリの project レベルの config を使用 | | `--global, -g` | global config を使用（`~/.config/skillshare`） | | `--json` | JSON として出力 | | `--help, -h` | ヘルプを表示 |

`update agents` は以下をサポートします: `--all`、`--group`、`--force`、`--dry-run`、`--skip-audit`、`--audit-threshold` / `--threshold` / `-T`、`--json`、加えて `--project` / `--global`。`--diff`、`--audit-verbose`、`--prune` は**サポートされません**。

JSON 出力

skillshare update --all --json

{
  "updated": 3,
  "skipped": 1,
  "security_failed": 0,
  "pruned": 0,
  "dry_run": false,
  "duration": "4.567s",
  "items": [
    {"name": "_team-skills", "type": "repo", "status": "updated"},
    {"name": "my-skill", "type": "skill", "status": "updated"},
    {"name": "another-skill", "type": "skill", "status": "updated"},
    {"name": "local-only", "type": "skill", "status": "skipped"}
  ]
}

取りうる `status` の値: `updated`、`skipped`、`failed`、`security_blocked`。項目が失敗した場合、`error` フィールドが含まれます。

tracked repos が metadata に宣言されているがディスク上に存在しない場合、それぞれがスキップされた `repo` 項目として簡潔な `error`（`clone directory absent`）と共に報告され、集計された `missing_tracked_repos` サマリーに名前と再水和（rehydration）のヒントがまとめて含まれます。

{
  "updated": 0,
  "skipped": 1,
  "items": [
    {"name": "_team-skills", "type": "repo", "status": "skipped", "error": "clone directory absent"}
  ],
  "missing_tracked_repos": {
    "names": ["_team-skills"],
    "hint": "Run 'skillshare install' to rehydrate tracked repositories"
  }
}

`missing_tracked_repos` フィールドは、欠落している tracked repos がない場合は省略されます。

Agent の JSON 出力

skillshare update agents --all --json

{
  "agents": [
    {"name": "reviewer", "status": "updated", "source": "github.com/user/agents/reviewer.md"},
    {"name": "team/tutor", "status": "up_to_date", "source": "github.com/user/agents/team/tutor.md"}
  ],
  "dry_run": false,
  "duration": "1.234s"
}

取りうる agent の `status` の値には `updated`、`failed`、`skipped`、`up_to_date`、`update_available`、`dirty`、`drifted`、`local` が含まれます。

Agents の更新

スタンドアロンの `.md` agents のみを更新したい場合は `agents` kind セレクターを使います。

skillshare update agents reviewer
skillshare update agents --group team
skillshare update agents --all -T high
skillshare update agents --all --json

Agent の更新は skills と同じ audit gate に従います:

• tracked agent repos は `git pull` を実行し、その後更新されたリポジトリを audit する
• metadata で紐づけられた単一ファイルの agents は source から再インストールし、staged された `.md` を audit し、成功した場合のみローカルファイルを置き換える

複数更新

複数の skill を一度に更新します。

skillshare update skill-a skill-b skill-c

更新可能な skill（tracked repos または metadata を持つ skill）のみが処理されます。見つからない skill は警告されますが失敗にはなりません。ただし、いずれかの skill が **security audit gate によってブロック**された場合、バッチコマンドは非ゼロのコードで終了します。

Glob パターン

skill 名は、バッチ操作のために glob パターン（`*`、`?`、`[...]`）をサポートします。

skillshare update "core-*"              # core-* に一致するすべての skill を更新
skillshare update "_team-?"             # 1 文字ワイルドカード
skillshare update "core-*" "util-*"     # 複数のパターン

Glob パターンは、各 skill または tracked repo の**basename**（パスの最後の要素）に対してマッチします。例えば、`"react-*"` は basename が `react-hooks` であるため `frontend/react-hooks` にマッチします。

Glob マッチングは大文字・小文字を区別しません: `"Core-*"` は `core-auth`、`CORE-DB` などに一致します。

:::tip シェルの Glob 保護 シェルがカレントディレクトリのファイル名に `*` を展開してしまうのを防ぐため、glob パターンは常に引用符で囲んでください（`"core-*"`）。 :::

グループの更新

グループディレクトリ内の更新可能なすべての skill を更新します。

skillshare update --group frontend        # frontend/ 内のすべてを更新
skillshare update -G frontend -G backend  # 複数のグループ
skillshare update x -G backend            # 名前とグループを混在

グループ内の（metadata や `.git` を持たない）ローカル skill は黙ってスキップされます。

グループディレクトリに一致する位置引数（repo でも skill でもない）は自動的に展開されます。

skillshare update frontend   # --group frontend と同じ
# ℹ 'frontend' is a group — expanding to 3 updatable skill(s)

:::note `--all` は skill 名や `--group` と組み合わせることはできません。 :::

すべて更新

すべてを一度に更新します。

skillshare update --all

これにより以下が更新されます: 1. すべての tracked repositories（git pull） 2. source metadata を持つすべての skill（再インストール）

出力例

Updating 2 tracked repos + 3 skills

[1/5] ✓ _team-skills       Already up to date
[2/5] ✓ _personal-repo     3 commits, 2 files
[3