mcpField
A
aliyun-anytrans-translate

aliyun-anytrans-translate

github.com/cinience生产力39661 次安装11 周前更新
代码仓库

关于 aliyun-anytrans-translate

通过阿里云 OpenAPI RPC 管理 TongyiTranslate 资源,可使用官方 SDK 或 OpenAPI Explorer。该技能侧重 API 发现、地域与凭证处理,以及操作结果验证。

主要功能

  1. 01发现 API 和参数结构
  2. 02列出并描述资源
  3. 03创建和更新资源
  4. 04检查状态并诊断问题
  5. 05保存操作记录

适用场景

  1. 01检查 TongyiTranslate 资源
  2. 02更改资源配置
  3. 03查询操作状态

安装

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

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-anytrans-translate

安装后在 Claude Code 中输入/aliyun-anytrans-translate确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
sources.md
scripts/
list_openapi_meta_apis.py

详细介绍

类别:服务

TongyiTranslate

使用阿里云 OpenAPI(RPC)和官方 SDK 或 OpenAPI Explorer 管理 TongyiTranslate 资源。

工作流

  1. 确认地域、资源标识符和所需操作。
  2. 查找 API 列表和必需参数(参见参考资料)。
  3. 使用 SDK 或 OpenAPI Explorer 调用 API。
  4. 使用 describe/list API 验证结果。

AccessKey 优先级(必须遵循)

  1. 环境变量:ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID 地域策略:ALIBABACLOUD_REGION_ID 是可选的默认值。若未设置,请为任务选择最合理的地域;如果不明确,请询问用户。
  2. 共享配置文件:~/.alibabacloud/credentials

API 发现

  • 产品代码:AnyTrans
  • 默认 API 版本:2025-07-07
  • 使用 OpenAPI 元数据端点列出 API 并获取架构(参见参考资料)。

高频操作模式

  1. 资源清单/列表:优先使用 List* / Describe* API 获取当前资源。
  2. 更改/配置:优先使用 Create* / Update* / Modify* / Set* API 执行更改。
  3. 状态/故障排查:优先使用 Get* / Query* / Describe*Status API 进行诊断。

最简可执行快速入门

调用业务 API 前,先基于元数据进行发现:

python scripts/list_openapi_meta_apis.py

可选覆盖项:

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

脚本会将 API 清单文件写入技能输出目录。

输出策略

如需保存响应或生成的文件,请将其写入: output/aliyun-anytrans-translate/

验证

mkdir -p output/aliyun-anytrans-translate
for f in skills/ai/translation/aliyun-anytrans-translate/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-anytrans-translate/validate.txt

通过标准:命令退出码为 0,且生成了 output/aliyun-anytrans-translate/validate.txt。

输出与证据

  • 将文件、命令输出和 API 响应摘要保存在 output/aliyun-anytrans-translate/ 下。
  • 在证据文件中包含关键参数(地域/资源 ID/时间范围),以便复现。

前提条件

  • 执行前配置遵循最小权限原则的阿里云凭证。
  • 优先使用环境变量:ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET,以及可选的 ALIBABACLOUD_REGION_ID。
  • 如果地域不明确,请在运行会更改资源的操作前询问用户。

参考资料

  • 来源:references/sources.md

评论

支持 Markdown