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
docs: complete skill route architecture
rpone2c91cac3404d
diff --git a/docs/guide/skill.md b/docs/guide/skill.mdindex 0e331f34..44b3f963 100644--- a/docs/guide/skill.md+++ b/docs/guide/skill.md@@ -201,6 +201,13 @@ spending. `hypit build` is submitted only after explicit cost approval.### `original-authoring` (original authoring)+#### Route entry and prerequisites++1. Select the Distribution, project root and Runtime Profile, then create `route_state`.+2. Before inspecting examples or freezing the brief, check the `hypihub.default` credential. If the writable HypiHub OS credential is missing, explain that OAuth avoids copying an API key and run `hypit auth login hypihub.default --runtime hypit.runtime.json`; an account without an active subscription can purchase one at hypit.ai.+3. Run `hypit runtime up` and confirm WhisperX and every other selected program are healthy. Do not enter brief, vocabulary or Source work before this gate is complete.+4. When vocabulary inspection proves a real gap, pause Source authoring and enter the project-package branch: create `packages/<slug>/`, write `package.json` and activation first, then implement the Manifest, Types, Producers, Validators, Surface/decoder, Fragment, README and preview. Install, import and pass `validate_local_author_packages`, `preview_check` and `layout_check` before returning to this route.+```textenvironment → brief-frozen → examples/format/craft decisions→ vocabulary/component-fit → Script and four sources → source-authored@@ -229,6 +236,12 @@ edge needed by the Film. It has no reference video, so `brief.json` is the autho### `reconstruction` (reconstruction)+#### Route entry and prerequisites++1. Select the project, Runtime Profile and observer and create `route_state`; do not inspect or copy the reference before the environment gate.+2. 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.+```textenvironment → reference-prepared → reference-observed→ examples/format/craft decisions → vocabulary/component-fit@@ -284,6 +297,12 @@ before any paid generation is possible.### `revision` (revision)+#### Route entry and prerequisites++1. Locate the canonical Run, read and reconcile its state, and restore its Runtime Profile and credentials; never infer the baseline from chat memory.+2. A source-only revision still requires a resolvable Runtime Profile. If the change will trigger paid generation, confirm HypiHub OAuth first and run `hypit auth login` when missing rather than deferring login until Build.+3. If the change exposes a component gap, enter the project-package branch and complete the package plus Run-scoped validation before continuing Revision; change runtime or package only when capability truly changes.+Revision can start from a directly supplied completed project, a reconstruction, an original project,an earlier revision or one completed variant:@@ -309,6 +328,12 @@ reference comparison; Studio is only a display handoff after deterministic check### `variant-expansion` (variant expansion)+#### Route entry and prerequisites++1. The main agent reconciles the base project and confirms its final gates and Runtime Profile; every child inherits that settled environment.+2. If the batch will perform paid generation, check HypiHub OAuth first; when missing, explain and run `hypit auth login`, then `hypit runtime up`. Child agents do not repeatedly ask for login and may not bypass the environment gate with a credentialless path.+3. Every new package is completed once in staging: `package.json`, activation, Manifest, Types, Producers, Validators, Surface/decoder, Fragment, README and preview, plus package/graph/preview/layout validation. Freeze its digest before injecting it into children.+The main agent makes global decisions before any child agent starts:```textdiff --git a/docs/zh/guide/skill.md b/docs/zh/guide/skill.mdindex c055a655..01ed1617 100644--- a/docs/zh/guide/skill.md+++ b/docs/zh/guide/skill.md@@ -171,6 +171,13 @@ Studio 打开当前 Run。Studio 确认是付费前对结构的人工确认,### `original-authoring`(原创制作)+#### 路径入口与前置++1. 选择 Distribution、项目根目录和 Runtime Profile,建立 `route_state`。+2. 在检查 examples 或写 brief 前,检查 `hypihub.default` 的凭据。没有可写的 HypiHub OS 凭据时,说明 OAuth 不需要复制 API key,并由 agent 执行 `hypit auth login hypihub.default --runtime hypit.runtime.json`;无有效订阅的账号可在 hypit.ai 购买。+3. 运行 `hypit runtime up`,确认 WhisperX 和 Runtime Profile 中的其他程序健康;环境未完成时不能进入 brief、词汇或 Source 阶段。+4. 组件出现真实词汇缺口时,暂停写 Source,转入“项目本地包”分支:在项目 `packages/<slug>/` 创建包,先写 `package.json` 与 activation,再完成 Manifest、Types、Producers、Validators、Surface/decoder、Fragment、README 和 preview;安装、导入并通过 `validate_local_author_packages`、`preview_check`、`layout_check` 后,才能回到本路线。+```textenvironment → brief-frozen → examples/格式/craft 决策→ vocabulary/component-fit → package-ready → Script 与四个源文件@@ -197,6 +204,12 @@ environment → brief-frozen → examples/格式/craft 决策### `reconstruction`(复刻)+#### 路径入口与前置++1. 先选择项目、Runtime Profile 和 observer,并建立 `route_state`;不要先读取或复制参考视频。+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),不能修改安装包或直接复制参考素材。+```textenvironment → reference-prepared → reference-observed→ examples/格式/craft 决策 → vocabulary/component-fit → package-ready@@ -248,6 +261,12 @@ environment → reference-prepared → reference-observed### `revision`(修改)+#### 路径入口与前置++1. 先定位 canonical Run,读取并 reconcile 现有状态;恢复该项目的 Runtime Profile 和凭据,不从聊天记录推断基线。+2. 普通 Source/Recipe 修改也要保证 Runtime Profile 可解析;若修改会触发付费生成,先确认 HypiHub OAuth 已登录,缺失时由 agent 执行 `hypit auth login`,不能把登录推迟到 Build 前。+3. 如果修改暴露了组件能力缺口,先切到项目本地包分支完成完整包和 Run 级验证,再继续 Revision;只有能力确实变化时才修改 runtime 或 package。+Revision 可直接接收完成项目,也可接收复刻、原创、旧 Revision 或完成变体:```text@@ -271,6 +290,12 @@ Revision 不调用 VLM 或参考比对;Studio 只是确定性检查通过后### `variant-expansion`(变体扩展)+#### 路径入口与前置++1. 主 agent 先 reconcile 母项目,确认最终门禁和 Runtime Profile;所有子项目继承这个已确认的环境。+2. 批次需要付费生成时,先检查 HypiHub OAuth;缺失时由 agent 说明并执行 `hypit auth login`,再运行 `hypit runtime up`。不要让每个子 agent 重复询问登录,也不能用无凭据路径绕过环境门禁。+3. 新包必须在 staging 中单独完成:`package.json`、activation、Manifest、Types、Producers、Validators、Surface/decoder、Fragment、README、preview,以及包/graph/preview/layout 验证;冻结 digest 后才能注入子项目。+主 agent 在任何子 agent 启动前完成全局决策:```text