ziniao-skill-maker

Skill Maker

Create a new Skill based on ziniao-cli. A Skill = a SKILL.md, teaching AI to complete tasks using CLI commands.

CLI Core Capabilities

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 快捷命令

Priority: shortcut commands > general api/zclaw invoke.

Research API

# 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

If the commands are not enough, use ziniao-openapi-explorer to look up API paths.

SKILL.md Template

Place the file in skills/ziniao-<name>/SKILL.md：

---
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) — 认证和全局参数

Key Principles

• description determines triggering — include feature keywords + "use when the user needs..."
• CRITICAL dependency — all Skills must mandatorily read ziniao-shared
• Safety — confirm user intent before write operations
• Orchestration — explain data passing and failure handling between steps