智能体集成魔芋Skills

这是一个可下载的 Agent 技能包（Skill），内置魔芋AI平台的全部开发文档与 OpenAPI 规范。
装上它之后，你直接用大白话向 AI 助手提问，它就能给出基于平台真实文档的接口用法、示例代码和对接方案，
不再需要你自己翻文档。文档随平台更新，助手会自动同步到最新。

兼容 Claude Code 与 Codex 等多种 Agent。本技能采用通用的 SKILL.md 标准，
Claude Code、OpenAI Codex CLI、OpenClaw 等支持该标准的工具都能加载，只是安装目录不同（见下）。

一、快速上手（3 步）

第 1 步：下载

打包下载：点击下载魔芋Skills

第 2 步：解压到技能目录

解压后得到一个 moyu-api-docs/ 文件夹，按你使用的工具放到对应技能目录下：

Claude Code

系统	全局安装路径（所有项目可用）
macOS / Linux	`~/.claude/skills/moyu-api-docs/`
Windows	`%USERPROFILE%\.claude\skills\moyu-api-docs\`

OpenAI Codex CLI

系统	全局安装路径（所有项目可用）
macOS / Linux	`~/.codex/skills/moyu-api-docs/`
Windows	`%USERPROFILE%\.codex\skills\moyu-api-docs\`

只想在某个项目里用，就放到该项目的 .claude/skills/（Claude Code）或 .codex/skills/（Codex）下。
两个工具都用的话，把这个文件夹分别放到两个目录即可（内容完全一样）。

安装后目录应该长这样：

~/.claude/skills/moyu-api-docs/       # Codex 则为 ~/.codex/skills/moyu-api-docs/
├── SKILL.md          ← 技能入口，Agent 靠它识别
├── update.py         ← 自更新器
├── manifest.json
├── reference/        ← 索引 + OpenAPI 规范
└── docs/             ← 全部接口文档

第 3 步：重启工具，开始提问

重新打开 Claude Code（或 Codex）。之后你只要提到魔芋AI接口相关的问题，助手会自动启用本技能，
先查内置文档索引，再读对应文档，然后回答。你也可以显式调用它：

Claude Code：直接提问即可，或输入 /moyu-api-docs

Codex：直接提问即可，或输入 $moyu-api-docs，也可用 /skills 查看已装技能

二、怎么用（这是重点）

安装好后，像平时聊天一样提问就行。触发词包括：魔芋 / moyu、/v1/chat/completions、
/v1/video/generations、素材库 / asset、seedance、即梦 jimeng、apifox 等。

常见提问示例

接口用法类

用 curl 调魔芋的 /v1/chat/completions 怎么写？
魔芋的 Anthropic 接口 /v1/messages 鉴权头怎么传？x-api-key 支持吗？
Gemini 接口怎么开流式？stream:true 有用吗？

生成类任务类

用魔芋 Seedance 2.0 做图生视频，metadata.content 数组怎么组织？
即梦文生图和生数（Vidu）文生图，请求体分别长什么样？
豆包文生视频，怎么设置时长和分辨率？

完整流程类

帮我写一段 Python：先把图片上传到魔芋素材库，拿到 asset:// 再提交视频生成，然后轮询结果。
魔芋异步图片任务怎么提交 + 查询？给我可运行的示例。

工具对接类

把魔芋的接口规范导入 Apifox，怎么操作？
（助手会指给你 reference/moyu-openapi.yaml，并说明 Apifox 导入步骤）
帮我在 Cherry Studio / Claude Code / Roo Code 里配置魔芋的 API。

助手会怎么做

你提问后，助手在后台会：

运行 update.py --check 看文档有没有更新（联网时）；

读 reference/INDEX.md 定位到最相关的那篇文档；

读该文档原文，拿到准确的参数、响应格式、示例；

结合你的需求给出答案或可运行代码。

所以它给的接口字段和示例都是照着平台文档来的，不是凭记忆编的。

三、更新文档

技能自带更新器，联网时会只下载有变化的文件（增量更新）：

多数情况下助手回答前会自动帮你 --check，你也可以手动跑。
离线也能用——拉取失败时自动使用已下载的本地文档快照，不影响提问。

四、环境要求

已安装 Claude Code 或 OpenAI Codex CLI（或其他支持 SKILL.md 的 Agent）

Python 3.8+（仅“自更新”功能需要；用的是标准库，无需 pip install 任何东西）

不装 Python 也能用，只是文档停留在你下载时的版本，无法自动更新。

五、常见问题

Q：装好了但助手好像没用这个技能？
A：确认 SKILL.md 就在 .../skills/moyu-api-docs/ 这一层（不要多套一层文件夹），
然后完全重启工具。也可以显式点名：Claude Code 用 /moyu-api-docs、Codex 用 $moyu-api-docs，
或直接说“用 moyu-api-docs 技能查一下……”。

Q：python update.py 报连接失败？
A：说明当前联不上平台，属正常降级——技能会继续用本地快照。恢复网络后再跑一次即可。

Q：里面的接口是最新的吗？
A：docs/ 是下载时的快照；跑 update.py 就会对齐平台最新。想确认版本看 VERSION 文件。

一、快速上手（3 步）#

第 1 步：下载#

第 2 步：解压到技能目录#

第 3 步：重启工具，开始提问#

二、怎么用（这是重点）#

常见提问示例#

助手会怎么做#

三、更新文档#

四、环境要求#

五、常见问题#