archive: 紫鸟/HubStudio 文档快照(3889 篇 Markdown)
来源:紫鸟帮助中心/博客/主站资讯 + HubStudio API 文档/帮助中心 + 三个官方 skill 仓库。 只入库 Markdown 与元数据;原始 HTML 与 tarball 留在本机。
This commit is contained in:
commit
322b7737eb
3976 files changed
+695714
No files matched your search
@@ -0,0 +1,84 @@
|
||||
# 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,供开发者集成对接与自动化使用。使用本仓库即表示你已阅读并同意紫鸟开放平台的相关服务条款;接口的实际调用受开放平台的鉴权、计费与限流策略约束。
|
||||
Reference in new issue
Block a user