关于 aliyun-modelstudio-entry
aliyun-modelstudio-entry 将 Alibaba Cloud Model Studio 请求路由到已有的本地 skills,按任务类型选择对应技能;没有匹配项时可用于澄清需求并识别能力缺口。
主要功能
- 01按任务和模态路由
- 02列出支持的本地 skills
- 03涵盖生成与检索任务
- 04提供需求澄清问题
- 05包含异步任务轮询指引
适用场景
- 01为文本、图像、音频或视频任务查找技能
- 02路由向量检索请求
- 03没有匹配技能时识别能力缺口
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill aliyun-modelstudio-entry安装后在 Claude Code 中输入/aliyun-modelstudio-entry确认已加载。
附带文件agents/openai.yamlreferences/sources.md
详细介绍
类别:task
阿里云 Model Studio 入口(路由)
将请求路由到现有本地技能,避免重复介绍模型和参数详情。
前提条件
- 安装 SDK(建议使用虚拟环境,以避免 PEP 668 限制):
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
- 配置
DASHSCOPE_API_KEY(优先使用环境变量;也可在~/.alibabacloud/credentials中配置dashscope_api_key)。
路由表(此仓库当前支持)
| 需求 | 目标技能 |
|---|---|
| 文本生成 / 推理 / 工具调用 | skills/ai/text/aliyun-qwen-generation/ |
| 编码 / 仓库推理 | skills/ai/code/aliyun-qwen-coder/ |
| 深度多步研究 | skills/ai/research/aliyun-qwen-deep-research/ |
| 文本生成图像 / 图像生成 | skills/ai/image/aliyun-qwen-image/ |
| 图像编辑 | skills/ai/image/aliyun-qwen-image-edit/ |
| 文本生成视频 / 图像生成视频(t2v/i2v) | skills/ai/video/aliyun-wan-video/ |
| 非 Wan PixVerse 视频生成 | skills/ai/video/aliyun-pixverse-generation/ |
| 参考图生成视频(r2v) | skills/ai/video/aliyun-wan-r2v/ |
| 数字人说话 / 唱歌头像 | skills/ai/video/aliyun-wan-digital-human/ |
| 富有表现力的人像视频(EMO) | skills/ai/video/aliyun-emo/ |
| 轻量级人像动画(LivePortrait) | skills/ai/video/aliyun-liveportrait/ |
| 动作迁移 / 舞蹈头像(AnimateAnyone) | skills/ai/video/aliyun-animate-anyone/ |
| 表情符号 / 表情包人像视频 | skills/ai/video/aliyun-emoji/ |
| 文本转语音(TTS) | skills/ai/audio/aliyun-qwen-tts/ |
| 语音识别 / 转录(ASR) | skills/ai/audio/aliyun-qwen-asr/ |
| 实时语音识别 | skills/ai/audio/aliyun-qwen-asr-realtime/ |
| 实时 TTS | skills/ai/audio/aliyun-qwen-tts-realtime/ |
| 实时语音翻译 | skills/ai/audio/aliyun-qwen-livetranslate/ |
| CosyVoice 声音克隆 | skills/ai/audio/aliyun-cosyvoice-voice-clone/ |
| CosyVoice 声音设计 | skills/ai/audio/aliyun-cosyvoice-voice-design/ |
| 声音克隆 | skills/ai/audio/aliyun-qwen-tts-voice-clone/ |
| 声音设计 | skills/ai/audio/aliyun-qwen-tts-voice-design/ |
| Omni 多模态交互 | skills/ai/multimodal/aliyun-qwen-omni/ |
| 视觉推理 | skills/ai/multimodal/aliyun-qvq/ |
| OCR / 文档解析 / 表格解析 | skills/ai/multimodal/aliyun-qwen-ocr/ |
| 文本嵌入 | skills/ai/search/aliyun-qwen-text-embedding/ |
| 多模态嵌入 | skills/ai/search/aliyun-qwen-multimodal-embedding/ |
| 重排序 | skills/ai/search/aliyun-qwen-rerank/ |
| 向量检索 | skills/ai/search/aliyun-dashvector-search/ 或 skills/ai/search/aliyun-opensearch-search/ 或 skills/ai/search/aliyun-milvus-search/ |
| 文档理解 | skills/ai/text/aliyun-docmind-extract/ |
| 视频编辑 | skills/ai/video/aliyun-wan-edit/ |
| 视频唇形同步替换 / 重新配音 | skills/ai/video/aliyun-videoretalk/ |
| 模型列表抓取 / 更新 | skills/ai/misc/aliyun-modelstudio-crawl-and-skill/ |
无匹配项时
- 首先确认模型能力和输入 / 输出类型。
- 如果仓库缺少所需能力,先添加新技能。
此仓库常见的缺失能力(待补齐)
-
图像翻译
-
虚拟试穿 / 数字人 / 高级视频角色
-
对于多模态 / ASR 下载失败,优先使用上方列出的公共 URL。
-
对于 ASR 参数错误,请在
input_audio.data中使用 data URI。 -
对于多模态嵌入返回 400 错误,请确保
input.contents是一个数组。
异步任务轮询模板(视频 / 长时间运行的任务)
当 X-DashScope-Async: enable 返回 task_id 时,按以下方式轮询:
GET https://dashscope.aliyuncs.com/api/v1/tasks/<task_id>
Authorization: Bearer $DASHSCOPE_API_KEY
成功时的示例结果字段:
{
"output": {
"task_status": "SUCCEEDED",
"video_url": "https://..."
}
}
说明:
- 建议轮询间隔:15-20 秒,最多尝试 10 次。
- 成功后,下载
output.video_url。
澄清问题(不确定时请询问)
- 你要处理的是文本、图像、音频还是视频?
- 这是生成、编辑/理解还是检索?
- 你需要语音(TTS/ASR/实时翻译)还是检索(嵌入/重排/向量数据库)?
- 你需要可运行的 SDK 脚本,还是只需要 API/参数指导?
参考资料
-
模型列表和链接:
output/alicloud-model-studio-models-summary.md -
API/参数/示例:参见目标子技能的
SKILL.md和references/*.md -
官方来源列表:
references/sources.md
验证
mkdir -p output/aliyun-modelstudio-entry
echo "validation_placeholder" > output/aliyun-modelstudio-entry/validate.txt
通过标准:命令以 0 退出,并生成 output/aliyun-modelstudio-entry/validate.txt。
输出和证据
- 将产物、命令输出和 API 响应摘要保存在
output/aliyun-modelstudio-entry/下。 - 在证据文件中包含关键参数(区域/资源 ID/时间范围),以便复现。
工作流
- 确认用户意图、区域、标识符,以及操作是只读还是会修改数据。
- 先运行一个最小只读查询,以验证连接和权限。
- 使用明确的参数和有限的范围执行目标操作。
- 验证结果并保存输出/证据文件。
评论
支持 Markdown