aweskill 0.1.5 → 0.1.7
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/README.md +119 -51
- package/README.zh-CN.md +121 -49
- package/dist/index.js +504 -275
- package/dist/index.js.map +1 -1
- package/package.json +4 -4
- package/resources/skill_archives/.gitkeep +1 -0
- package/resources/skill_archives/backup.md +7 -0
- /package/{template/bundles → resources/bundle_templates}/K-Dense-AI-scientific-skills.yaml +0 -0
- /package/{template/bundles → resources/bundle_templates}/Superpowers.yaml +0 -0
- /package/{template/bundles → resources/bundle_templates}/global.yaml +0 -0
package/README.md
CHANGED
|
@@ -3,15 +3,15 @@
|
|
|
3
3
|
<h1>aweskill: One Skill Store for All Your Coding Agents</h1>
|
|
4
4
|
<p><strong>Local skill orchestration CLI for AI coding agents.</strong></p>
|
|
5
5
|
<p>
|
|
6
|
-
<a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.
|
|
6
|
+
<a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.7-7C3AED?style=flat-square" alt="Version"></a>
|
|
7
7
|
<a href="https://github.com/mugpeng/aweskill"><img src="https://img.shields.io/badge/node-%E2%89%A520-0EA5E9?style=flat-square" alt="Node"></a>
|
|
8
8
|
<a href="https://github.com/mugpeng/aweskill/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-22C55E?style=flat-square" alt="License"></a>
|
|
9
9
|
<a href="./README.zh-CN.md"><img src="https://img.shields.io/badge/README-%E4%B8%AD%E6%96%87-64748B?style=flat-square" alt="Chinese README"></a>
|
|
10
10
|
</p>
|
|
11
11
|
<p>
|
|
12
12
|
<img src="https://img.shields.io/badge/status-beta-c96a3d?style=flat-square" alt="Status">
|
|
13
|
-
<img src="https://img.shields.io/badge/agents-
|
|
14
|
-
<img src="https://img.shields.io/badge/projection-symlink
|
|
13
|
+
<img src="https://img.shields.io/badge/agents-47_supported-0ea5a4?style=flat-square" alt="Supported agents">
|
|
14
|
+
<img src="https://img.shields.io/badge/projection-symlink-1f2328?style=flat-square" alt="Projection mode">
|
|
15
15
|
<img src="https://img.shields.io/badge/platform-local%20CLI-334155?style=flat-square" alt="Local CLI">
|
|
16
16
|
</p>
|
|
17
17
|
</div>
|
|
@@ -28,6 +28,49 @@ Instead of copying the same skill folders into every tool by hand, `aweskill` ke
|
|
|
28
28
|
- **Managed enable/disable model** without a separate global activation file
|
|
29
29
|
- **Backup, restore, dedupe, and recovery** built into the CLI
|
|
30
30
|
|
|
31
|
+
## Install
|
|
32
|
+
|
|
33
|
+
### Install from npm (recommended)
|
|
34
|
+
|
|
35
|
+
Requires [Node.js](https://nodejs.org/) 20 or later.
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npm install -g aweskill
|
|
39
|
+
aweskill --help
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
To pin a specific release:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
npm install -g aweskill@0.1.7
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Package page: [npmjs.com/package/aweskill](https://www.npmjs.com/package/aweskill)
|
|
49
|
+
|
|
50
|
+
### Install from this repository
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
npm install
|
|
54
|
+
npm run build
|
|
55
|
+
npm install -g .
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Local development link
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
npm install
|
|
62
|
+
npm link
|
|
63
|
+
aweskill --help
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Install from packed tarball
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npm install
|
|
70
|
+
npm pack
|
|
71
|
+
npm install -g ./aweskill-0.1.7.tgz
|
|
72
|
+
```
|
|
73
|
+
|
|
31
74
|
## Quick Start
|
|
32
75
|
|
|
33
76
|
```bash
|
|
@@ -62,7 +105,7 @@ aweskill agent list
|
|
|
62
105
|
|
|
63
106
|
That projection is the activation model.
|
|
64
107
|
|
|
65
|
-
- If a managed symlink
|
|
108
|
+
- If a managed symlink exists, the skill is enabled
|
|
66
109
|
- If it does not exist, the skill is disabled
|
|
67
110
|
- There is no separate global activation registry to reconcile
|
|
68
111
|
|
|
@@ -70,7 +113,7 @@ That projection is the activation model.
|
|
|
70
113
|
|
|
71
114
|
Supported agents currently include:
|
|
72
115
|
|
|
73
|
-
`amp`, `claude-code`, `cline`, `codex`, `cursor`, `gemini-cli`, `goose`, `opencode`, `roo`, `windsurf`
|
|
116
|
+
`adal`, `amp`, `antigravity`, `augment`, `bob`, `claude-code`, `cline`, `codebuddy`, `command-code`, `continue`, `codex`, `copilot`, `cortex`, `crush`, `cursor`, `deepagents`, `droid`, `firebender`, `gemini-cli`, `github-copilot`, `goose`, `iflow-cli`, `junie`, `kilo`, `kilo-code`, `kimi-cli`, `kiro-cli`, `kode`, `mcpjam`, `mistral-vibe`, `mux`, `neovate`, `openclaw`, `openclaude-ide`, `openhands`, `opencode`, `pi`, `pochi`, `qoder`, `qwen-code`, `replit`, `roo`, `trae`, `trae-cn`, `warp`, `windsurf`, `zencoder`
|
|
74
117
|
|
|
75
118
|
Key directories:
|
|
76
119
|
|
|
@@ -78,6 +121,7 @@ Key directories:
|
|
|
78
121
|
- Duplicate holding area: `~/.aweskill/dup_skills/`
|
|
79
122
|
- Backup archive: `~/.aweskill/backup/`
|
|
80
123
|
- Bundles: `~/.aweskill/bundles/*.yaml`
|
|
124
|
+
- Repo resources: `resources/bundle_templates/` and `resources/skill_archives/`
|
|
81
125
|
|
|
82
126
|
## Common Workflows
|
|
83
127
|
|
|
@@ -108,45 +152,21 @@ aweskill agent add bundle backend --global --agent all
|
|
|
108
152
|
### Keep the store clean
|
|
109
153
|
|
|
110
154
|
```bash
|
|
111
|
-
aweskill store backup
|
|
155
|
+
aweskill store backup --both
|
|
112
156
|
aweskill agent sync
|
|
113
157
|
aweskill agent recover --global --agent codex
|
|
114
158
|
aweskill doctor dedupe --fix
|
|
115
159
|
```
|
|
116
160
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
### Install from this repository
|
|
120
|
-
|
|
121
|
-
```bash
|
|
122
|
-
npm install
|
|
123
|
-
npm run build
|
|
124
|
-
npm install -g .
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
### Local development link
|
|
128
|
-
|
|
129
|
-
```bash
|
|
130
|
-
npm install
|
|
131
|
-
npm link
|
|
132
|
-
aweskill --help
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### Install from packed tarball
|
|
136
|
-
|
|
137
|
-
```bash
|
|
138
|
-
npm install
|
|
139
|
-
npm pack
|
|
140
|
-
npm install -g ./aweskill-0.1.5.tgz
|
|
141
|
-
```
|
|
161
|
+
By default, `store backup` and `store restore` only operate on `skills/`. Add `--both` to include `bundles/`, and pass an optional archive path to `store backup` if you want to export to a specific location.
|
|
142
162
|
|
|
143
163
|
## Command Surface
|
|
144
164
|
|
|
145
165
|
| Command | Description |
|
|
146
166
|
| --- | --- |
|
|
147
167
|
| `aweskill store init [--scan] [--verbose]` | Create the `~/.aweskill` layout |
|
|
148
|
-
| `aweskill store backup` | Archive the central skill store |
|
|
149
|
-
| `aweskill store restore <archive> [--override]` | Restore a previous backup |
|
|
168
|
+
| `aweskill store backup [archive] [--both]` | Archive the central skill store, optionally to a specific path |
|
|
169
|
+
| `aweskill store restore <archive> [--override] [--both]` | Restore a previous backup |
|
|
150
170
|
| `aweskill skill scan [--verbose]` | Scan supported agent skill directories |
|
|
151
171
|
| `aweskill skill import <path> [--mode cp\|mv] [--override]` | Import a skill or an entire skills root |
|
|
152
172
|
| `aweskill skill import --scan [--mode cp\|mv] [--override]` | Import the current scan results |
|
|
@@ -179,7 +199,7 @@ npm install -g ./aweskill-0.1.5.tgz
|
|
|
179
199
|
|
|
180
200
|
### Managed-only removal
|
|
181
201
|
|
|
182
|
-
`aweskill` removes only entries it can identify as its own managed symlinks
|
|
202
|
+
`aweskill` removes only entries it can identify as its own managed symlinks. It does not blindly delete arbitrary skill directories.
|
|
183
203
|
|
|
184
204
|
## Bundle File Format
|
|
185
205
|
|
|
@@ -195,9 +215,7 @@ skills:
|
|
|
195
215
|
## Projection Model
|
|
196
216
|
|
|
197
217
|
1. **Central source of truth for skill content**: `~/.aweskill/skills/<skill-name>/`.
|
|
198
|
-
2. **`agent add`** creates, for each selected agent and scope
|
|
199
|
-
- a **symlink** to that directory (most agents), or
|
|
200
|
-
- a **recursive copy** with a small marker file (for example Cursor).
|
|
218
|
+
2. **`agent add`** creates, for each selected agent and supported scope, a **symlink** to that directory.
|
|
201
219
|
3. **`agent remove`** removes only entries that are **managed by aweskill**.
|
|
202
220
|
4. **`agent sync`** removes managed projections whose central skill path is missing.
|
|
203
221
|
|
|
@@ -234,24 +252,74 @@ aweskill agent remove bundle backend --global --agent codex
|
|
|
234
252
|
aweskill agent recover --global --agent codex
|
|
235
253
|
```
|
|
236
254
|
|
|
237
|
-
## Templates
|
|
255
|
+
## Templates And Archives
|
|
256
|
+
|
|
257
|
+
Reference bundle templates now live in [resources/bundle_templates/K-Dense-AI-scientific-skills.yaml](/Users/peng/Desktop/Project/aweskills/resources/bundle_templates/K-Dense-AI-scientific-skills.yaml). Runtime bundles still live under `~/.aweskill/bundles/`.
|
|
258
|
+
|
|
259
|
+
`resources/skill_archives/` is reserved for repository-level `tar.gz` backups that you want to keep in-tree and share with other users. `aweskill` does not generate or restore these archives automatically.
|
|
238
260
|
|
|
239
|
-
|
|
261
|
+
For a shareable archive collection maintained outside this repository, see [oh-my-skills](https://github.com/mugpeng/oh-my-skills), a separate backup repository for skill bundles and full-snapshot archives.
|
|
240
262
|
|
|
241
263
|
## Supported Agents
|
|
242
264
|
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
|
251
|
-
|
|
|
252
|
-
| `
|
|
253
|
-
| `
|
|
254
|
-
| `
|
|
265
|
+
Works with 47 agents including:
|
|
266
|
+
|
|
267
|
+
**Claude Code** · **Cursor** · **Windsurf** · **Codex** · **GitHub Copilot** · **Gemini CLI** · **OpenCode** · **Goose** · **Amp** · **Roo Code** · **Kiro CLI** · **Kilo Code** · **Trae** · **Cline** · **Antigravity** · **Droid** · **Augment** · **OpenClaw** · **CodeBuddy** · **Command Code** · **Crush** · **Kode** · **Mistral Vibe** · **Mux** · **OpenClaude IDE** · **OpenHands** · **Qoder** · **Qwen Code** · **Replit** · **Trae CN** · **Neovate** · **AdaL**
|
|
268
|
+
|
|
269
|
+
<details>
|
|
270
|
+
<summary>All supported agents</summary>
|
|
271
|
+
|
|
272
|
+
| Agent | Global Path | Project Path |
|
|
273
|
+
| --- | --- | --- |
|
|
274
|
+
| `adal` | `~/.adal/skills/` | `<project>/.adal/skills/` |
|
|
275
|
+
| `amp` | `~/.agents/skills/` | `<project>/.agents/skills/` |
|
|
276
|
+
| `antigravity` | `~/.gemini/antigravity/skills/` | `<project>/.gemini/antigravity/skills/` |
|
|
277
|
+
| `augment` | `~/.augment/skills/` | `<project>/.augment/skills/` |
|
|
278
|
+
| `bob` | `~/.bob/skills/` | `<project>/.bob/skills/` |
|
|
279
|
+
| `claude-code` | `~/.claude/skills/` | `<project>/.claude/skills/` |
|
|
280
|
+
| `cline` | `~/.cline/skills/` | `<project>/.cline/skills/` |
|
|
281
|
+
| `codebuddy` | `~/.codebuddy/skills/` | `<project>/.codebuddy/skills/` |
|
|
282
|
+
| `command-code` | `~/.commandcode/skills/` | `<project>/.commandcode/skills/` |
|
|
283
|
+
| `continue` | `~/.continue/skills/` | `<project>/.continue/skills/` |
|
|
284
|
+
| `codex` | `~/.codex/skills/` | `<project>/.codex/skills/` |
|
|
285
|
+
| `copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
|
|
286
|
+
| `cortex` | `~/.snowflake/cortex/skills/` | `<project>/.cortex/skills/` |
|
|
287
|
+
| `crush` | `~/.config/crush/skills/` | `<project>/.config/crush/skills/` |
|
|
288
|
+
| `cursor` | `~/.cursor/skills/` | `<project>/.cursor/skills/` |
|
|
289
|
+
| `deepagents` | `~/.deepagents/agent/skills/` | `<project>/.deepagents/agent/skills/` |
|
|
290
|
+
| `droid` | `~/.factory/skills/` | `<project>/.factory/skills/` |
|
|
291
|
+
| `firebender` | `~/.firebender/skills/` | `<project>/.firebender/skills/` |
|
|
292
|
+
| `gemini-cli` | `~/.gemini/skills/` | `<project>/.gemini/skills/` |
|
|
293
|
+
| `github-copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
|
|
294
|
+
| `goose` | `~/.goose/skills/` | `<project>/.goose/skills/` |
|
|
295
|
+
| `iflow-cli` | `~/.iflow/skills/` | `<project>/.iflow/skills/` |
|
|
296
|
+
| `junie` | `~/.junie/skills/` | `<project>/.junie/skills/` |
|
|
297
|
+
| `kilo` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
|
|
298
|
+
| `kiro-cli` | `~/.kiro/skills/` | `<project>/.kiro/skills/` |
|
|
299
|
+
| `kilo-code` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
|
|
300
|
+
| `kimi-cli` | `~/.kimi/skills/` | `<project>/.kimi/skills/` |
|
|
301
|
+
| `kode` | `~/.kode/skills/` | `<project>/.kode/skills/` |
|
|
302
|
+
| `mcpjam` | `~/.mcpjam/skills/` | `<project>/.mcpjam/skills/` |
|
|
303
|
+
| `mistral-vibe` | `~/.vibe/skills/` | `<project>/.vibe/skills/` |
|
|
304
|
+
| `mux` | `~/.mux/skills/` | `<project>/.mux/skills/` |
|
|
305
|
+
| `neovate` | `~/.neovate/skills/` | `<project>/.neovate/skills/` |
|
|
306
|
+
| `openclaw` | `~/.openclaw/skills/` | `<project>/.openclaw/skills/` |
|
|
307
|
+
| `openclaude-ide` | `~/.openclaude/skills/` | `<project>/.openclaude/skills/` |
|
|
308
|
+
| `openhands` | `~/.openhands/skills/` | `<project>/.openhands/skills/` |
|
|
309
|
+
| `opencode` | `~/.opencode/skills/` | `<project>/.opencode/skills/` |
|
|
310
|
+
| `pi` | `~/.pi/agent/skills/` | `<project>/.pi/agent/skills/` |
|
|
311
|
+
| `pochi` | `~/.pochi/skills/` | `<project>/.pochi/skills/` |
|
|
312
|
+
| `qoder` | `~/.qoder/skills/` | `<project>/.qoder/skills/` |
|
|
313
|
+
| `qwen-code` | `~/.qwen/skills/` | `<project>/.qwen/skills/` |
|
|
314
|
+
| `replit` | `-` | `<project>/.agent/skills/` |
|
|
315
|
+
| `roo` | `~/.roo/skills/` | `<project>/.roo/skills/` |
|
|
316
|
+
| `trae` | `~/.trae/skills/` | `<project>/.trae/skills/` |
|
|
317
|
+
| `trae-cn` | `~/.trae-cn/skills/` | `<project>/.trae-cn/skills/` |
|
|
318
|
+
| `warp` | `~/.warp/skills/` | `<project>/.warp/skills/` |
|
|
319
|
+
| `windsurf` | `~/.codeium/windsurf/skills/` | `<project>/.codeium/windsurf/skills/` |
|
|
320
|
+
| `zencoder` | `~/.zencoder/skills/` | `<project>/.zencoder/skills/` |
|
|
321
|
+
|
|
322
|
+
</details>
|
|
255
323
|
|
|
256
324
|
## Related Tools
|
|
257
325
|
|
package/README.zh-CN.md
CHANGED
|
@@ -3,15 +3,15 @@
|
|
|
3
3
|
<h1>aweskill:为所有编码代理准备的一套 Skill 中央仓库</h1>
|
|
4
4
|
<p><strong>面向 AI 编码代理的本地 Skill 编排命令行工具。</strong></p>
|
|
5
5
|
<p>
|
|
6
|
-
<a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.
|
|
6
|
+
<a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.7-7C3AED?style=flat-square" alt="Version"></a>
|
|
7
7
|
<a href="https://github.com/mugpeng/aweskill"><img src="https://img.shields.io/badge/node-%E2%89%A520-0EA5E9?style=flat-square" alt="Node"></a>
|
|
8
8
|
<a href="https://github.com/mugpeng/aweskill/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-22C55E?style=flat-square" alt="License"></a>
|
|
9
9
|
<a href="./README.md"><img src="https://img.shields.io/badge/README-English-64748B?style=flat-square" alt="English README"></a>
|
|
10
10
|
</p>
|
|
11
11
|
<p>
|
|
12
12
|
<img src="https://img.shields.io/badge/status-beta-c96a3d?style=flat-square" alt="Status">
|
|
13
|
-
<img src="https://img.shields.io/badge/agents-
|
|
14
|
-
<img src="https://img.shields.io/badge/projection-symlink
|
|
13
|
+
<img src="https://img.shields.io/badge/agents-47_supported-0ea5a4?style=flat-square" alt="Supported agents">
|
|
14
|
+
<img src="https://img.shields.io/badge/projection-symlink-1f2328?style=flat-square" alt="Projection mode">
|
|
15
15
|
<img src="https://img.shields.io/badge/platform-local%20CLI-334155?style=flat-square" alt="Local CLI">
|
|
16
16
|
</p>
|
|
17
17
|
</div>
|
|
@@ -28,6 +28,49 @@
|
|
|
28
28
|
- **托管启用/停用模型**:不依赖额外的全局 activation 文件
|
|
29
29
|
- **自带维护能力**:备份、恢复、查重、recover、sync 都在 CLI 内部
|
|
30
30
|
|
|
31
|
+
## 安装
|
|
32
|
+
|
|
33
|
+
### 从 npm 安装(推荐)
|
|
34
|
+
|
|
35
|
+
需要 [Node.js](https://nodejs.org/) 20 及以上。
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npm install -g aweskill
|
|
39
|
+
aweskill --help
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
固定到某一版本:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
npm install -g aweskill@0.1.7
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
包主页:[npmjs.com/package/aweskill](https://www.npmjs.com/package/aweskill)
|
|
49
|
+
|
|
50
|
+
### 直接从当前仓库安装
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
npm install
|
|
54
|
+
npm run build
|
|
55
|
+
npm install -g .
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### 本地开发模式
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
npm install
|
|
62
|
+
npm link
|
|
63
|
+
aweskill --help
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### 用打包产物安装
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npm install
|
|
70
|
+
npm pack
|
|
71
|
+
npm install -g ./aweskill-0.1.7.tgz
|
|
72
|
+
```
|
|
73
|
+
|
|
31
74
|
## 快速开始
|
|
32
75
|
|
|
33
76
|
```bash
|
|
@@ -62,7 +105,7 @@ aweskill agent list
|
|
|
62
105
|
|
|
63
106
|
投影状态就是启用状态:
|
|
64
107
|
|
|
65
|
-
- 有托管的 symlink
|
|
108
|
+
- 有托管的 symlink,就表示启用
|
|
66
109
|
- 没有,就表示停用
|
|
67
110
|
- 不存在额外的全局 activation 注册表
|
|
68
111
|
|
|
@@ -70,7 +113,7 @@ aweskill agent list
|
|
|
70
113
|
|
|
71
114
|
当前支持的 agent:
|
|
72
115
|
|
|
73
|
-
`amp`、`claude-code`、`cline`、`codex`、`cursor`、`gemini-cli`、`goose`、`opencode`、`roo`、`windsurf`
|
|
116
|
+
`adal`、`amp`、`antigravity`、`augment`、`bob`、`claude-code`、`cline`、`codebuddy`、`command-code`、`continue`、`codex`、`copilot`、`cortex`、`crush`、`cursor`、`deepagents`、`droid`、`firebender`、`gemini-cli`、`github-copilot`、`goose`、`iflow-cli`、`junie`、`kilo`、`kilo-code`、`kimi-cli`、`kiro-cli`、`kode`、`mcpjam`、`mistral-vibe`、`mux`、`neovate`、`openclaw`、`openclaude-ide`、`openhands`、`opencode`、`pi`、`pochi`、`qoder`、`qwen-code`、`replit`、`roo`、`trae`、`trae-cn`、`warp`、`windsurf`、`zencoder`
|
|
74
117
|
|
|
75
118
|
关键目录:
|
|
76
119
|
|
|
@@ -78,6 +121,7 @@ aweskill agent list
|
|
|
78
121
|
- 重复项暂存区:`~/.aweskill/dup_skills/`
|
|
79
122
|
- 备份目录:`~/.aweskill/backup/`
|
|
80
123
|
- Bundle 文件:`~/.aweskill/bundles/*.yaml`
|
|
124
|
+
- 仓库资源目录:`resources/bundle_templates/` 和 `resources/skill_archives/`
|
|
81
125
|
|
|
82
126
|
## 常见工作流
|
|
83
127
|
|
|
@@ -108,45 +152,21 @@ aweskill agent add bundle backend --global --agent all
|
|
|
108
152
|
### 维护本地仓库
|
|
109
153
|
|
|
110
154
|
```bash
|
|
111
|
-
aweskill store backup
|
|
155
|
+
aweskill store backup --both
|
|
112
156
|
aweskill agent sync
|
|
113
157
|
aweskill agent recover --global --agent codex
|
|
114
158
|
aweskill doctor dedupe --fix
|
|
115
159
|
```
|
|
116
160
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
### 直接从当前仓库安装
|
|
120
|
-
|
|
121
|
-
```bash
|
|
122
|
-
npm install
|
|
123
|
-
npm run build
|
|
124
|
-
npm install -g .
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
### 本地开发模式
|
|
128
|
-
|
|
129
|
-
```bash
|
|
130
|
-
npm install
|
|
131
|
-
npm link
|
|
132
|
-
aweskill --help
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### 用打包产物安装
|
|
136
|
-
|
|
137
|
-
```bash
|
|
138
|
-
npm install
|
|
139
|
-
npm pack
|
|
140
|
-
npm install -g ./aweskill-0.1.5.tgz
|
|
141
|
-
```
|
|
161
|
+
默认情况下,`store backup` 和 `store restore` 只处理 `skills/`。加上 `--both` 会同时处理 `bundles/`;如果想导出到指定位置,也可以给 `store backup` 传一个可选的 archive 路径。
|
|
142
162
|
|
|
143
163
|
## 命令面
|
|
144
164
|
|
|
145
165
|
| 命令 | 说明 |
|
|
146
166
|
| --- | --- |
|
|
147
167
|
| `aweskill store init [--scan] [--verbose]` | 初始化 `~/.aweskill` 布局 |
|
|
148
|
-
| `aweskill store backup` | 归档中央 skill
|
|
149
|
-
| `aweskill store restore <archive> [--override]` | 从备份恢复 |
|
|
168
|
+
| `aweskill store backup [archive] [--both]` | 归档中央 skill 仓库,也可导出到指定路径 |
|
|
169
|
+
| `aweskill store restore <archive> [--override] [--both]` | 从备份恢复 |
|
|
150
170
|
| `aweskill skill scan [--verbose]` | 扫描支持的 agent skill 目录 |
|
|
151
171
|
| `aweskill skill import <path> [--mode cp\|mv] [--override]` | 导入单个 skill 或整个 skills 根目录 |
|
|
152
172
|
| `aweskill skill import --scan [--mode cp\|mv] [--override]` | 导入当前扫描结果 |
|
|
@@ -179,7 +199,7 @@ npm install -g ./aweskill-0.1.5.tgz
|
|
|
179
199
|
|
|
180
200
|
### 只删除托管项
|
|
181
201
|
|
|
182
|
-
`aweskill`
|
|
202
|
+
`aweskill` 只删除它能够明确识别为自己创建的托管 symlink,不会盲删任意 skill 目录。
|
|
183
203
|
|
|
184
204
|
## Bundle 文件格式
|
|
185
205
|
|
|
@@ -195,9 +215,7 @@ skills:
|
|
|
195
215
|
## 投影模型
|
|
196
216
|
|
|
197
217
|
1. **Skill 内容的唯一事实来源**:`~/.aweskill/skills/<skill-name>/`
|
|
198
|
-
2. **`agent add`** 会在指定 agent
|
|
199
|
-
- 指向中央仓库的 **symlink**
|
|
200
|
-
- 或带标记的 **递归 copy**(例如 Cursor)
|
|
218
|
+
2. **`agent add`** 会在指定 agent 和支持的 scope 下创建一个指向中央仓库的 **symlink**
|
|
201
219
|
3. **`agent remove`** 只会删除能识别为 `aweskill` 托管的条目
|
|
202
220
|
4. **`agent sync`** 会移除中央 skill 已不存在时留下的失效托管投影
|
|
203
221
|
|
|
@@ -234,6 +252,14 @@ aweskill agent remove bundle backend --global --agent codex
|
|
|
234
252
|
aweskill agent recover --global --agent codex
|
|
235
253
|
```
|
|
236
254
|
|
|
255
|
+
## 模板与归档
|
|
256
|
+
|
|
257
|
+
内置 bundle 模板现在位于 [resources/bundle_templates/K-Dense-AI-scientific-skills.yaml](/Users/peng/Desktop/Project/aweskills/resources/bundle_templates/K-Dense-AI-scientific-skills.yaml)。运行时 bundle 仍然位于 `~/.aweskill/bundles/`。
|
|
258
|
+
|
|
259
|
+
`resources/skill_archives/` 预留给你手动维护的整仓库 `tar.gz` 归档,用于随仓库分发给其他用户。`aweskill` 不会自动生成或恢复这些归档。
|
|
260
|
+
|
|
261
|
+
如果你希望使用一个独立于本仓库、可直接分享给其他用户的技能归档集合,可以参考 [oh-my-skills](https://github.com/mugpeng/oh-my-skills)。它是一个单独维护的备份仓库,用来存放可分发的 bundle 和整库快照归档。
|
|
262
|
+
|
|
237
263
|
## 相关工具
|
|
238
264
|
|
|
239
265
|
如果你在关注更广的 skills 生态,下面这些项目都值得使用和研究:
|
|
@@ -252,18 +278,64 @@ aweskill agent recover --global --agent codex
|
|
|
252
278
|
|
|
253
279
|
## 支持的 Agent
|
|
254
280
|
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
|
263
|
-
|
|
|
264
|
-
| `
|
|
265
|
-
| `
|
|
266
|
-
| `
|
|
281
|
+
支持 47 个 agent,包括:
|
|
282
|
+
|
|
283
|
+
**Claude Code** · **Cursor** · **Windsurf** · **Codex** · **GitHub Copilot** · **Gemini CLI** · **OpenCode** · **Goose** · **Amp** · **Roo Code** · **Kiro CLI** · **Kilo Code** · **Trae** · **Cline** · **Antigravity** · **Droid** · **Augment** · **OpenClaw** · **CodeBuddy** · **Command Code** · **Crush** · **Kode** · **Mistral Vibe** · **Mux** · **OpenClaude IDE** · **OpenHands** · **Qoder** · **Qwen Code** · **Replit** · **Trae CN** · **Neovate** · **AdaL**
|
|
284
|
+
|
|
285
|
+
<details>
|
|
286
|
+
<summary>所有支持的 agent</summary>
|
|
287
|
+
|
|
288
|
+
| Agent | 全局路径 | 项目路径 |
|
|
289
|
+
| --- | --- | --- |
|
|
290
|
+
| `adal` | `~/.adal/skills/` | `<project>/.adal/skills/` |
|
|
291
|
+
| `amp` | `~/.agents/skills/` | `<project>/.agents/skills/` |
|
|
292
|
+
| `antigravity` | `~/.gemini/antigravity/skills/` | `<project>/.gemini/antigravity/skills/` |
|
|
293
|
+
| `augment` | `~/.augment/skills/` | `<project>/.augment/skills/` |
|
|
294
|
+
| `bob` | `~/.bob/skills/` | `<project>/.bob/skills/` |
|
|
295
|
+
| `claude-code` | `~/.claude/skills/` | `<project>/.claude/skills/` |
|
|
296
|
+
| `cline` | `~/.cline/skills/` | `<project>/.cline/skills/` |
|
|
297
|
+
| `codebuddy` | `~/.codebuddy/skills/` | `<project>/.codebuddy/skills/` |
|
|
298
|
+
| `command-code` | `~/.commandcode/skills/` | `<project>/.commandcode/skills/` |
|
|
299
|
+
| `continue` | `~/.continue/skills/` | `<project>/.continue/skills/` |
|
|
300
|
+
| `codex` | `~/.codex/skills/` | `<project>/.codex/skills/` |
|
|
301
|
+
| `copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
|
|
302
|
+
| `cortex` | `~/.snowflake/cortex/skills/` | `<project>/.cortex/skills/` |
|
|
303
|
+
| `crush` | `~/.config/crush/skills/` | `<project>/.config/crush/skills/` |
|
|
304
|
+
| `cursor` | `~/.cursor/skills/` | `<project>/.cursor/skills/` |
|
|
305
|
+
| `deepagents` | `~/.deepagents/agent/skills/` | `<project>/.deepagents/agent/skills/` |
|
|
306
|
+
| `droid` | `~/.factory/skills/` | `<project>/.factory/skills/` |
|
|
307
|
+
| `firebender` | `~/.firebender/skills/` | `<project>/.firebender/skills/` |
|
|
308
|
+
| `gemini-cli` | `~/.gemini/skills/` | `<project>/.gemini/skills/` |
|
|
309
|
+
| `github-copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
|
|
310
|
+
| `goose` | `~/.goose/skills/` | `<project>/.goose/skills/` |
|
|
311
|
+
| `iflow-cli` | `~/.iflow/skills/` | `<project>/.iflow/skills/` |
|
|
312
|
+
| `junie` | `~/.junie/skills/` | `<project>/.junie/skills/` |
|
|
313
|
+
| `kilo` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
|
|
314
|
+
| `kiro-cli` | `~/.kiro/skills/` | `<project>/.kiro/skills/` |
|
|
315
|
+
| `kilo-code` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
|
|
316
|
+
| `kimi-cli` | `~/.kimi/skills/` | `<project>/.kimi/skills/` |
|
|
317
|
+
| `kode` | `~/.kode/skills/` | `<project>/.kode/skills/` |
|
|
318
|
+
| `mcpjam` | `~/.mcpjam/skills/` | `<project>/.mcpjam/skills/` |
|
|
319
|
+
| `mistral-vibe` | `~/.vibe/skills/` | `<project>/.vibe/skills/` |
|
|
320
|
+
| `mux` | `~/.mux/skills/` | `<project>/.mux/skills/` |
|
|
321
|
+
| `neovate` | `~/.neovate/skills/` | `<project>/.neovate/skills/` |
|
|
322
|
+
| `openclaw` | `~/.openclaw/skills/` | `<project>/.openclaw/skills/` |
|
|
323
|
+
| `openclaude-ide` | `~/.openclaude/skills/` | `<project>/.openclaude/skills/` |
|
|
324
|
+
| `openhands` | `~/.openhands/skills/` | `<project>/.openhands/skills/` |
|
|
325
|
+
| `opencode` | `~/.opencode/skills/` | `<project>/.opencode/skills/` |
|
|
326
|
+
| `pi` | `~/.pi/agent/skills/` | `<project>/.pi/agent/skills/` |
|
|
327
|
+
| `pochi` | `~/.pochi/skills/` | `<project>/.pochi/skills/` |
|
|
328
|
+
| `qoder` | `~/.qoder/skills/` | `<project>/.qoder/skills/` |
|
|
329
|
+
| `qwen-code` | `~/.qwen/skills/` | `<project>/.qwen/skills/` |
|
|
330
|
+
| `replit` | `-` | `<project>/.agent/skills/` |
|
|
331
|
+
| `roo` | `~/.roo/skills/` | `<project>/.roo/skills/` |
|
|
332
|
+
| `trae` | `~/.trae/skills/` | `<project>/.trae/skills/` |
|
|
333
|
+
| `trae-cn` | `~/.trae-cn/skills/` | `<project>/.trae-cn/skills/` |
|
|
334
|
+
| `warp` | `~/.warp/skills/` | `<project>/.warp/skills/` |
|
|
335
|
+
| `windsurf` | `~/.codeium/windsurf/skills/` | `<project>/.codeium/windsurf/skills/` |
|
|
336
|
+
| `zencoder` | `~/.zencoder/skills/` | `<project>/.zencoder/skills/` |
|
|
337
|
+
|
|
338
|
+
</details>
|
|
267
339
|
|
|
268
340
|
## 开发
|
|
269
341
|
|