---
id: gh-ziniao-skill-maker
name: "ziniao-skill-maker"
url: https://skills.yangsir.net/skill/gh-ziniao-skill-maker
author: ziniao-open
domain: ai-skill-platform-ecosystem
tags: ["skill-creation", "cli-automation", "api-encapsulation", "workflow-automation", "developer-tools"]
install_count: 2600
rating: 4.40 (120 reviews)
github: https://github.com/ziniao-open/skills/tree/main/skills/ziniao-skill-maker
---

# ziniao-skill-maker

> 用于创建和管理基于 ziniao-cli 的自定义 Skill，将紫鸟 API 操作封装成可复用的 AI 技能，支持原子 API 包装和多步流程编排。适用于需要快速构建标准化技能、减少重复配置的场景，提升开发效率。

**Stats**: 2,600 installs · 4.4/5 (120 reviews)

## Before / After 对比

### 创建新 Skill 的耗时

**Before**:

在没有这个技能之前，开发者需要手动查阅 API 文档、编写 SKILL.md 文件、逐句测试命令，整个过程繁琐且容易出错，一个简单 Skill 通常需要 60 分钟。

**After**:

此技能自动生成标准化 SKILL.md 模板，直接指导 AI 封装 API 并编排步骤，开发者仅需确认参数。创建新 Skill 的时间缩短至 10 分钟，且错误率显著降低。

| Metric | Before | After | Change |
|---|---|---|---|
| 创建时长 | 60分钟 | 10分钟 | -83% |

## Readme

# Skill Maker

基于 ziniao-cli 创建新 Skill。Skill = 一份 `SKILL.md`，教 AI 用 CLI 命令完成任务。

## CLI 核心能力

```bash
ziniao-cli <service> <command>                   # 快捷命令
ziniao-cli api [METHOD] <path> [--data/--format] # 任意服务端 API
ziniao-cli zclaw invoke <tool> [--args]          # 任意 ZClaw 工具
ziniao-cli store/page <command>                  # ZClaw 快捷命令
```

优先级：快捷命令 > 通用 api/zclaw invoke。

## 调研 API

```bash
# 1. 查看已有快捷命令
ziniao-cli department --help
ziniao-cli staff --help

# 2. 查看 ZClaw 工具
ziniao-cli zclaw tools

# 3. 通用 api 裸调
ziniao-cli api /superbrowser/rest/v1/erp/per/role/list
```

如果命令不够用，使用 [ziniao-openapi-explorer](../ziniao-openapi-explorer/SKILL.md) 查找 API 路径。

## SKILL.md 模板

文件放在 `skills/ziniao-<name>/SKILL.md`：

```markdown
---
name: ziniao-<name>
version: 1.0.0
description: "<功能描述>。当用户需要<触发场景>时使用。"
metadata:
  requires:
    bins: ["ziniao-cli"]
---


# <标题>

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../ziniao-shared/SKILL.md`](../ziniao-shared/SKILL.md)**

## 命令

\```bash
# 单步操作
ziniao-cli api POST /superbrowser/rest/v1/erp/xxx --data '{...}'

# 多步编排
# Step 1: ...（记录返回的 xxx_id）
# Step 2: 使用 Step 1 的 xxx_id
\```

## 参考

- [ziniao-shared](../ziniao-shared/SKILL.md) — 认证和全局参数
```

## 关键原则

- **description 决定触发** — 包含功能关键词 + "当用户需要...时使用"
- **CRITICAL 依赖** — 所有 Skill 必须强制读取 ziniao-shared
- **安全** — 写入操作前确认用户意图
- **编排** — 说明步骤间的数据传递和失败处理


---
*Source: https://skills.yangsir.net/skill/gh-ziniao-skill-maker*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-ziniao-skill-maker/markdown*