Modal 云部署技能

将执行脚本部署到 Modal 云平台。当用户要求部署到 Modal、将代码推送到云端或更新 Modal 函数时使用。

Modal 云部署技能是什么？

该技能用于将执行脚本部署到 Modal 云平台，实现无服务器云执行。它支持通过 `modal deploy` 命令部署单个文件（默认为 `execution/modal_webhook.py`），并提供多个预定义的 API 端点，包括指令执行、Webhook 列表、通用代理任务、潜在客户抓取、提案生成和 YouTube 离群点抓取。用户可以轻松添加新函数，只需在 `execution/modal_webhook.py` 中添加函数并使用 `@app.function()` 装饰器，然后重新部署即可。技能还支持 Cron 定时任务，通过 `schedule=modal.Cron(...)` 参数实现。Modal 的秘密凭据（`MODAL_TOKEN_ID` 和 `MODAL_TOKEN_SECRET`）在 Modal 仪表板中配置，而不是本地 `.env` 文件。该技能适用于支持 CLI 和 Python 的 AI 代理平台（如 Claude Code、Cursor、Codex），并与 `add-webhook` 技能可组合使用。

兼容平台~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/aiagentwithdhruv/skills/tree/HEAD/modal-deploy

文档

Modal 云部署

目标

将执行脚本部署到 Modal，实现无服务器云执行。

部署命令

modal deploy execution/modal_webhook.py

关键端点

端点	用途
`directive`	根据 slug 执行指令
`list_webhooks`	列出可用的 Webhook
`general_agent`	运行通用代理任务
`scrape_leads`	潜在客户抓取端点
`generate_proposal`	提案生成
`youtube_outliers`	YouTube 离群点抓取

添加新函数

向 execution/modal_webhook.py 添加函数
使用 @app.function() 或 @app.function(schedule=modal.Cron(...)) 进行装饰
部署：modal deploy execution/modal_webhook.py

环境

Modal 秘密在 Modal 仪表板中配置，而不是本地 .env。

Cron 任务

@app.function(schedule=modal.Cron("0 * * * *"))  # 每小时
async def my_scheduled_function():
    pass

模式

输入

名称	类型	必填	描述
`file`	file_path	否	要部署的文件（默认：execution/modal_webhook.py）

输出

名称	类型	描述
`deployed`	boolean	部署是否成功
`endpoints`	array	已部署的端点 URL 列表

凭据

名称	来源
`MODAL_TOKEN_ID`	Modal 仪表板
`MODAL_TOKEN_SECRET`	Modal 仪表板

可组合技能

与此技能链式结合良好的技能：add-webhook

费用

Modal 计算（按使用付费）

Modal 云部署技能