Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
fix(skill): keep reconstruction evidence-first
rpone1440db5c1c4e
diff --git a/docs/guide/skill.md b/docs/guide/skill.mdindex d19a9c3a..42a71f6b 100644--- a/docs/guide/skill.md+++ b/docs/guide/skill.md@@ -275,9 +275,16 @@ edge needed by the Film. It has no reference video, so `brief.json` is the autho2. Check HypiHub OAuth. If it is missing, explain why and run `hypit auth login hypihub.default --runtime hypit.runtime.json`, then run `hypit runtime up` and confirm WhisperX is ready before `prepare_reference`, observation or Gemini calls.3. Enumerate components only after reference evidence is complete. A proven vocabulary gap follows the project-package branch: implement and validate the complete package (`package.json`, activation, Manifest, Types, Producers, Validators, Surface/decoder, Fragment, README and preview). Never edit installed packages or copy reference media directly.+Reconstruction is strictly evidence-first: the route never reads repository `examples/` projects, including+their complete `.svml`, `.svs`, `.svrun`, README, assets or variants. The sole exception is the generic+`examples/minimal-author-package/` fixture after a real vocabulary gap is proven and the local-package+workflow requires its contract. The reference video and persisted observations are the source of truth;+after observation, read only installed package vocabulary and craft guidance required by observed systems.+Examples belong to original authoring and variant planning, not reconstruction.+```textenvironment → reference-prepared → reference-observed-→ examples/format/craft decisions → vocabulary/component-fit+→ reference/format/craft decisions → vocabulary/component-fit→ Script and four sources → source-authored → package-ready → script-checked → graph-checked→ layout-checked → review-planned → preview-rendered → comparison-complete→ repairs-complete → final-checked → initial-adaptation → final check again@@ -297,7 +304,7 @@ The reconstruction order is deliberately different from a description-only job:| 1. Prepare | Select the observer once, resolve a local file or download/cache a link, and start route state. | `observers.md`, `credentials.md`, `prepare_reference`, `route_state start` | A stable reference id, media metadata and observer choice prevent later turns from rereading a different file or silently changing observers. || 2. Observe the whole video | Run the fixed whole-reference sweep, then read its transcript/alignment, persistent systems, people/voices, visual type and sound context. | `observe_reference`, `evidence.md` | Whole-video evidence establishes what exists throughout the program; it is the basis for reconstructing every shot, not one representative frame. || 3. Resolve structure | Inspect shot boundaries and ask narrow questions where a single frame cannot establish an appearance value, transition or relationship. | `observe_reference --question`, `continuity.md`, `reconstruction/vocabulary.md` | Ambiguities become persisted evidence before Source is authored, so timing and continuity are not guessed from chat memory. |-| 4. Choose format and components | Read examples/playbooks, enumerate candidate packages, inspect public vocabulary and classify any real package gap. | `brief-intake.md`, `playbooks/index.md`, `list_svml_packages`, `inspect_svml_vocabulary`, `component-fit.json` | The recreated program has a legal component for each observed visual role; installed packages remain immutable. |+| 4. Choose format and components | Use completed reference evidence and observed systems to enumerate candidate packages and inspect public vocabulary; do not read example projects. Only a proven gap may use `examples/minimal-author-package/` for the generic package contract. | `playbooks/index.md` (as needed), `list_svml_packages`, `inspect_svml_vocabulary`, `component-fit.json` | The recreated program has a legal component for each observed visual role; installed packages remain immutable. || 5. Build a faithful Source | Convert transcript and observations into Script Segments/Takes/Cues, then author all four sources and every graph edge. | `final-sources.md`, `authoring.md`, `script-time.md`, `runtime.md` | The source describes the entire reference timeline, including narration, overlays, B-roll, transitions, audio and Targets. || 6. Prove the baseline | Run Run-scoped vocabulary/package/Cue checks, syntax, graph tracing and realized layout. | `inspect_svml_vocabulary --run`, `validate_local_author_packages`, `validate_script_cues`, `hypit check`, `preview_check`, `layout_check` | No comparison is attempted until the written graph can actually produce every declared Track. || 7. Create the comparison plan | Determine every distinct declaration and every reference stretch it occupies; keep stable intervals and shot boundaries. | `reconstruction_check`, `comparison-round.md`, `element-review.md` | The plan covers the whole video, not only a convenient still; each item has its own reference tokens and render window. |diff --git a/docs/zh/guide/skill.md b/docs/zh/guide/skill.mdindex fe446e1f..7caf7fe0 100644--- a/docs/zh/guide/skill.md+++ b/docs/zh/guide/skill.md@@ -238,9 +238,14 @@ environment → brief-frozen → examples/格式/craft 决策2. 检查 HypiHub OAuth。凭据缺失时由 agent 说明原因并执行 `hypit auth login hypihub.default --runtime hypit.runtime.json`,然后运行 `hypit runtime up`,确认 WhisperX 已就绪后才能 `prepare_reference`、观察或调用 Gemini。3. 参考证据完成后再枚举组件。确认词汇缺口时,按原创路径的项目本地包分支实现并验证完整包(`package.json`、activation、Manifest、Types、Producers、Validators、Surface/decoder、Fragment、README、preview),不能修改安装包或直接复制参考素材。+复刻采用严格的“证据优先”顺序:整条复刻路径都禁止读取仓库 `examples/` 下的项目,包括完整的+`.svml`、`.svs`、`.svrun`、README、素材和变体。唯一例外是确认真实词汇缺口、且项目本地包流程明确+需要通用契约时,才允许读取 `examples/minimal-author-package/`。参考视频及其持久化观察证据是事实来源;+之后只读取实际需要的安装包词汇和 craft 指南。Examples 属于原创制作和变体规划,不属于复刻。+```textenvironment → reference-prepared → reference-observed-→ examples/格式/craft 决策 → vocabulary/component-fit → package-ready+→ reference/craft 决策 → vocabulary/component-fit → package-ready→ Script 与四个源文件 → script-checked → source-authored → graph-checked→ layout-checked → review-planned → preview-rendered → comparison-complete→ repairs-complete → final-checked → 初始改编 → 再跑 final check@@ -257,7 +262,7 @@ environment → reference-prepared → reference-observed| 1. 准备参考 | 选择一次 observer,接收本地文件或下载并缓存链接视频,启动路线状态。 | `observers.md`、`credentials.md`、`prepare_reference`、`route_state start` | 得到稳定的 reference id、媒体元数据和 observer;恢复时不会换文件或换观察者。 || 2. 观察全片 | 运行固定的全片观察,读取 transcript/alignment、持久视觉系统、人物/声音、视觉类型和声音上下文。 | `observe_reference`、`evidence.md` | 全片证据说明视频中到底有哪些镜头和系统,是重建所有镜头的依据,不是挑一帧模仿。 || 3. 解决结构疑点 | 检查 shot 边界;单帧无法确定外观、转场或关系时,用窄问题补证据。 | `observe_reference --question`、`continuity.md`、`reconstruction/vocabulary.md` | 把歧义写入证据后再写 Source,时间和连续性不靠对话记忆猜。 |-| 4. 选择格式与组件 | 检查 examples/playbooks,枚举候选包,检查公开词汇,确认是否真的缺包。 | `brief-intake.md`、`playbooks/index.md`、`list_svml_packages`、`inspect_svml_vocabulary`、`component-fit.json` | 每个观察到的视觉角色都有合法组件;安装包保持不可变。 |+| 4. 选择格式与组件 | 只根据已完成的参考证据和实际观察到的系统,枚举候选包并检查公开词汇;复刻路径禁止读取 examples 项目,只有真实缺口且包流程需要时可读取 `examples/minimal-author-package/`。 | `playbooks/index.md`(仅按需)、`list_svml_packages`、`inspect_svml_vocabulary`、`component-fit.json` | 每个观察到的视觉角色都有合法组件;安装包保持不可变。 || 5. 写出忠实 Source | 把 transcript 和观察结果转成 Script 的 Segment/Take/Cue,再写四个源文件和所有 graph edge。 | `final-sources.md`、`authoring.md`、`script-time.md`、`runtime.md` | Source 描述完整参考时间线,包括旁白、叠加层、B-roll、转场、音频和 Target。 || 6. 证明基线 | 运行 Run 级词汇/包/Cue 检查、语法、graph tracing 和真实布局。 | `inspect_svml_vocabulary --run`、`validate_local_author_packages`、`validate_script_cues`、`hypit check`、`preview_check`、`layout_check` | 只有每条声明的 Track 都确实能产出时,才进入昂贵的视觉比对。 || 7. 生成比对计划 | 找出每种不同声明以及它覆盖的每个参考片段,保留稳定区间和 shot 边界。 | `reconstruction_check`、`comparison-round.md`、`element-review.md` | 计划覆盖整条视频,而不是挑一个好看的静帧;每项都有自己的 reference token 范围和渲染窗口。 |diff --git a/skills/hypit/SKILL.md b/skills/hypit/SKILL.mdindex 2076e26d..d6c9c2d5 100644--- a/skills/hypit/SKILL.md+++ b/skills/hypit/SKILL.md@@ -86,6 +86,16 @@ visible shot in a reconstruction must be newly authored as a generated take or aauthor-supplied replacement asset. A source that directly plays the reference is not a reconstructionand must be rejected before preview or Build.+**Reconstruction has an evidence-first reading order.** On the reconstruction route, never inspect the+repository's `examples/` projects at any point. Do not read their complete SVML, SVS, SVRun, README,+assets or variants: that material can anchor the agent to an unrelated implementation and overwhelm the+reference evidence. The only permitted `examples/` exception is the+`examples/minimal-author-package/` fixture, and only after a real vocabulary gap has been proven and+the local-package workflow explicitly requires its generic contract. First complete the environment+gate, prepare the reference, run the selected observer and resolve its shot/continuity evidence. Then+consult only the installed package vocabulary and the specific craft guidance needed by the observed+systems. Complete examples are for original authoring and variant planning, never reconstruction.+## Login-only fast pathIf the request is only to sign in or authenticate HypiHub (for example, `login to hypit`), treat it as@@ -210,7 +220,9 @@ invalid. Never commit `.env` or copy its secret values into route state, Source,YouTube, Instagram, Bilibili — are the same request; a link is fetched with `yt-dlp` and everythingafter that reads the file. A video with a change attached —this one but with our presenter, our product, our brand — is this route too, and the change is made- on the finished reconstruction. The path is the whole request: the working directory, the project+ on the finished reconstruction. **Do not inspect any `examples/` project on this route; the only+ exception is the generic `examples/minimal-author-package/` fixture after a proven package gap.** The+ reference evidence is the sole source of truth for reconstruction. The path is the whole request: the working directory, the projectlocation and the vocabulary are yours to decide rather than to ask for.- Making a video from a description, brief, topic, script or format name, with nothing to copy →read `references/original-authoring/route.md`. This is the route whatever shape the request takes —diff --git a/skills/hypit/references/reconstruction/route.md b/skills/hypit/references/reconstruction/route.mdindex 02029278..c0712ad2 100644--- a/skills/hypit/references/reconstruction/route.md+++ b/skills/hypit/references/reconstruction/route.md@@ -2,6 +2,13 @@Read a step, do it, read the next one. Each step names the files it needs; read those at that step.+**Evidence-first rule:** This route never reads the repository's `examples/` projects. Do not open their+SVML, SVS, SVRun, README, assets or variants at any stage. The sole exception is the generic+`examples/minimal-author-package/` fixture, and only after a real vocabulary gap is proven and the local+package workflow requires its contract. The reference video and its persisted evidence are the source of+truth; after observation, consult only installed package vocabulary and craft guidance for the observed+systems. Examples belong to original authoring and variant planning, not reconstruction.+## What this route deliversThe complete environment is the hard gate. At route entry, read `../environment.md` completely, then