agent-resource-management 1.3.0 → 1.4.1

package/README.md

@@ -1,16 +1,17 @@
-# Agent Development Kit (ADK) - CLI
+# Agent Resource Management (ARM) - CLI
 
-Agent Skill CLI 是一个用于管理 Agent Skills 的命令行工具，支持技能的浏览、搜索、上传、下载、验证等功能。
+Agent Resource Management CLI 是一个用于管理 Skills、Knowledges 和 Agents 的命令行工具，支持浏览、搜索、上传、下载、验证等功能。
 
-**注意**: 本 CLI 需要配合 [Agent Skill Backend](https://github.com/your-repo/agent-skill-backend) 后端管理系统一起使用。请先确保后端服务已启动。
+**注意**: 本 CLI 需要配合 ARM Backend 后端管理系统一起使用。请先确保后端服务已启动。
 
 ## 功能特性
 
 - 认证管理 (登录/登出)
-- 技能浏览与搜索
-- 技能详情查看
-- 技能上传/下载/删除
-- 技能本地验证
+- Skill 浏览与搜索
+- Knowledge 浏览与搜索
+- Agent 浏览与搜索
+- 上传/下载/删除
+- 本地验证
 - 多服务端支持
 
 ## 安装
@@ -28,7 +29,7 @@ npm run build
 npm link
 
 # 验证安装
-adk --help
+arm --help
 ```
 
 ### 或使用 Bun 直接运行
@@ -43,47 +44,73 @@ bun run src/main.ts --help
 ### 1. 登录
 
 ```bash
-adk login http://localhost:3000 <your-api-key>
+arm login http://localhost:3000 <your-api-key>
 ```
 
-### 2. 浏览技能
+### 2. 浏览 Skills
 
 ```bash
-# 列出所有技能
-adk skill ls
+# 列出所有 Skills
+arm skill ls
 
-# 搜索技能
-adk skill search pdf
+# 搜索 Skills
+arm skill search pdf
 
-# 查看技能详情
-adk skill info pdf-tool
+# 查看 Skill 详情
+arm skill info pdf-tool
 ```
 
-### 3. 下载技能
+### 3. 浏览 Knowledges
 
 ```bash
-# 下载到当前目录
-adk skill download pdf-tool
+# 列出所有 Knowledges
+arm knowledge ls
 
-# 下载到指定目录
-adk skill download pdf-tool ./my-skills
+# 搜索 Knowledges
+arm knowledge search api-doc
 ```
 
-### 4. 上传技能
+### 4. 浏览 Agents
 
 ```bash
-# 上传本地技能目录
-adk skill upload ./my-skills/pdf-tool
+# 列出所有 Agents
+arm agent ls
+
+# 搜索 Agents
+arm agent search assistant
+```
+
+### 5. 下载
+
+```bash
+# 下载 Skill 到当前目录
+arm skill download pdf-tool
+
+# 下载 Knowledge 到指定目录
+arm knowledge download api-doc ./my-knowledges
+
+# 下载 Agent 到指定目录
+arm agent download workspace-assistant ./agents
+```
+
+### 6. 上传
+
+```bash
+# 上传本地 Skill 目录
+arm skill upload ./my-skills/pdf-tool
+
+# 上传本地 Knowledge 目录
+arm knowledge upload ./my-knowledges/api-doc
 ```
 
-### 5. 验证技能格式
+### 7. 验证格式
 
 ```bash
-# 验证本地技能目录
-adk skill validate ./my-skills/pdf-tool
+# 验证 Skill 目录
+arm skill validate ./my-skills/pdf-tool
 
-# 验证 ZIP 文件
-adk skill validate ./my-skills/pdf-tool.zip
+# 验证 Skill ZIP 文件
+arm skill validate ./my-skills/pdf-tool.zip
 ```
 
 ## 命令参考
@@ -92,38 +119,54 @@ adk skill validate ./my-skills/pdf-tool.zip
 
 | 命令 | 说明 |
 |------|------|
-| `adk login <server-url> <api-key>` | 登录到指定服务端 |
-| `adk logout` | 登出当前用户 |
-| `adk me` | 显示当前用户信息 |
+| `arm login <server-url> <api-key>` | 登录到指定服务端 |
+| `arm logout` | 登出当前用户 |
+| `arm me` | 显示当前用户信息 |
+
+### Skill 命令
+
+| 命令 | 说明 |
+|------|------|
+| `arm skill ls` | 列出所有公开 Skills |
+| `arm skill search <keyword>` | 搜索 Skills |
+| `arm skill info <name>` | 查看 Skill 详情 |
+| `arm skill download <name> [dir]` | 下载 Skill 到指定目录 |
+| `arm skill upload <path>` | 上传本地 Skill 目录 |
+| `arm skill my` | 查看我发布的 Skills |
+| `arm skill delete <name>` | 删除我发布的 Skill |
+| `arm skill validate <path>` | 验证 Skill 格式（支持目录和 ZIP） |
 
-### 技能浏览命令
+### Knowledge 命令
 
 | 命令 | 说明 |
 |------|------|
-| `adk skill ls` | 列出所有公开技能 |
-| `adk skill search <keyword>` | 搜索技能 |
-| `adk skill info <name>` | 查看技能详情 |
+| `arm knowledge ls` | 列出所有公开 Knowledges |
+| `arm knowledge search <keyword>` | 搜索 Knowledges |
+| `arm knowledge info <name>` | 查看 Knowledge 详情 |
+| `arm knowledge download <name> [dir]` | 下载 Knowledge 到指定目录 |
+| `arm knowledge upload <path>` | 上传本地 Knowledge 目录 |
+| `arm knowledge my` | 查看我发布的 Knowledges |
+| `arm knowledge delete <name>` | 删除我发布的 Knowledge |
 
-### 技能管理命令
+### Agent 命令
 
 | 命令 | 说明 |
 |------|------|
-| `adk skill download <name> [dir]` | 下载技能到指定目录 |
-| `adk skill upload <path>` | 上传本地技能目录 |
-| `adk skill my` | 查看我发布的技能 |
-| `adk skill delete <name>` | 删除我发布的技能 |
-| `adk skill validate <path>` | 验证技能格式（支持目录和 ZIP） |
+| `arm agent ls` | 列出所有公开 Agents |
+| `arm agent search <keyword>` | 搜索 Agents |
+| `arm agent info <name>` | 查看 Agent 详情 |
+| `arm agent download <name> [dir]` | 下载 Agent 到指定目录 |
 
 ### 服务端命令
 
 | 命令 | 说明 |
 |------|------|
-| `adk server` | 显示当前服务端 |
-| `adk server set <url>` | 设置默认服务端 |
+| `arm server` | 显示当前服务端 |
+| `arm server set <url>` | 设置默认服务端 |
 
-## 技能格式规范
+## Skill 格式规范
 
-上传的技能目录必须包含 `SKILL.md` 文件，且 frontmatter 必须符合以下格式：
+上传的 Skill 目录必须包含 `SKILL.md` 文件，且 frontmatter 必须符合以下格式：
 
 ```yaml
 ---
@@ -134,9 +177,9 @@ compatibility: 兼容性信息 # 可选
 allowed-tools: tool1 tool2 # 可选，空格分隔
 ---
 
-# 技能说明
+# Skill 说明
 
-这里是技能的详细说明文档...
+这里是 Skill 的详细说明文档...
 ```
 
 ### 验证规则
@@ -149,7 +192,7 @@ allowed-tools: tool1 tool2 # 可选，空格分隔
 
 ## 配置文件
 
-登录后配置保存在 `~/.adk/config.json`:
+登录后配置保存在 `~/.arm/config.json`:
 
 ```json
 {
@@ -181,7 +224,7 @@ npm run build
 
 ## 后端配合
 
-本 CLI 需要配合 Agent Skill Backend 使用。启动后端服务：
+本 CLI 需要配合 ARM Backend 使用。启动后端服务：
 
 ```bash
 cd backend

package/data/skills/arm-tool/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: arm-tool
+description: Agent Resource Management CLI - Manage Skills, Knowledges, and Agents across the platform. Upload, search, download, and share reusable capabilities.
+license: MIT
+compatibility: Works with any ARM backend API v1
+allowed-tools: arm-cli
+---
+
+# ARM Tool
+
+Agent Resource Management (arm) CLI for managing Skills, Knowledges, and Agents.
+
+## Commands
+
+### Authentication
+
+- `arm login <server-url> <api-key>` - Login to the platform
+- `arm logout` - Logout from the platform
+- `arm me` - Show current user info
+
+### Skill Management
+
+- `arm skill ls` - List all available Skills
+- `arm skill search <keyword>` - Search Skills by keyword
+- `arm skill info <name>` - Show detailed info of a Skill
+- `arm skill download <name> [dir]` - Download a Skill as zip
+- `arm skill upload <path>` - Upload a Skill (dir or zip)
+- `arm skill my` - List Skills you've published
+- `arm skill delete <name>` - Delete your published Skill
+- `arm skill validate <path>` - Validate a Skill package
+
+### Knowledge Management
+
+- `arm knowledge ls` - List all available Knowledges
+- `arm knowledge search <keyword>` - Search Knowledges by keyword
+- `arm knowledge info <name>` - Show detailed info of a Knowledge
+- `arm knowledge download <name> [dir]` - Download a Knowledge as zip
+- `arm knowledge upload <path>` - Upload a Knowledge (dir or zip)
+- `arm knowledge my` - List Knowledges you've published
+- `arm knowledge delete <name>` - Delete your published Knowledge
+
+### Agent Management
+
+- `arm agent ls` - List all available Agents
+- `arm agent search <keyword>` - Search Agents by keyword
+- `arm agent info <name>` - Show detailed info of an Agent
+- `arm agent download <name> [dir]` - Download an Agent to local directory
+
+### Server Configuration
+
+- `arm server` - Show current server URL
+- `arm server set <url>` - Set server URL
+
+## Usage Examples
+
+### Login and Explore
+
+```bash
+# Login to the platform
+arm login https://api.example.com <your-api-key>
+
+# List all available Skills
+arm skill ls
+
+# Search for a specific Skill
+arm skill search pdf
+```
+
+### Download and Use
+
+```bash
+# Download a Skill to local
+arm skill download pdf-tool ./my-skills
+
+# Download an Agent
+arm agent download workspace-assistant ./agents
+```
+
+### Publish Your Work
+
+```bash
+# Validate before uploading
+arm skill validate ./my-custom-skill
+
+# Upload your Skill
+arm skill upload ./my-custom-skill
+
+# Check your published items
+arm skill my
+```
+
+## Concepts
+
+- **Skill**: A reusable capability package with tools and instructions
+- **Knowledge**: Document/data packages for RAG retrieval
+- **Agent**: Configured agent combining Skills, Knowledges, and prompts
+
+## Notes
+
+- All commands requiring authentication need prior login
+- Server URL is persisted locally after `arm server set`
+- Skills must contain a valid SKILL.md file to upload