Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

docs: complete skill route architecture

rpone2c91cac3404d
diff --git a/docs/guide/skill.md b/docs/guide/skill.md
index 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.
+
```text
environment → 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.
+
```text
environment → 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:
```text
diff --git a/docs/zh/guide/skill.md b/docs/zh/guide/skill.md
index 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` 后,才能回到本路线。
+
```text
environment → 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),不能修改安装包或直接复制参考素材。
+
```text
environment → 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