Agent Skills
› ArcReel/ArcReel
› adapt-custom-endpoint
adapt-custom-endpoint
GitHub适配视频供应商至ArcReel，通过编写定义、校验、预览及真实测试连接，完成自定义端点的验证与保存。
Trigger Scenarios
接入JSON提交后轮询协议的视频供应商
编写或验证自定义调用端点定义
Install
npx skills add ArcReel/ArcReel --skill adapt-custom-endpoint -g -y
SKILL.md
Frontmatter
{
"name": "adapt-custom-endpoint",
"description": "当用户要求把采用 JSON 提交后轮询协议的视频供应商接入 ArcReel，或要求编写、验证、测试、保存自定义调用端点定义时使用。"
}
适配自定义调用端点
使用随 skill 提供的 scripts/custom_endpoint.py 调用 ArcReel HTTP API；共享 validator 和 API 是验证与保存定义的唯一入口。
工作流
- 读取用户提供的供应商文档 URL；无法读取时请用户粘贴提交、查询任务与响应示例。 确认协议属于 JSON 请求/响应的「提交后轮询」形态。签名鉴权、multipart 请求或按素材切换路由 无法由首期定义表达，直接说明缺口。
- 需要编写或修正定义时读取定义格式，在工作目录创建定义 JSON、
测试参数 JSON，以及供应商提供的真实响应样本。凭证优先引用 ArcReel 已保存的自定义供应商
provider_id；不得把 API Key 写入项目文件、命令参数或回复。 - 运行当前 skill 目录下的
scripts/custom_endpoint.py，用validate <definition.json>子命令校验。 修正到errors为空。schema_version.level非direct或仍有warnings时，修正或向用户说明接受的原因和影响；用hints准备测试所需的接口地址和模型。 - 对供应商的提交与轮询响应分别运行
check-response；定义包含result时也检查取件响应。 - 运行
preview-request，核对 URL、method、打码后的 headers、body 与素材摘要。定义有必需素材时， 用--start-image/--end-image/--reference-images/--reference-audio-files附上对应文件。 - 测试连接会真实请求供应商并可能计费。调用前必须回问用户。 获得明确同意后才运行
trial-run ... --confirm-cost（沿用预览时的素材参数），再用trial-status <run-id>查询到终态， 并转述请求、响应、取值与错误。状态为succeeded时继续；其他终态停止，只有用户明确要求保存未验证定义时才继续。 - 再次 validate。没有同血统端点时用
save新建；有重复时默认另存副本并告知用户。 只有覆盖既有端点必须回问用户；明确同意后才用save ... --endpoint-id <id> --confirm-overwrite。保存成功以返回ce-<id>为完成判据。
连接
在当前工作区根目录运行脚本。脚本读取 setup-arcreel-skills 创建的 .arcreel/settings.json，从
mcp_url 派生同实例的 /api/v1 地址，并用 api_key 鉴权；配置缺失或无效时先执行 setup skill，
不回退到 localhost。
设置 ARCREEL_EMBEDDED_AGENT=1 时，脚本优先使用 ARCREEL_API_BASE 与 ARCREEL_API_TOKEN；该 JWT
有效期 15 分钟且不续期，API 调用返回 401 时告知用户重开会话获取新 token。
AUTH_ENABLED=false 的本地部署可留空 token。
Version History
- cd64517 Current 2026-09-03 08:46
