skill-master 0.1.9 → 0.1.10
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 +1 -54
- package/README.zh-CN.md +17 -65
- package/dist/cli.js +324 -146
- package/dist/cli.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -104,40 +104,6 @@ skill-master find # or: search, f, s
|
|
|
104
104
|
skill-master update # or: upgrade
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
## Directory Structure
|
|
108
|
-
|
|
109
|
-
```
|
|
110
|
-
~/.agents/
|
|
111
|
-
├── config/ # Persistent configs (.env files)
|
|
112
|
-
│ ├── my-skill/.env
|
|
113
|
-
│ └── other-skill/.env
|
|
114
|
-
├── skills/ # Skill code (canonical storage)
|
|
115
|
-
│ ├── my-skill/
|
|
116
|
-
│ └── other-skill/
|
|
117
|
-
└── registry.json # Installed skills index
|
|
118
|
-
|
|
119
|
-
<project>/
|
|
120
|
-
└── .claude/skills/ # Agent directory (symlinks)
|
|
121
|
-
├── my-skill -> ~/.agents/skills/my-skill
|
|
122
|
-
└── other-skill -> ~/.agents/skills/other-skill
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
## .env Protection
|
|
126
|
-
|
|
127
|
-
### Backup Priority
|
|
128
|
-
|
|
129
|
-
During install/update, searches for existing config in order:
|
|
130
|
-
|
|
131
|
-
1. `~/.agents/config/<skill>/.env` (persistent, highest priority)
|
|
132
|
-
2. `.claude/skills/<skill>/.env` (current project)
|
|
133
|
-
3. `~/.agents/skills/<skill>/.env` (canonical location)
|
|
134
|
-
|
|
135
|
-
### Restore Strategy
|
|
136
|
-
|
|
137
|
-
- Existing `KEY=VALUE` pairs are **never overwritten**
|
|
138
|
-
- New keys from `.env.example` are appended with empty values
|
|
139
|
-
- User comments are preserved
|
|
140
|
-
|
|
141
107
|
## Supported Platforms
|
|
142
108
|
|
|
143
109
|
39 AI coding agents are supported. Auto-detection works for agents with a project directory marker:
|
|
@@ -165,26 +131,7 @@ Amp, Antigravity, Augment, Claude Code, OpenClaw, Cline, CodeBuddy, Codex, Comma
|
|
|
165
131
|
|
|
166
132
|
## Development
|
|
167
133
|
|
|
168
|
-
|
|
169
|
-
# Clone repository
|
|
170
|
-
git clone https://github.com/yourusername/skill-master.git
|
|
171
|
-
cd skill-master
|
|
172
|
-
|
|
173
|
-
# Install dependencies
|
|
174
|
-
npm install
|
|
175
|
-
|
|
176
|
-
# Development mode
|
|
177
|
-
npm run dev
|
|
178
|
-
|
|
179
|
-
# Build
|
|
180
|
-
npm run build
|
|
181
|
-
|
|
182
|
-
# Type check
|
|
183
|
-
npm run lint
|
|
184
|
-
|
|
185
|
-
# Test
|
|
186
|
-
npm test
|
|
187
|
-
```
|
|
134
|
+
See [CLAUDE.md](./CLAUDE.md) for architecture, development commands, and release workflow.
|
|
188
135
|
|
|
189
136
|
## vs npx skills
|
|
190
137
|
|
package/README.zh-CN.md
CHANGED
|
@@ -24,7 +24,7 @@ npm install -g skill-master
|
|
|
24
24
|
或直接使用:
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
npx skill-master
|
|
27
|
+
npx skill-master add <skill-source>
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
## 快速开始
|
|
@@ -33,16 +33,16 @@ npx skill-master install <skill-source>
|
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
35
|
# 从 GitHub 安装
|
|
36
|
-
skill-master
|
|
36
|
+
skill-master add https://github.com/user/skill-name
|
|
37
37
|
|
|
38
38
|
# 从本地路径安装
|
|
39
|
-
skill-master
|
|
39
|
+
skill-master add ./local-skill
|
|
40
40
|
|
|
41
41
|
# 指定目标平台
|
|
42
|
-
skill-master
|
|
42
|
+
skill-master add https://github.com/user/skill --agent=cursor
|
|
43
43
|
|
|
44
44
|
# 使用复制而非符号链接(Windows 推荐)
|
|
45
|
-
skill-master
|
|
45
|
+
skill-master add https://github.com/user/skill --copy
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
### 管理环境变量
|
|
@@ -84,47 +84,6 @@ skill-master info tavily-web
|
|
|
84
84
|
skill-master doctor
|
|
85
85
|
```
|
|
86
86
|
|
|
87
|
-
## 目录结构
|
|
88
|
-
|
|
89
|
-
```
|
|
90
|
-
~/.agents/
|
|
91
|
-
├── config/ # 持久化配置(.env 文件)
|
|
92
|
-
│ ├── tavily-web/.env
|
|
93
|
-
│ └── exa-search/.env
|
|
94
|
-
├── skills/ # Skill 代码(canonical 存储)
|
|
95
|
-
│ ├── tavily-web/
|
|
96
|
-
│ └── exa-search/
|
|
97
|
-
└── registry.json # 已安装 skill 索引
|
|
98
|
-
|
|
99
|
-
<project>/
|
|
100
|
-
└── .claude/skills/ # Agent 目录(符号链接)
|
|
101
|
-
├── tavily-web -> ~/.agents/skills/tavily-web
|
|
102
|
-
└── exa-search -> ~/.agents/skills/exa-search
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
## .env 保护机制
|
|
106
|
-
|
|
107
|
-
### 备份优先级
|
|
108
|
-
|
|
109
|
-
安装/更新时按以下顺序查找现有配置:
|
|
110
|
-
|
|
111
|
-
1. `~/.agents/config/<skill>/.env` (持久化位置,最高优先级)
|
|
112
|
-
2. `.claude/skills/<skill>/.env` (当前项目)
|
|
113
|
-
3. `~/.agents/skills/<skill>/.env` (canonical 位置)
|
|
114
|
-
|
|
115
|
-
### 恢复策略
|
|
116
|
-
|
|
117
|
-
- 用户已有的 `KEY=VALUE` **绝不覆盖**
|
|
118
|
-
- `.env.example` 中新增的 key 追加到末尾,值留空并加注释
|
|
119
|
-
- 保留用户的注释行
|
|
120
|
-
|
|
121
|
-
### 双写机制
|
|
122
|
-
|
|
123
|
-
为兼容现有 API 脚本(使用 `path.join(__dirname, '.env')` 加载),.env 同时写入:
|
|
124
|
-
|
|
125
|
-
- `~/.agents/config/<skill>/.env` (持久化)
|
|
126
|
-
- `<skill-dir>/.env` (兼容现有脚本)
|
|
127
|
-
|
|
128
87
|
## 支持的平台
|
|
129
88
|
|
|
130
89
|
支持 39 个 AI 编程代理。具有项目目录标记的代理支持自动检测:
|
|
@@ -150,28 +109,21 @@ Amp, Antigravity, Augment, Claude Code, OpenClaw, Cline, CodeBuddy, Codex, Comma
|
|
|
150
109
|
|
|
151
110
|
</details>
|
|
152
111
|
|
|
153
|
-
##
|
|
154
|
-
|
|
155
|
-
```bash
|
|
156
|
-
# 克隆仓库
|
|
157
|
-
git clone https://github.com/user/skill-master.git
|
|
158
|
-
cd skill-master
|
|
159
|
-
|
|
160
|
-
# 安装依赖
|
|
161
|
-
npm install
|
|
112
|
+
## 命令别名
|
|
162
113
|
|
|
163
|
-
|
|
164
|
-
npm run dev
|
|
114
|
+
兼容 `npx skills` 命令:
|
|
165
115
|
|
|
166
|
-
|
|
167
|
-
|
|
116
|
+
```bash
|
|
117
|
+
skill-master add # 或: a, install, i
|
|
118
|
+
skill-master remove # 或: rm, r
|
|
119
|
+
skill-master list # 或: ls
|
|
120
|
+
skill-master find # 或: search, f, s
|
|
121
|
+
skill-master update # 或: upgrade
|
|
122
|
+
```
|
|
168
123
|
|
|
169
|
-
|
|
170
|
-
npm run lint
|
|
124
|
+
## 开发
|
|
171
125
|
|
|
172
|
-
|
|
173
|
-
npm test
|
|
174
|
-
```
|
|
126
|
+
详见 [CLAUDE.md](./CLAUDE.md) 获取架构细节、开发命令和发布流程。
|
|
175
127
|
|
|
176
128
|
## 与 `npx skills` 的对比
|
|
177
129
|
|
|
@@ -197,7 +149,7 @@ A: 可以。skill-master 使用独立的 `~/.agents/` 目录,不会影响现
|
|
|
197
149
|
|
|
198
150
|
### Q: Windows 上符号链接失败怎么办?
|
|
199
151
|
|
|
200
|
-
A: 使用 `--copy` 参数:`skill-master
|
|
152
|
+
A: 使用 `--copy` 参数:`skill-master add <source> --copy`
|
|
201
153
|
|
|
202
154
|
### Q: 如何迁移现有的 skill?
|
|
203
155
|
|