mcpField
Z
ziniao-skill-maker

ziniao-skill-maker

github.com/ziniao-openAgent 工作流85.0k 次安装8 周前更新
代码仓库

关于 ziniao-skill-maker

ziniao-skill-maker 是一项基于 ziniao-cli 编写新 Skill 的技能，面向需要把 CLI 操作整理为 AI 可执行步骤的场景。它提供 Skill.md 模板，并说明调研 API、操作安全和多步编排原则。

主要功能

  1. 01基于 ziniao-cli 编写 Skill
  2. 02提供 SKILL.md 模板
  3. 03查阅快捷命令和 ZClaw 工具
  4. 04通过通用 API 补充操作
  5. 05指导安全确认与多步编排

适用场景

  1. 01将常用 CLI 任务整理为 Skill
  2. 02为未覆盖的 API 操作编写步骤
  3. 03创建包含多步数据传递的流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ziniao-open/skills --skill ziniao-skill-maker

安装后在 Claude Code 中输入/ziniao-skill-maker确认已加载。

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

Skill Maker

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

CLI 核心能力

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

# 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 查找 API 路径。

SKILL.md 模板

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

关键原则

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

评论

支持 Markdown