docs(comparison): re-pin the npx skills comparison to v1.8.1 (#864)

* docs(comparison): re-pin the npx skills comparison to v1.8.1

The comparison and migration pages cited skills v1.7.6. Since v1.8.0
the restore command links restored skills into agent directories, so
the page's statement that it does not was wrong. The page also did not
say that `skills install` with no source is the same restore command,
that matching skills only get their missing agent links, or that
`skills check` exits 1 on updates or local changes.

Re-pin both pages and their four translations to the v1.8.1 tag commit
and correct those statements against its CLI reference. The lock paths
and fields the migration guide names are unchanged in v1.8.1.

* chore: ignore .feature-radar/

The feature-radar skill keeps its tracking notes, including assessments
of other tools, in .feature-radar/ at the repository root. They are
local working notes and should not be committed to the public
repository.
This commit is contained in:
Willie
2026-11-11 23:10:46 +08:00
committed by GitHub
parent 769087b882
commit 11c2f41b80
11 changed files with 31 additions and 30 deletions
+1
View File
@@ -44,3 +44,4 @@ video/node_modules/
/specs/
.archify/
.playwright-mcp
.feature-radar/
+1 -1
View File
@@ -88,7 +88,7 @@ You can keep using `npx skills` for skills it already manages, or hand selected
**There is no automatic npx lock import or ownership transfer.** Collecting preserves local skill files, not their upstream tracking. Reinstalling from a repository creates Skillshare tracking, but may fetch different content from your existing installation.
The paths and lock fields below refer to **skills v1.7.6**: [global lock source](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/skill-lock.ts), [project lock source](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/local-lock.ts), and [CLI reference](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md).
The paths and lock fields below refer to **skills v1.8.1**: [global lock source](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/skill-lock.ts), [project lock source](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/local-lock.ts), and [CLI reference](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md).
| Item | Global | Project |
|------|--------|---------|
@@ -6,7 +6,7 @@ sidebar_position: 9
Both **Vercel's `npx skills`** and **Skillshare** manage skills across multiple AI tools. The difference is not “one installs, the other syncs.” Choose by what you need to manage: skills, or a broader AI working environment.
This comparison uses the published **skills v1.7.6** [package metadata](https://registry.npmjs.org/skills/1.7.6) and its [official CLI reference](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md). Experimental commands may change or disappear; this is a versioned comparison, not a claim about every installer.
This comparison uses the published **skills v1.8.1** [package metadata](https://registry.npmjs.org/skills/1.8.1) and its [official CLI reference](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md). Experimental commands may change or disappear; this is a versioned comparison, not a claim about every installer.
## Architecture at a Glance
@@ -24,13 +24,13 @@ The useful distinction is managing these resources together across tools, machin
## Feature Comparison
| Capability | npx skills v1.7.6 | Skillshare |
| Capability | npx skills v1.8.1 | Skillshare |
|------------|------------------|------------|
| **Discovery** | skills.sh and `skills find` | CLI search and local Web dashboard |
| **Multiple agents and scopes** | Multiple agents; project and global installs | Configured targets; project and global modes |
| **Shared skill files** | Symlinks to a canonical copy; copy option | Source directory with merge, copy, or directory-symlink modes |
| **Updates** | `skills check` and `skills update` | `skillshare check` and `skillshare update` |
| **Project restoration** | Experimental `skills experimental_install` restores supported sources from `skills-lock.json` | Declarative skill configuration and source resources; see [manifest](/docs/understand/declarative-manifest) |
| **Updates** | `skills check` (exits 1 on updates or local changes) and `skills update` | `skillshare check` and `skillshare update` |
| **Project restoration** | Experimental `skills experimental_install` (or `skills install` with no source) restores supported sources from `skills-lock.json` | Declarative skill configuration and source resources; see [manifest](/docs/understand/declarative-manifest) |
| **npm project sync** | Experimental `skills experimental_sync` reads installed dependencies and `package.json` skill declarations | Source-to-target synchronization; not the same npm dependency workflow |
| **Cross-machine workflow** | Project lock restoration and npm sync can help rebuild project skills | Git-backed `push` / `pull`, scoped by `git_root` |
| **Beyond skills** | The cited CLI reference focuses on skills | Agent definitions, extras such as rules, MCP settings, and hooks for supported clients |
@@ -39,7 +39,7 @@ The useful distinction is managing these resources together across tools, machin
### What the experimental commands cover
- **`experimental_install`** restores supported lock entries into `.agents/skills/`. It does not install npm dependencies or create agent-specific links for restored skills. Existing skills are left alone unless explicitly reinstalled. Frozen-lock mode checks content hashes and is the default in CI.
- **`experimental_install`** (also run as `skills install` with no source) restores supported lock entries into `.agents/skills/` and links them into agent directories (copies for skills recorded in copy mode): those given with `--agent`, otherwise the agents last selected, otherwise the agents it detects. It does not install npm dependencies. Installed skills whose files match the lock's content hash are not fetched again and only get the agent links they are missing; skills whose files differ are restored from their source, and `--force` reinstalls every skill. Frozen-lock mode checks content hashes and is the default in CI.
- **`experimental_sync`** links skills shipped by installed npm dependencies and resolves skill declarations in `package.json`. It tracks these in `skills-lock.json`, removes skills no longer provided, and preserves separately added skills. Copies require another sync after dependency updates.
These are real synchronization and restoration capabilities, but they are not a backup of an entire AI tool configuration.
@@ -88,7 +88,7 @@ skillshare sync
**npx lock の自動インポートや管理権の自動移行はありません。** Collect はローカルの skill ファイルを保存しますが、取得元の追跡情報は引き継ぎません。リポジトリから再インストールすると Skillshare の追跡情報が作られますが、既存インストールとは内容が異なる場合があります。
以下のパスと lock フィールドは **skills v1.7.6** に基づきます:[グローバル lock のソース](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/skill-lock.ts)、[プロジェクト lock のソース](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/local-lock.ts)、[CLI リファレンス](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md)。
以下のパスと lock フィールドは **skills v1.8.1** に基づきます:[グローバル lock のソース](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/skill-lock.ts)、[プロジェクト lock のソース](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/local-lock.ts)、[CLI リファレンス](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md)。
| 項目 | Global | Project |
|------|--------|---------|
@@ -6,7 +6,7 @@ sidebar_position: 9
**Vercel の `npx skills`** と **Skillshare** は、どちらも複数の AI ツールで skills を管理できます。違いは「一方はインストールだけ、もう一方は同期できる」ではありません。skills を管理したいのか、より広い AI 作業環境を管理したいのかで選びましょう。
本ページは、公開済みの **skills v1.7.6** の[パッケージ情報](https://registry.npmjs.org/skills/1.7.6)と[公式 CLI リファレンス](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md)に基づきます。実験的なコマンドは変更・削除される可能性があります。すべてのインストーラーについての一般論ではなく、特定バージョンの比較です。
本ページは、公開済みの **skills v1.8.1** の[パッケージ情報](https://registry.npmjs.org/skills/1.8.1)と[公式 CLI リファレンス](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md)に基づきます。実験的なコマンドは変更・削除される可能性があります。すべてのインストーラーについての一般論ではなく、特定バージョンの比較です。
## アーキテクチャの概要
@@ -24,13 +24,13 @@ Skillshare は source リソースと target 設定を分け、各ツールへ
## 機能比較
| 機能 | npx skills v1.7.6 | Skillshare |
| 機能 | npx skills v1.8.1 | Skillshare |
|------|------------------|------------|
| **発見** | skills.sh と `skills find` | CLI 検索とローカル Web dashboard |
| **複数 agent とスコープ** | 複数 agent、プロジェクト/グローバルのインストール | 設定済み targets、プロジェクト/グローバルモード |
| **Skill ファイルの共有** | 共通コピーへの symlink、copy オプション | Source ディレクトリと merge、copy、ディレクトリ全体の symlink モード |
| **更新** | `skills check` と `skills update` | `skillshare check` と `skillshare update` |
| **プロジェクト復元** | 実験的な `skills experimental_install` が `skills-lock.json` の対応ソースを復元 | 宣言的な skill 設定と source リソース。[manifest](/docs/understand/declarative-manifest) を参照 |
| **更新** | `skills check`(更新またはローカル変更があれば終了コード 1)と `skills update` | `skillshare check` と `skillshare update` |
| **プロジェクト復元** | 実験的な `skills experimental_install`(ソースなしの `skills install` でも実行可能)が `skills-lock.json` の対応ソースを復元 | 宣言的な skill 設定と source リソース。[manifest](/docs/understand/declarative-manifest) を参照 |
| **npm プロジェクト同期** | 実験的な `skills experimental_sync` がインストール済み依存関係と `package.json` の skill 宣言を読む | Source から target への同期。同じ npm 依存関係ワークフローではない |
| **マシン間のワークフロー** | プロジェクト lock の復元と npm 同期でプロジェクト skills の再構築を支援 | Git の `push` / `pull`。範囲は `git_root` で決定 |
| **Skills 以外** | 引用した CLI 文書は skills が中心 | Agent 定義、rules などの extras、MCP 設定、対応クライアントの hooks |
@@ -39,7 +39,7 @@ Skillshare は source リソースと target 設定を分け、各ツールへ
### 実験的なコマンドの範囲
- **`experimental_install`** は対応する lock エントリーを `.agents/skills/` に復元します。npm 依存関係のインストールや、復元した skills の agent 専用リンクの作成は行いません。明示的に再インストールしない限り既存 skills は保持されます。Frozen-lock モードでは内容の hash を検証し、CI ではこれがデフォルトです。
- **`experimental_install`**(ソースなしの `skills install` でも実行可能)は対応する lock エントリーを `.agents/skills/` に復元し、agent ディレクトリにリンクします(copy モードで記録された skills はコピー)。対象は `--agent` で指定した agent、指定がなければ前回選択した agent、それもなければ検出された agent です。npm 依存関係のインストールは行いません。インストール済みでファイルが lock の内容 hash と一致する skills は再取得されず、不足している agent リンクだけが追加されます。内容が異なる skills はソースから復元され、`--force` はすべての skills を再インストールします。Frozen-lock モードでは内容の hash を検証し、CI ではこれがデフォルトです。
- **`experimental_sync`** はインストール済み npm 依存関係に含まれる skills をリンクし、`package.json` の skill 宣言を解決します。`skills-lock.json` で追跡し、提供されなくなった skills を削除し、別途追加した skills は保持します。Copy の場合、依存関係の更新後に再同期が必要です。
これらは実際の同期・復元機能ですが、AI ツール設定全体のバックアップではありません。
@@ -88,7 +88,7 @@ skillshare sync
**npx lock 자동 가져오기나 자동 관리권 이전 기능은 없습니다.** Collect는 로컬 skill 파일을 보존하지만 원본 추적 정보는 가져오지 않습니다. 저장소에서 다시 설치하면 Skillshare 추적 정보가 생기지만 기존 설치와 다른 콘텐츠를 받을 수 있습니다.
아래 경로와 lock 필드는 **skills v1.7.6** 기준입니다: [전역 lock 소스](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/skill-lock.ts), [프로젝트 lock 소스](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/local-lock.ts), [CLI 문서](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md).
아래 경로와 lock 필드는 **skills v1.8.1** 기준입니다: [전역 lock 소스](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/skill-lock.ts), [프로젝트 lock 소스](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/local-lock.ts), [CLI 문서](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md).
| 항목 | Global | Project |
|------|--------|---------|
@@ -6,7 +6,7 @@ sidebar_position: 9
**Vercel의 `npx skills`**와 **Skillshare**는 모두 여러 AI 도구에서 skills를 관리합니다. 차이는 “하나는 설치만, 다른 하나는 동기화”가 아닙니다. Skills를 관리할지, 더 넓은 AI 작업 환경을 관리할지에 따라 선택하세요.
이 비교는 배포된 **skills v1.7.6**의 [패키지 정보](https://registry.npmjs.org/skills/1.7.6)와 [공식 CLI 문서](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md)를 기준으로 합니다. 실험적 명령은 변경되거나 사라질 수 있습니다. 모든 설치 도구에 대한 일반화가 아니라 특정 버전의 비교입니다.
이 비교는 배포된 **skills v1.8.1**의 [패키지 정보](https://registry.npmjs.org/skills/1.8.1)와 [공식 CLI 문서](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md)를 기준으로 합니다. 실험적 명령은 변경되거나 사라질 수 있습니다. 모든 설치 도구에 대한 일반화가 아니라 특정 버전의 비교입니다.
## 아키텍처 개요
@@ -24,13 +24,13 @@ Skillshare는 source 리소스와 target 설정을 분리한 뒤 각 도구에
## 기능 비교
| 기능 | npx skills v1.7.6 | Skillshare |
| 기능 | npx skills v1.8.1 | Skillshare |
|------|------------------|------------|
| **발견** | skills.sh 및 `skills find` | CLI 검색 및 로컬 Web dashboard |
| **여러 agent와 범위** | 여러 agent, 프로젝트 및 전역 설치 | 설정된 targets, 프로젝트 및 전역 모드 |
| **Skill 파일 공유** | 공통 복사본을 가리키는 symlink, copy 옵션 | Source 디렉터리와 merge, copy, 전체 디렉터리 symlink 모드 |
| **업데이트** | `skills check` 및 `skills update` | `skillshare check` 및 `skillshare update` |
| **프로젝트 복원** | 실험적 `skills experimental_install`이 `skills-lock.json`의 지원 소스를 복원 | 선언적 skill 설정과 source 리소스. [manifest](/docs/understand/declarative-manifest) 참고 |
| **업데이트** | `skills check`(업데이트나 로컬 변경이 있으면 종료 코드 1) 및 `skills update` | `skillshare check` 및 `skillshare update` |
| **프로젝트 복원** | 실험적 `skills experimental_install`(소스 없이 `skills install`로도 실행)이 `skills-lock.json`의 지원 소스를 복원 | 선언적 skill 설정과 source 리소스. [manifest](/docs/understand/declarative-manifest) 참고 |
| **npm 프로젝트 동기화** | 실험적 `skills experimental_sync`가 설치된 의존성과 `package.json`의 skill 선언을 읽음 | Source에서 target으로 동기화. 동일한 npm 의존성 워크플로우는 아님 |
| **머신 간 워크플로우** | 프로젝트 lock 복원과 npm 동기화로 프로젝트 skills 재구성 지원 | Git `push` / `pull`, 범위는 `git_root`로 결정 |
| **Skills 외 리소스** | 인용한 CLI 문서는 skills 중심 | Agent 정의, rules 같은 extras, MCP 설정, 지원 클라이언트의 hooks |
@@ -39,7 +39,7 @@ Skillshare는 source 리소스와 target 설정을 분리한 뒤 각 도구에
### 실험적 명령의 범위
- **`experimental_install`**은 지원하는 lock 항목을 `.agents/skills/`에 복원합니다. npm 의존성을 설치하거나 복원한 skills에 agent 전용 링크를 만들지는 않습니다. 명시적으로 재설치하지 않으면 기존 skills는 유지됩니다. Frozen-lock 모드는 콘텐츠 hash를 검사하며 CI에서 기본값입니다.
- **`experimental_install`**(소스 없이 `skills install`로도 실행)은 지원하는 lock 항목을 `.agents/skills/`에 복원하고 agent 디렉터리에 링크합니다(copy 모드로 기록된 skills는 복사). 대상은 `--agent`로 지정한 agent이며, 지정하지 않으면 마지막으로 선택한 agent, 그것도 없으면 감지된 agent입니다. npm 의존성은 설치하지 않습니다. 이미 설치되어 있고 파일이 lock의 콘텐츠 hash와 일치하는 skills는 다시 가져오지 않고 빠진 agent 링크만 추가합니다. 내용이 다른 skills는 소스에서 복원하며, `--force`는 모든 skills를 재설치합니다. Frozen-lock 모드는 콘텐츠 hash를 검사하며 CI에서 기본값입니다.
- **`experimental_sync`**는 설치된 npm 의존성에 포함된 skills를 연결하고 `package.json`의 skill 선언을 처리합니다. `skills-lock.json`으로 추적하고 더 이상 제공되지 않는 skills를 제거하며 별도로 추가한 skills는 보존합니다. Copy를 사용하면 의존성 업데이트 후 다시 동기화해야 합니다.
이는 실제 동기화 및 복원 기능이지만 AI 도구 설정 전체의 백업은 아닙니다.
@@ -88,7 +88,7 @@ skillshare sync
**目前没有自动导入 npx lock 或移交管理权的功能。** Collect 保留本地 skill 文件,不会导入上游跟踪信息。从仓库重新安装会建立 Skillshare 的跟踪信息,但获取的内容可能与现有安装不同。
以下路径与 lock 字段依据 **skills v1.7.6**:[全局 lock 源码](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/skill-lock.ts)、[项目 lock 源码](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/local-lock.ts)及 [CLI 文档](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md)。
以下路径与 lock 字段依据 **skills v1.8.1**:[全局 lock 源码](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/skill-lock.ts)、[项目 lock 源码](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/local-lock.ts)及 [CLI 文档](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md)。
| 项目 | Global | Project |
|------|--------|---------|
@@ -6,7 +6,7 @@ sidebar_position: 9
**Vercel 的 `npx skills`** 和 **Skillshare** 都能跨多个 AI 工具管理 skills。差别不是“一个只能安装,另一个才能同步”,而是你需要管理 skills,还是更完整的 AI 工作环境。
本页依据已发布的 **skills v1.7.6** [包信息](https://registry.npmjs.org/skills/1.7.6)及其[官方 CLI 文档](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md)。实验性命令可能变更或移除;这是指定版本的比较,不是对所有安装工具的概括。
本页依据已发布的 **skills v1.8.1** [包信息](https://registry.npmjs.org/skills/1.8.1)及其[官方 CLI 文档](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md)。实验性命令可能变更或移除;这是指定版本的比较,不是对所有安装工具的概括。
## 架构概览
@@ -24,13 +24,13 @@ Skillshare 将源资源与 target 配置分开,再同步到各工具。除了
## 功能比较
| 能力 | npx skills v1.7.6 | Skillshare |
| 能力 | npx skills v1.8.1 | Skillshare |
|------|------------------|------------|
| **发现** | skills.sh 与 `skills find` | CLI 搜索与本地 Web dashboard |
| **多 agent 与范围** | 多 agent;项目与全局安装 | 配置中的 targets;项目与全局模式 |
| **共享 skill 文件** | 指向共享副本的符号链接;可选 copy | 源目录搭配 merge、copy 或整个目录的 symlink 模式 |
| **更新** | `skills check` 与 `skills update` | `skillshare check` 与 `skillshare update` |
| **项目恢复** | 实验性 `skills experimental_install` 从 `skills-lock.json` 恢复支持的来源 | 声明式 skill 配置与源资源;见 [manifest](/docs/understand/declarative-manifest) |
| **更新** | `skills check`(有更新或本地修改时以退出码 1 结束)与 `skills update` | `skillshare check` 与 `skillshare update` |
| **项目恢复** | 实验性 `skills experimental_install`(或不带来源的 `skills install`)从 `skills-lock.json` 恢复支持的来源 | 声明式 skill 配置与源资源;见 [manifest](/docs/understand/declarative-manifest) |
| **npm 项目同步** | 实验性 `skills experimental_sync` 读取已安装依赖与 `package.json` 的 skill 声明 | 源到 target 的同步;不是相同的 npm 依赖工作流 |
| **跨机器工作流** | 项目 lock 恢复与 npm 同步可协助重建项目 skills | Git `push` / `pull`,范围由 `git_root` 决定 |
| **Skills 以外** | 所引用的 CLI 文档以 skills 为主 | Agent 定义、rules 等 extras、MCP 设置与支持客户端的 hooks |
@@ -39,7 +39,7 @@ Skillshare 将源资源与 target 配置分开,再同步到各工具。除了
### 实验性命令涵盖什么
- **`experimental_install`** 将支持的 lock 条目恢复到 `.agents/skills/`。它不会安装 npm 依赖,也不会为恢复的 skills 创建 agent 专用链接。除非明确要求重新安装,否则保留已有 skills。Frozen-lock 模式会检查内容 hash,且为 CI 默认值。
- **`experimental_install`**(也可用不带来源的 `skills install` 执行)将支持的 lock 条目恢复到 `.agents/skills/`,并链接到 agent 目录(以 copy 模式记录的 skills 则为复制):优先使用 `--agent` 指定的 agent,其次是上次选择的 agent,再其次是检测到的 agent。它不会安装 npm 依赖。已安装且文件与 lock 内容 hash 一致的 skills 不会重新获取,只补上缺少的 agent 链接;内容不一致的 skills 会从来源恢复,`--force` 则重新安装所有 skills。Frozen-lock 模式会检查内容 hash,且为 CI 默认值。
- **`experimental_sync`** 链接已安装 npm 依赖附带的 skills,并解析 `package.json` 的 skill 声明。它通过 `skills-lock.json` 跟踪这些条目、移除不再提供的 skills,并保留另外安装的 skills。使用 copy 时,依赖更新后需要再次同步。
这些确实是同步与恢复能力,但不是整套 AI 工具配置的备份。
@@ -88,7 +88,7 @@ skillshare sync
**目前沒有自動匯入 npx lock 或移交管理權的功能。** Collect 保留本地 skill 檔案,不會匯入上游追蹤資訊。從 repository 重新安裝會建立 Skillshare 的追蹤資訊,但取得的內容可能與既有安裝不同。
以下路徑與 lock 欄位依據 **skills v1.7.6**:[全域 lock 原始碼](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/skill-lock.ts)、[專案 lock 原始碼](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/src/local-lock.ts)及 [CLI 文件](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md)。
以下路徑與 lock 欄位依據 **skills v1.8.1**:[全域 lock 原始碼](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/skill-lock.ts)、[專案 lock 原始碼](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/src/local-lock.ts)及 [CLI 文件](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md)。
| 項目 | Global | Project |
|------|--------|---------|
@@ -6,7 +6,7 @@ sidebar_position: 9
**Vercel 的 `npx skills`** 和 **Skillshare** 都能跨多個 AI 工具管理 skills。差別不是「一個只能安裝,另一個才能同步」,而是你需要管理 skills,還是更完整的 AI 工作環境。
本頁依據已發布的 **skills v1.7.6** [套件資訊](https://registry.npmjs.org/skills/1.7.6)及其[官方 CLI 文件](https://github.com/vercel-labs/skills/blob/7a5e920bead4b1039a6d6df5d7e1163b7b09423a/docs/commands.md)。實驗性命令可能變更或移除;這是指定版本的比較,不是對所有安裝工具的概括。
本頁依據已發布的 **skills v1.8.1** [套件資訊](https://registry.npmjs.org/skills/1.8.1)及其[官方 CLI 文件](https://github.com/vercel-labs/skills/blob/e781cb4d07433dfe1d19e924ed45cc61738c55ec/docs/commands.md)。實驗性命令可能變更或移除;這是指定版本的比較,不是對所有安裝工具的概括。
## 架構概覽
@@ -24,13 +24,13 @@ Skillshare 將來源資源與 target 設定分開,再同步到各工具。除
## 功能比較
| 能力 | npx skills v1.7.6 | Skillshare |
| 能力 | npx skills v1.8.1 | Skillshare |
|------|------------------|------------|
| **發現** | skills.sh 與 `skills find` | CLI 搜尋與本地 Web dashboard |
| **多 agent 與範圍** | 多 agent;專案與全域安裝 | 設定中的 targets;專案與全域模式 |
| **共用 skill 檔案** | 指向共用副本的 symlink;可選 copy | 來源目錄搭配 merge、copy 或整個目錄的 symlink 模式 |
| **更新** | `skills check` 與 `skills update` | `skillshare check` 與 `skillshare update` |
| **專案還原** | 實驗性 `skills experimental_install` 從 `skills-lock.json` 還原支援的來源 | 宣告式 skill 設定與來源資源;見 [manifest](/docs/understand/declarative-manifest) |
| **更新** | `skills check`(有更新或本地修改時以結束代碼 1 結束)與 `skills update` | `skillshare check` 與 `skillshare update` |
| **專案還原** | 實驗性 `skills experimental_install`(或不帶來源的 `skills install`)從 `skills-lock.json` 還原支援的來源 | 宣告式 skill 設定與來源資源;見 [manifest](/docs/understand/declarative-manifest) |
| **npm 專案同步** | 實驗性 `skills experimental_sync` 讀取已安裝依賴與 `package.json` 的 skill 宣告 | 來源到 target 的同步;不是相同的 npm 依賴工作流程 |
| **跨機器工作流程** | 專案 lock 還原與 npm 同步可協助重建專案 skills | Git `push` / `pull`,範圍由 `git_root` 決定 |
| **Skills 以外** | 所引用的 CLI 文件以 skills 為主 | Agent 定義、rules 等 extras、MCP 設定與支援用戶端的 hooks |
@@ -39,7 +39,7 @@ Skillshare 將來源資源與 target 設定分開,再同步到各工具。除
### 實驗性命令涵蓋什麼
- **`experimental_install`** 將支援的 lock 項目還原到 `.agents/skills/`。它不會安裝 npm 依賴,也不會為還原的 skills 建立 agent 專用連結。除非明確要求重新安裝,否則保留既有 skills。Frozen-lock 模式會檢查內容 hash,且為 CI 預設。
- **`experimental_install`**(也可用不帶來源的 `skills install` 執行)將支援的 lock 項目還原到 `.agents/skills/`,並連結到 agent 目錄(以 copy 模式記錄的 skills 則為複製):優先使用 `--agent` 指定的 agent,其次是上次選擇的 agent,再其次是偵測到的 agent。它不會安裝 npm 依賴。已安裝且檔案與 lock 內容 hash 一致的 skills 不會重新取得,只補上缺少的 agent 連結;內容不一致的 skills 會從來源還原,`--force` 則重新安裝所有 skills。Frozen-lock 模式會檢查內容 hash,且為 CI 預設。
- **`experimental_sync`** 連結已安裝 npm 依賴附帶的 skills,並解析 `package.json` 的 skill 宣告。它以 `skills-lock.json` 追蹤這些項目、移除不再提供的 skills,並保留另外安裝的 skills。使用 copy 時,依賴更新後需要再次同步。
這些確實是同步與還原能力,但不是整套 AI 工具設定的備份。