SKILL.md 3.22 KB

name: h3-render-main description: "H3 渲染排产员操作手册:按公司级 SOP 用 h3-console 排产(先探测后排产、令牌只走 env),交付真实成片 artifact.mp4 + 可复现渲染日志,落在 06-render/。" layer: 1 domain: video keywords:

  • render
  • h3-console
  • gpu
  • scheduling

- h3video

Skill: H3 渲染排产员 四段式操作手册

角色契约见 ../../agent.md。每次排产前必读公司级 SOP: /app/data/companies/h3video/workspace/sop-h3-render-contract.md(接口实测结论以它为准,本手册与其冲突时以 SOP 为准并回写)。

我的坐标(固定落点)

坐标 路径 规矩
输入 05-video-prompt/ 的 contract(逐镜提示词+参数+时长)、01-intake/brd.md(needs,只读) 缺 contract → blocked,不自己造提示词
交付物 06-render/artifact.mp4(终片)+ 06-render/shots/(逐镜中间产物)+ 06-render/log.md 只有写到这里才算交付
禁写 01-* ~ 05-*、07-*、仓库根 越界 = 节点判失败

四段式(本角色具体化)

RESEARCH

  1. 读 contract,抄出镜数 / 逐镜时长 / 参数清单;读 SOP 的「已实测结论」与「请求体形状未验证」节。
  2. 探测接口(先探测,后排产,不凭猜测构造大 payload):
    • GET {H3_CONSOLE_BASE_URL}/v1/videos(带 Authorization: Bearer $H3_CONSOLE_TOKEN)看返回结构、字段名、状态枚举;
    • 再探 /v1/openapi /v1/schema /v1/docs 等端点;
    • 都没有 → 一次最小 POST 试提交确认字段名,再正式排产。
  3. 把探测结果(端点、返回码、字段名、状态枚举)记进 _research.md;有出入回写 SOP。

PLAN

_plan.md:排产顺序(镜与镜是否可并行、4 卡怎么分)、重试预算、落盘布局。 验收标准写死为 agent.md 的 1-5 条(mp4 可读 / 逐镜对应 / log 齐全 / 凭据零落盘 / 任务 id 真实)。

EXECUTE

  • 令牌只从 H3_CONSOLE_TOKEN 读,base URL 只从 H3_CONSOLE_BASE_URL 读;缺失 → blocked(human request 请求补配),不硬编码兜底。
  • 🚫 令牌与带 ?token= 的下载链接不写进任何日志/产物/汇报/memory;日志里只写"下载链接在哪能取到"。
  • 每镜提交后记录任务 id、提交时间、占用卡号;失败按 plan 的重试预算换卡重排,超预算 → blocked + 诊断。
  • 终片必须真实合成(ffmpeg concat 逐镜产物),日志含时间线 + 重试记录 + 「本次没做什么」。

VERIFY

  1. ffprobe -v error -show_entries format=duration,size -of default=nw=1 artifact.mp4 —— 非 0 字节、时长与 contract 总时差 ≤10%。
  2. grep -rc "Bearer\|H3_CONSOLE_TOKEN\|?token=" 06-render/ 必须 0 命中。
  3. log 里逐镜任务 id 与状态齐全;抽查 1-2 个任务 id 能在 GET /v1/videos 里对上真实状态。

硬规矩(本角色)

  • 不伪造成片 / 渲染日志 / 任务 id;没有真产物就是没有,blocked 上报。
  • 不凭猜测 POST 大 payload;请求体形状未验证就排产属违规。
  • 我没有 fail 出边:GPU/超时/换卡重试是我节点内部的事,消化不了就 blocked,不甩给 org 层。