SuperAPI AI 工具集

ziniao-skill-maker

智能体与模型

查看项目

更新于 10-16 09:45

技能介绍

用途:基于 ziniao-cli 创建新的紫鸟 Skill。此处 Skill 指一份 SKILL.md 文件,用于教 AI 通过 CLI 命令完成任务,适合把紫鸟 API 操作封装为可复用 Skill,既可包装单个原子 API,也可编排多步流程。

主要能力与命令:ziniao-cli 提供快捷命令 ziniao-cli <service> <command>,通用 API 调用 ziniao-cli api [METHOD] <path> [--data/--format],通用 ZClaw 工具调用 ziniao-cli zclaw invoke <tool> [--args],以及 ZClaw 快捷命令 ziniao-cli store/page <command>。优先级为快捷命令高于通用 api/zclaw invoke。

调研方式:可用 ziniao-cli department --help、ziniao-cli staff --help 查看已有快捷命令;用 ziniao-cli zclaw tools 查看 ZClaw 工具;用 ziniao-cli api /superbrowser/rest/v1/erp/per/role/list 进行通用 api 裸调。若命令不够用,使用 ziniao-openapi-explorer 查找 API 路径。

SKILL.md 结构:文件放在 skills/ziniao-<name>/SKILL.md,头部包含 name、version、description,description 需含功能关键词与触发场景(当用户需要……时使用),并在 metadata.requires.bins 声明依赖 ziniao-cli。正文须以 CRITICAL 提示强制先读取 ../ziniao-shared/SKILL.md(认证和全局参数),再列命令;命令部分可写单步操作或多步编排,多步需说明记录返回的 xxx_id 等步骤间数据传递与失败处理,并在参考中链接 ziniao-shared。

关键原则:description 决定触发;所有 Skill 必须强制读取 ziniao-shared;写入操作前确认用户意图;编排需说明步骤间数据传递和失败处理。

限制:资料未提供具体收费、价格、平台或效果信息;实际 API 路径与可用命令需现场调研确认。