admin9webs
322b7737eb
来源：紫鸟帮助中心/博客/主站资讯 + HubStudio API 文档/帮助中心 + 三个官方 skill 仓库。 只入库 Markdown 与元数据；原始 HTML 与 tarball 留在本机。
85 lines
4.0 KiB
Markdown
85 lines
4.0 KiB
Markdown
# Skill Hub
|
||
|
||
[紫鸟开放平台](https://open.ziniao.com/) 的 **Agent Skills** 仓库，面向所有支持 Agent Skill 规范的 AI 编程助手与 Agent 运行时。
|
||
|
||
仓库内有两类 Skill：
|
||
|
||
- **文档型 Skill**：用 `SKILL.md` 提供定位、能力概览与按需深入的导航，用 `reference/` 存放可被精确检索的接口细节。Agent 在需要理解某个产品"是什么、能做什么、怎么对接"时加载，再按需深入到具体接口参数，既掌握全局又不被细节淹没。
|
||
- **执行型 Skill**：面向普通用户直接完成任务，无需关心内部调用细节。Agent 按契约直接调用开放平台接口拿到最终结果。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
skills/
|
||
├── ziniao-erp-api-doc/ # 紫鸟 ERP API 文档（文档型）
|
||
├── ziniao-sso-doc/ # 紫鸟单点登录 OpenAPI 文档（文档型）
|
||
├── ziniao-webdriver-doc/ # 紫鸟浏览器 WebDriver 自动化接口文档（文档型）
|
||
└── linkfoxai-image-tool/ # LinkFoxAI 图片处理工具（执行型）
|
||
```
|
||
|
||
各类型 Skill 的结构：
|
||
|
||
```
|
||
# 文档型
|
||
<skill-name>/
|
||
├── SKILL.md # 入口：定位、能力边界、架构流程、按需深入导航
|
||
└── reference/ # 细节：按模块拆分的接口请求/响应参数、示例
|
||
|
||
# 执行型
|
||
<skill-name>/
|
||
└── SKILL.md # 入口：触发条件、执行流程、能力分组、调用契约
|
||
```
|
||
|
||
## 已收录 Skills
|
||
|
||
| Skill | 类型 | 说明 | 适用场景 |
|
||
|-------|------|------|----------|
|
||
| `ziniao-erp-api-doc` | 文档型 | 紫鸟 ERP REST API（Bearer API Key 认证，72 个接口） | ERP 系统对接规划、集成设计、接口权限评估 |
|
||
| `ziniao-sso-doc` | 文档型 | 紫鸟单点登录 OpenAPI | ERP 系统 SSO 对接、身份集成设计 |
|
||
| `ziniao-webdriver-doc` | 文档型 | 紫鸟浏览器 WebDriver 本地自动化接口 | 自动化集成选型、Selenium/Puppeteer/Playwright/DrissionPage 对接 |
|
||
| `linkfoxai-image-tool` | 执行型 | LinkFoxAI 图片处理（图片上传、场景裂变、商品替换、自动抠图） | 用户要求直接完成图片处理任务并拿到最终结果 |
|
||
|
||
## 兼容的 Agent
|
||
|
||
本仓库遵循 [Agent Skill 规范](https://docs.claude.com/en/docs/agents-and-tools/agent-skills)，`SKILL.md` 的 frontmatter（`name` + `description`）可被任何支持该规范的工具识别并按需加载。已验证/适用的 Agent 包括（不限于）：
|
||
|
||
- **Claude Code**（Anthropic 官方 CLI）
|
||
- **Codex**（OpenAI）
|
||
- **Cursor**
|
||
- **OpenClaw**
|
||
- 其他兼容 Agent Skill 规范的运行时
|
||
|
||
## 使用方式
|
||
|
||
### 安装 Skill
|
||
|
||
通过 `skills` CLI 安装。仓库地址为 `ziniao-open/skill-hub`：
|
||
|
||
```bash
|
||
# 安装全部 Skill
|
||
npx skills add ziniao-open/skill-hub
|
||
|
||
# 安装指定 Skill（@ 后跟 skills/ 下的目录名）
|
||
npx skills add ziniao-open/skill-hub@ziniao-erp-api-doc
|
||
npx skills add ziniao-open/skill-hub@ziniao-sso-doc
|
||
npx skills add ziniao-open/skill-hub@ziniao-webdriver-doc
|
||
npx skills add ziniao-open/skill-hub@linkfoxai-image-tool
|
||
```
|
||
|
||
> Tip: 使用 `--yes`（`-y`）与 `--global`（`-g`）参数可跳过确认提示并全局安装：
|
||
> ```bash
|
||
> npx skills add ziniao-open/skill-hub -y -g
|
||
> ```
|
||
|
||
安装完成后，Agent 会在匹配到对应 `description` 的场景下自动加载并参考相应 Skill。
|
||
|
||
### 阅读约定
|
||
|
||
- **先读 `SKILL.md`**：了解 Skill 的定位、能力边界与执行/深入流程。
|
||
- **文档型**：通过 `SKILL.md` 的"按需深入"导航定位到具体文件，仅在需要查阅接口请求/响应参数、示例代码时读取对应 `reference/` 文件，避免一次性加载全部细节。
|
||
- **执行型**：按 `SKILL.md` 中的能力分组与调用契约，优先复用本地脚本（若存在），否则直接调用开放平台接口完成任务并返回结果。
|
||
|
||
## 许可证
|
||
|
||
本仓库由紫鸟开放平台维护，内容包含接口文档与执行型 Skill，供开发者集成对接与自动化使用。使用本仓库即表示你已阅读并同意紫鸟开放平台的相关服务条款；接口的实际调用受开放平台的鉴权、计费与限流策略约束。
|