feat: 新增 account 和 plan 目录
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
134
account/admin/skills/system/platform-guide/SKILL.md
Normal file
134
account/admin/skills/system/platform-guide/SKILL.md
Normal file
@@ -0,0 +1,134 @@
|
||||
---
|
||||
name: platform-guide
|
||||
description: "OpenAkita 平台使用指南:教你帮用户从 Agent Hub 和 Skill Store 搜索、安装 Agent 和 Skill"
|
||||
system: true
|
||||
category: Platform
|
||||
---
|
||||
|
||||
# OpenAkita Platform Guide — AI 操作手册
|
||||
|
||||
> **核心原则**:当用户需要某种能力但本地没有时,你应该 **主动搜索平台**。
|
||||
|
||||
## 什么时候该用平台?
|
||||
|
||||
- 用户说"帮我找一个 XX Agent / 技能 / Skill"
|
||||
- 用户需要某种能力但本地没有对应的技能
|
||||
- 用户说"有没有现成的"、"市场上有吗"、"安装一个"
|
||||
- 用户提到 Agent Hub、Skill Store、OpenAkita 平台
|
||||
|
||||
**注意**:平台是 **可选扩展**,离线时所有本地功能不受影响。
|
||||
|
||||
---
|
||||
|
||||
## Agent 安装三步走
|
||||
|
||||
当用户想从平台获取 Agent 时:
|
||||
|
||||
**第 1 步 — 搜索**
|
||||
```
|
||||
search_hub_agents(query="客服", category="customer_service")
|
||||
```
|
||||
- 查看返回的 Agent 列表,注意每个 Agent 的 `id`
|
||||
|
||||
**第 2 步 — 预览(推荐)**
|
||||
```
|
||||
get_hub_agent_detail(agent_id="the-agent-id")
|
||||
```
|
||||
- 查看描述、技能列表、评分、下载量
|
||||
|
||||
**第 3 步 — 安装**
|
||||
```
|
||||
install_hub_agent(agent_id="the-agent-id")
|
||||
```
|
||||
- 系统自动:下载包 → 解压技能 → 版本去重 → 注册 Agent → 热重载
|
||||
- 安装后 Agent **立刻可用**
|
||||
|
||||
### 安装时发生了什么?
|
||||
1. 下载 `.akita-agent` 包
|
||||
2. 打包的技能 → `skills/custom/`(版本去重:本地有更新版就跳过)
|
||||
3. 外部依赖技能 → 从原始 GitHub 仓库拉取到 `skills/community/`
|
||||
4. 每个技能写入 `.openakita-origin.json` 追踪来源
|
||||
5. Agent 配置注册到本地 → 技能自动重载
|
||||
|
||||
---
|
||||
|
||||
## Skill 安装三步走
|
||||
|
||||
当用户想从平台获取 Skill 时:
|
||||
|
||||
**第 1 步 — 搜索**
|
||||
```
|
||||
search_store_skills(query="翻译", trust_level="official")
|
||||
```
|
||||
- 注意 `trustLevel`:official(官方)> certified(认证)> community(社区)
|
||||
|
||||
**第 2 步 — 预览(推荐)**
|
||||
```
|
||||
get_store_skill_detail(skill_id="the-skill-id")
|
||||
```
|
||||
- 查看描述、开源协议、GitHub Stars、评分
|
||||
|
||||
**第 3 步 — 安装**
|
||||
```
|
||||
install_store_skill(skill_id="the-skill-id")
|
||||
```
|
||||
- 从原始 GitHub 仓库直接克隆(非平台重新分发)
|
||||
- 安装后技能 **立刻可用**
|
||||
|
||||
---
|
||||
|
||||
## 本地 Agent 导入导出(不需要平台)
|
||||
|
||||
```
|
||||
list_exportable_agents() # 查看可导出的
|
||||
export_agent(profile_id="my-agent", version="1.0.0") # 导出
|
||||
inspect_agent_package(package_path="xxx.akita-agent") # 预览包
|
||||
import_agent(package_path="xxx.akita-agent") # 导入
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 版本去重策略
|
||||
|
||||
| 场景 | 行为 |
|
||||
|------|------|
|
||||
| 本地有同名 skill 且版本 >= 新包中的版本 | **跳过**(保留本地更新版) |
|
||||
| 新包中版本 > 本地版本 | **覆盖**(升级到新版) |
|
||||
| 任一方无版本信息 | **覆盖**(安全起见) |
|
||||
|
||||
---
|
||||
|
||||
## 平台离线时的替代方案
|
||||
|
||||
| 需求 | 替代方式 |
|
||||
|------|----------|
|
||||
| 找 Agent | 用 `.akita-agent` 文件导入 |
|
||||
| 找 Skill | `install_skill` 从 GitHub 直接装;Setup Center 的 skills.sh 市场 |
|
||||
| 共享 Agent | `export_agent` 导出文件分享 |
|
||||
|
||||
---
|
||||
|
||||
## 全部平台工具速查
|
||||
|
||||
| 工具 | 用途 |
|
||||
|------|------|
|
||||
| `search_hub_agents` | 搜索平台上的 Agent |
|
||||
| `get_hub_agent_detail` | 查看 Agent 详情 |
|
||||
| `install_hub_agent` | 安装 Agent 到本地 |
|
||||
| `search_store_skills` | 搜索平台上的 Skill |
|
||||
| `get_store_skill_detail` | 查看 Skill 详情 |
|
||||
| `install_store_skill` | 安装 Skill 到本地 |
|
||||
| `submit_skill_repo` | 提交 GitHub 仓库为新 Skill |
|
||||
| `export_agent` | 导出本地 Agent |
|
||||
| `import_agent` | 导入 Agent 包 |
|
||||
| `list_exportable_agents` | 列出可导出的 Agent |
|
||||
| `inspect_agent_package` | 预览 Agent 包内容 |
|
||||
|
||||
---
|
||||
|
||||
## 许可证合规
|
||||
|
||||
- 平台上的 Skill 从 **原始开源仓库** 拉取,非平台重新分发
|
||||
- Agent 包可能含 `LICENSE-3RD-PARTY.md` 列出外部依赖
|
||||
- 安装前应告知用户相关许可证
|
||||
- 侵权联系:zacon365@gmail.com
|
||||
Reference in New Issue
Block a user