官方 Skill

用途

当客户研发说「接入紫薯通告 API」「接收紫薯通告 Webhook」「每 5 分钟同步达人」时， AI 可以读取 Skill 中的 references 和 examples，生成贴合当前技术栈的接入代码。

发现、安装与更新

官方发布源为公开 GitHub 仓，skills.sh 详情页已可访问。搜索索引可能存在延迟； 如果暂时搜不到，直接安装命令仍然可用。

# 详情页
https://www.skills.sh/zs-openapi/skills/zs-openapi

# 安装
npx skills add https://github.com/zs-openapi/skills --skill zs-openapi -g -y

# 更新
npx skills check
npx skills update

# 搜索
npx skills find zishutonggao
npx skills find "zishu tonggao"
npx skills find "紫薯通告"
npx skills find zsblogger

覆盖能力

• Webhook 接收端：Node.js / Python / Java 示例
• REST 主动拉客户端：覆盖 10 个 /open-api/* 接口
• 增量同步脚本：since + cursor 双游标
• HMAC-SHA256 验签与时间戳防重放
• LOCAL/CLOUD 模式提示
• 错误码与重试策略说明

推荐触发语句

接入紫薯通告数据同步
生成一个 Node.js 接收紫薯通告 webhook 的服务
生成一个 Java Spring Boot 接收紫薯通告 webhook 的服务
用 ZSK_API_KEY 每 5 分钟增量同步达人到我们的 CRM
根据紫薯通告 /open-api/* 写一个 TypeScript client

文档同步规则

npx skills check
npx skills update

• 主动拉只使用 ZSK_API_KEY。
• 主动推只使用端点级 WEBHOOK_SECRET。
• bloggers 始终是数组。
• priceJson、rawData 保持结构化。
• 对外 Blogger 不暴露 organizationId、ownerUserId。