Back to Details

ziniao-skill-maker

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Maker

Skill Maker

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

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。
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

调研 API

bash
undefined
bash
undefined

1. 查看已有快捷命令

1. 查看已有快捷命令

ziniao-cli department --help ziniao-cli staff --help
ziniao-cli department --help ziniao-cli staff --help

2. 查看 ZClaw 工具

2. 查看 ZClaw 工具

ziniao-cli zclaw tools
ziniao-cli zclaw tools

3. 通用 api 裸调

3. 通用 api 裸调

ziniao-cli api /superbrowser/rest/v1/erp/per/role/list

如果命令不够用，使用 [ziniao-openapi-explorer](../ziniao-openapi-explorer/SKILL.md) 查找 API 路径。
ziniao-cli api /superbrowser/rest/v1/erp/per/role/list

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

SKILL.md 模板

SKILL.md 模板

文件放在 
skills/ziniao-<name>/SKILL.md
：
markdown
---
name: ziniao-<name>
version: 1.0.0
description: "<功能描述>。当用户需要<触发场景>时使用。"
metadata:
  requires:
    bins: ["ziniao-cli"]
---
文件放在 
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
CRITICAL — 开始前 MUST 先用 Read 工具读取 
../ziniao-shared/SKILL.md

命令

命令

```bash
```bash

单步操作

单步操作

ziniao-cli api POST /superbrowser/rest/v1/erp/xxx --data '{...}'
ziniao-cli api POST /superbrowser/rest/v1/erp/xxx --data '{...}'

多步编排

多步编排

Step 1: ...（记录返回的 xxx_id）

Step 1: ...（记录返回的 xxx_id）

Step 2: 使用 Step 1 的 xxx_id

Step 2: 使用 Step 1 的 xxx_id

```
```

参考

参考

  • ziniao-shared — 认证和全局参数
undefined
  • ziniao-shared — 认证和全局参数
undefined

关键原则

关键原则

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