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.
Files changed (30) hide show
  1. package/.claude/settings.local.json +8 -0
  2. package/README.md +196 -0
  3. package/bun.lock +32 -0
  4. package/data/skills/bad-name-skill/SKILL.md +8 -0
  5. package/data/skills/github-tool/SKILL.md +11 -0
  6. package/data/skills/invalid-skill/SKILL.md +3 -0
  7. package/data/skills/pdf-tool/SKILL.md +11 -0
  8. package/data/skills/pdf-tool.zip +0 -0
  9. package/dist/main.js +1330 -0
  10. package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/AGENT.md +18 -0
  11. 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
  12. 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
  13. 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
  14. 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
  15. 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
  16. 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
  17. 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
  18. package/package.json +20 -0
  19. package/src/cmd/agent.ts +137 -0
  20. package/src/cmd/auth.ts +50 -0
  21. package/src/cmd/knowledge.ts +171 -0
  22. package/src/cmd/server.ts +11 -0
  23. package/src/cmd/skill.ts +220 -0
  24. package/src/lib/client.ts +274 -0
  25. package/src/lib/formatter.ts +196 -0
  26. package/src/lib/storage.ts +63 -0
  27. package/src/lib/validate.ts +210 -0
  28. package/src/main.ts +235 -0
  29. package/test-regression.sh +273 -0
  30. package/tsconfig.json +17 -0
@@ -0,0 +1,8 @@
1
+ {
2
+ "permissions": {
3
+ "allow": [
4
+ "Bash(adk skill:*)",
5
+ "Bash(adk:*)"
6
+ ]
7
+ }
8
+ }
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,8 @@
1
+ ---
2
+ name: Bad-Name-Skill
3
+ description: This has an invalid name format
4
+ ---
5
+
6
+ # Bad Name Skill
7
+
8
+ This skill has a name with uppercase letters.
@@ -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,3 @@
1
+ # Invalid Skill
2
+
3
+ This skill is missing the SKILL.md frontmatter.
@@ -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