use-task-gateway
Installation
SKILL.md
use-task-gateway
让调用方 App 形成可恢复的闭环:业务执行记录 → 提交任务 → 保存 task_id → 查询进度 → 消费终态结果。普通 App 默认走 Portal HTTP 租户面;任务由已注册服务的节点反向领取,网关不直接执行 payload 中的命令。
先确定接入边界
从调用方仓库查找 manifest、门户鉴权/换票封装、后端配置、业务 run/job/step 模型,以及目标服务的 payload 契约。复用其语言和已有 HTTP 客户端,不要求调用方使用 Rust,也不要求克隆网关源码。
先确认四项:实际 Gateway 基址、用户态或后台服务态、真实服务名、执行器所需输入。缺部署信息时先完成可配置的客户端与业务接线;仅在真实联调依赖该信息时索取,不能猜测生产地址、凭据或服务名。
| 当前工作 | 按需读取 |
|---|---|
| 用户代表调用、后台 SA、manifest 与换票排错 | references/authentication.md |
| HTTP 提交、持久化、幂等、状态、取消、回调、重试 | references/task-api.md |
| 新接 VM/CLI/API 执行能力、SSH 部署能力确认、任务一直 pending 或领取后失败 | references/workers.md |
| 明确接入 workflow 引擎动作目录、placement/lease 或运行中止 | references/workflow-actions.md;先核验引擎专用身份 |
实施普通 App 接入时读取前两份;已有执行服务时不用改节点部署。