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
- 读 contract,抄出镜数 / 逐镜时长 / 参数清单;读 SOP 的「已实测结论」与「请求体形状未验证」节。
- 探测接口(先探测,后排产,不凭猜测构造大 payload):
GET {H3_CONSOLE_BASE_URL}/v1/videos(带Authorization: Bearer $H3_CONSOLE_TOKEN)看返回结构、字段名、状态枚举;- 再探
/v1/openapi/v1/schema/v1/docs等端点; - 都没有 → 一次最小 POST 试提交确认字段名,再正式排产。
- 把探测结果(端点、返回码、字段名、状态枚举)记进
_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
ffprobe -v error -show_entries format=duration,size -of default=nw=1 artifact.mp4—— 非 0 字节、时长与 contract 总时差 ≤10%。grep -rc "Bearer\|H3_CONSOLE_TOKEN\|?token=" 06-render/必须 0 命中。- log 里逐镜任务 id 与状态齐全;抽查 1-2 个任务 id 能在
GET /v1/videos里对上真实状态。
硬规矩(本角色)
- 不伪造成片 / 渲染日志 / 任务 id;没有真产物就是没有,blocked 上报。
- 不凭猜测 POST 大 payload;请求体形状未验证就排产属违规。
- 我没有 fail 出边:GPU/超时/换卡重试是我节点内部的事,消化不了就 blocked,不甩给 org 层。