# 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，供开发者集成对接与自动化使用。使用本仓库即表示你已阅读并同意紫鸟开放平台的相关服务条款；接口的实际调用受开放平台的鉴权、计费与限流策略约束。