@dayinxisheng/skillctl 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.0.4] - 2026-03-05
9
+
10
+ ### Changed
11
+ - 更新 README.md,添加 `pull` 命令使用文档和示例
12
+ - 更新项目结构说明,包含新增的文件
13
+
8
14
  ## [1.0.3] - 2026-03-05
9
15
 
10
16
  ### Added
package/README.md CHANGED
@@ -162,7 +162,34 @@ skillctl import my-new-skill
162
162
  1. 将 skill 移动到你的项目仓库
163
163
  2. 在原位置创建软链接
164
164
 
165
- ### 5. 定位 Skill
165
+ ### 5. 拉取 Skill
166
+
167
+ 从 Git 仓库(如 GitHub)拉取 skill 到本地:
168
+
169
+ ```bash
170
+ # 拉取单个 skill
171
+ skillctl pull https://github.com/owner/repo path/to/skill
172
+
173
+ # 拉取多个 skills
174
+ skillctl pull https://github.com/owner/repo \
175
+ path/to/skill1 \
176
+ path/to/skill2
177
+
178
+ # 使用国内镜像(加速访问)
179
+ skillctl pull https://ghfast.top/https://github.com/owner/repo path/to/skill
180
+
181
+ # 强制覆盖已存在的 skill(自动备份)
182
+ skillctl pull <repo-url> <path> --force
183
+ ```
184
+
185
+ **特性:**
186
+ - 支持从 GitHub 仓库提取指定目录作为 skill
187
+ - 严格验证 SKILL.md 文件及 name 字段
188
+ - 下载进度显示
189
+ - 跨平台支持(Linux/macOS 使用 tar.gz,Windows 使用 zip)
190
+ - 支持国内镜像服务(ghfast.top、ghproxy.net 等)
191
+
192
+ ### 6. 定位 Skill
166
193
 
167
194
  查找 skill 的实际存储位置:
168
195
 
@@ -276,6 +303,7 @@ src/
276
303
  │ ├── activate.ts # 激活命令
277
304
  │ ├── deactivate.ts # 停用命令
278
305
  │ ├── import.ts # 导入命令
306
+ │ ├── pull.ts # 拉取命令
279
307
  │ ├── locate.ts # 定位命令
280
308
  │ ├── status.ts # 状态命令
281
309
  │ ├── list.ts # 列表命令
@@ -285,11 +313,16 @@ src/
285
313
  ├── lib/ # 核心业务逻辑
286
314
  │ ├── config-manager.ts # 配置管理
287
315
  │ ├── link-handler.ts # 软链接处理
316
+ │ ├── pull-handler.ts # 拉取处理逻辑
288
317
  │ └── skill-manager.ts # Skill 管理
289
318
  ├── utils/ # 工具函数
290
319
  │ ├── output.ts # 彩色输出
291
320
  │ ├── errors.ts # 错误类型
292
- └── platform.ts # 平台检测
321
+ ├── platform.ts # 平台检测
322
+ │ ├── downloader.ts # 下载工具
323
+ │ ├── archive-extractor.ts # 解压工具
324
+ │ ├── skill-validator.ts # Skill 验证
325
+ │ └── github-parser.ts # GitHub URL 解析
293
326
  └── types/ # TypeScript 类型定义
294
327
  └── index.ts
295
328
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dayinxisheng/skillctl",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "Claude Skills 管理工具 - 管理 Claude Skills 的激活状态和项目归档",
5
5
  "main": "dist/index.js",
6
6
  "bin": {