agent-resource-management 1.3.0
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/.claude/settings.local.json +8 -0
- package/README.md +196 -0
- package/bun.lock +32 -0
- package/data/skills/bad-name-skill/SKILL.md +8 -0
- package/data/skills/github-tool/SKILL.md +11 -0
- package/data/skills/invalid-skill/SKILL.md +3 -0
- package/data/skills/pdf-tool/SKILL.md +11 -0
- package/data/skills/pdf-tool.zip +0 -0
- package/dist/main.js +1330 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/AGENT.md +18 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260Loki/346/227/245/345/277/227/346/216/222/346/237/245/346/226/271/346/263/225.md +27 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/344/273/273/345/212/241/350/247/246/345/217/221/345/220/270/346/224/266/345/231/250/344/270/216/345/215/240/344/275/215/350/247/246/345/217/221/345/220/270/346/224/266/345/231/250/344/275/277/347/224/250/345/234/272/346/231/257.md +18 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/345/220/216/347/253/257Swagger/346/216/245/345/217/243/346/226/207/346/241/243.md +22 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/345/275/223/345/211/215/350/277/220/350/241/214/345/256/236/344/276/213/345/217/212/345/256/236/344/276/213/350/277/220/350/241/214/346/227/245/345/277/227/346/216/222/346/237/245.md +39 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/346/216/245/345/217/243/346/216/222/346/237/245/350/203/214/346/231/257/347/237/245/350/257/206.md +49 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/350/264/247/350/275/275/347/224/237/345/221/275/345/221/250/346/234/237/346/237/245/350/257/242/346/265/201/347/250/213.md +165 -0
- package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//345/244/251/350/275/246/350/260/203/345/272/246/347/263/273/347/273/237/351/207/215/347/273/204/346/216/245/345/217/243/350/260/203/347/224/250/344/270/216/346/227/245/345/277/227/345/210/206/346/236/220/346/226/271/346/263/225.md +137 -0
- package/package.json +20 -0
- package/src/cmd/agent.ts +137 -0
- package/src/cmd/auth.ts +50 -0
- package/src/cmd/knowledge.ts +171 -0
- package/src/cmd/server.ts +11 -0
- package/src/cmd/skill.ts +220 -0
- package/src/lib/client.ts +274 -0
- package/src/lib/formatter.ts +196 -0
- package/src/lib/storage.ts +63 -0
- package/src/lib/validate.ts +210 -0
- package/src/main.ts +235 -0
- package/test-regression.sh +273 -0
- package/tsconfig.json +17 -0
package/README.md
ADDED
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
# Agent Development Kit (ADK) - CLI
|
|
2
|
+
|
|
3
|
+
Agent Skill CLI 是一个用于管理 Agent Skills 的命令行工具,支持技能的浏览、搜索、上传、下载、验证等功能。
|
|
4
|
+
|
|
5
|
+
**注意**: 本 CLI 需要配合 [Agent Skill Backend](https://github.com/your-repo/agent-skill-backend) 后端管理系统一起使用。请先确保后端服务已启动。
|
|
6
|
+
|
|
7
|
+
## 功能特性
|
|
8
|
+
|
|
9
|
+
- 认证管理 (登录/登出)
|
|
10
|
+
- 技能浏览与搜索
|
|
11
|
+
- 技能详情查看
|
|
12
|
+
- 技能上传/下载/删除
|
|
13
|
+
- 技能本地验证
|
|
14
|
+
- 多服务端支持
|
|
15
|
+
|
|
16
|
+
## 安装
|
|
17
|
+
|
|
18
|
+
### 前置要求
|
|
19
|
+
|
|
20
|
+
- Node.js >= 18 或 Bun >= 1.0
|
|
21
|
+
|
|
22
|
+
### 全局安装
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
cd cli
|
|
26
|
+
npm install
|
|
27
|
+
npm run build
|
|
28
|
+
npm link
|
|
29
|
+
|
|
30
|
+
# 验证安装
|
|
31
|
+
adk --help
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### 或使用 Bun 直接运行
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
cd cli
|
|
38
|
+
bun run src/main.ts --help
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## 快速开始
|
|
42
|
+
|
|
43
|
+
### 1. 登录
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
adk login http://localhost:3000 <your-api-key>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 2. 浏览技能
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# 列出所有技能
|
|
53
|
+
adk skill ls
|
|
54
|
+
|
|
55
|
+
# 搜索技能
|
|
56
|
+
adk skill search pdf
|
|
57
|
+
|
|
58
|
+
# 查看技能详情
|
|
59
|
+
adk skill info pdf-tool
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### 3. 下载技能
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
# 下载到当前目录
|
|
66
|
+
adk skill download pdf-tool
|
|
67
|
+
|
|
68
|
+
# 下载到指定目录
|
|
69
|
+
adk skill download pdf-tool ./my-skills
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### 4. 上传技能
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# 上传本地技能目录
|
|
76
|
+
adk skill upload ./my-skills/pdf-tool
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### 5. 验证技能格式
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
# 验证本地技能目录
|
|
83
|
+
adk skill validate ./my-skills/pdf-tool
|
|
84
|
+
|
|
85
|
+
# 验证 ZIP 文件
|
|
86
|
+
adk skill validate ./my-skills/pdf-tool.zip
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## 命令参考
|
|
90
|
+
|
|
91
|
+
### 认证命令
|
|
92
|
+
|
|
93
|
+
| 命令 | 说明 |
|
|
94
|
+
|------|------|
|
|
95
|
+
| `adk login <server-url> <api-key>` | 登录到指定服务端 |
|
|
96
|
+
| `adk logout` | 登出当前用户 |
|
|
97
|
+
| `adk me` | 显示当前用户信息 |
|
|
98
|
+
|
|
99
|
+
### 技能浏览命令
|
|
100
|
+
|
|
101
|
+
| 命令 | 说明 |
|
|
102
|
+
|------|------|
|
|
103
|
+
| `adk skill ls` | 列出所有公开技能 |
|
|
104
|
+
| `adk skill search <keyword>` | 搜索技能 |
|
|
105
|
+
| `adk skill info <name>` | 查看技能详情 |
|
|
106
|
+
|
|
107
|
+
### 技能管理命令
|
|
108
|
+
|
|
109
|
+
| 命令 | 说明 |
|
|
110
|
+
|------|------|
|
|
111
|
+
| `adk skill download <name> [dir]` | 下载技能到指定目录 |
|
|
112
|
+
| `adk skill upload <path>` | 上传本地技能目录 |
|
|
113
|
+
| `adk skill my` | 查看我发布的技能 |
|
|
114
|
+
| `adk skill delete <name>` | 删除我发布的技能 |
|
|
115
|
+
| `adk skill validate <path>` | 验证技能格式(支持目录和 ZIP) |
|
|
116
|
+
|
|
117
|
+
### 服务端命令
|
|
118
|
+
|
|
119
|
+
| 命令 | 说明 |
|
|
120
|
+
|------|------|
|
|
121
|
+
| `adk server` | 显示当前服务端 |
|
|
122
|
+
| `adk server set <url>` | 设置默认服务端 |
|
|
123
|
+
|
|
124
|
+
## 技能格式规范
|
|
125
|
+
|
|
126
|
+
上传的技能目录必须包含 `SKILL.md` 文件,且 frontmatter 必须符合以下格式:
|
|
127
|
+
|
|
128
|
+
```yaml
|
|
129
|
+
---
|
|
130
|
+
name: skill-name # 必填,小写字母、数字、连字符
|
|
131
|
+
description: 描述 # 必填,1-1024 字符
|
|
132
|
+
license: MIT # 可选
|
|
133
|
+
compatibility: 兼容性信息 # 可选
|
|
134
|
+
allowed-tools: tool1 tool2 # 可选,空格分隔
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
# 技能说明
|
|
138
|
+
|
|
139
|
+
这里是技能的详细说明文档...
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### 验证规则
|
|
143
|
+
|
|
144
|
+
- `name`: 必填,只能包含小写字母、数字和连字符,1-64 字符
|
|
145
|
+
- `description`: 必填,1-1024 字符
|
|
146
|
+
- `license`: 可选
|
|
147
|
+
- `compatibility`: 可选
|
|
148
|
+
- `allowed-tools`: 可选,空格分隔的字符串
|
|
149
|
+
|
|
150
|
+
## 配置文件
|
|
151
|
+
|
|
152
|
+
登录后配置保存在 `~/.adk/config.json`:
|
|
153
|
+
|
|
154
|
+
```json
|
|
155
|
+
{
|
|
156
|
+
"serverUrl": "http://localhost:3000",
|
|
157
|
+
"token": "your-jwt-token",
|
|
158
|
+
"user": {
|
|
159
|
+
"id": "user-id",
|
|
160
|
+
"name": "username",
|
|
161
|
+
"email": "user@example.com"
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
## 开发
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
# 安装依赖
|
|
170
|
+
npm install
|
|
171
|
+
|
|
172
|
+
# 开发模式(使用 bun)
|
|
173
|
+
bun run dev
|
|
174
|
+
|
|
175
|
+
# 构建
|
|
176
|
+
npm run build
|
|
177
|
+
|
|
178
|
+
# 运行测试
|
|
179
|
+
./test-regression.sh
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
## 后端配合
|
|
183
|
+
|
|
184
|
+
本 CLI 需要配合 Agent Skill Backend 使用。启动后端服务:
|
|
185
|
+
|
|
186
|
+
```bash
|
|
187
|
+
cd backend
|
|
188
|
+
npm install
|
|
189
|
+
npm run dev
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
后端默认运行在 `http://localhost:3000`。
|
|
193
|
+
|
|
194
|
+
## License
|
|
195
|
+
|
|
196
|
+
MIT
|
package/bun.lock
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"lockfileVersion": 1,
|
|
3
|
+
"configVersion": 1,
|
|
4
|
+
"workspaces": {
|
|
5
|
+
"": {
|
|
6
|
+
"name": "agent-development-kit",
|
|
7
|
+
"dependencies": {
|
|
8
|
+
"agent-development-kit": ".",
|
|
9
|
+
"undici": "^6.13.0",
|
|
10
|
+
},
|
|
11
|
+
"devDependencies": {
|
|
12
|
+
"@types/bun": "^1.1.0",
|
|
13
|
+
"typescript": "^5.4.0",
|
|
14
|
+
},
|
|
15
|
+
},
|
|
16
|
+
},
|
|
17
|
+
"packages": {
|
|
18
|
+
"@types/bun": ["@types/bun@1.3.11", "", { "dependencies": { "bun-types": "1.3.11" } }, "sha512-5vPne5QvtpjGpsGYXiFyycfpDF2ECyPcTSsFBMa0fraoxiQyMJ3SmuQIGhzPg2WJuWxVBoxWJ2kClYTcw/4fAg=="],
|
|
19
|
+
|
|
20
|
+
"@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
|
|
21
|
+
|
|
22
|
+
"agent-development-kit": ["agent-development-kit@root:", {}],
|
|
23
|
+
|
|
24
|
+
"bun-types": ["bun-types@1.3.11", "", { "dependencies": { "@types/node": "*" } }, "sha512-1KGPpoxQWl9f6wcZh57LvrPIInQMn2TQ7jsgxqpRzg+l0QPOFvJVH7HmvHo/AiPgwXy+/Thf6Ov3EdVn1vOabg=="],
|
|
25
|
+
|
|
26
|
+
"typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
|
|
27
|
+
|
|
28
|
+
"undici": ["undici@6.24.1", "", {}, "sha512-sC+b0tB1whOCzbtlx20fx3WgCXwkW627p4EA9uM+/tNNPkSS+eSEld6pAs9nDv7WbY1UUljBMYPtu9BCOrCWKA=="],
|
|
29
|
+
|
|
30
|
+
"undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
|
|
31
|
+
}
|
|
32
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: github-tool
|
|
3
|
+
description: GitHub integration tool for repository management, issues, and pull requests
|
|
4
|
+
license: Apache-2.0
|
|
5
|
+
compatibility: Compatible with GitHub API v3
|
|
6
|
+
allowed-tools: github-api git-cli
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# GitHub Tool
|
|
10
|
+
|
|
11
|
+
Manage GitHub repositories, issues, and PRs.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pdf-tool
|
|
3
|
+
description: A tool for working with PDF files - merge, split, extract text and more
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: Works with all major PDF libraries
|
|
6
|
+
allowed-tools: pdf-parser pdf-merger pdf-splitter
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# PDF Tool
|
|
10
|
+
|
|
11
|
+
A comprehensive tool for PDF manipulation.
|
|
Binary file
|