步骤和环节
一集要经过 5 个环节。每个环节做出一部分、检查它、修好没通过的，最多 3 轮就停下。
一个步骤是一项有自己文件和自己检查的工作，比如这一集的剧本或镜头提示词。一个环节把做出这一集某一部分所需的步骤放在一起。它先做出这一部分，在你的电脑上检查，修好没通过的，再检查一遍。这一部分通过，或者环节到了轮数上限，你的 Agent 就停下，把结果给你看。
环节
你的 Agent 按这个顺序运行各个环节。这个顺序只是建议：乱序运行一个环节，会打印一条警告，然后照样运行。
| 环节 | CLI 里的名字 | 你要看什么 |
|---|---|---|
| 剧本 | script | 这一集的剧本，script.md |
| 分镜表 | sheet | 分镜表 |
| 预览片 | mock | 预览片的图片表和它的视频，在应用的 剪辑 标签页里 |
| 视频 | videos | 为每个镜头选出的视频版本 |
| 剪辑 | edit | 剪辑好的成片，在应用的 剪辑 标签页里 |
每个环节做什么，见概览。minicut loop 显示每个环节进行到哪里，minicut loop next 打印下一条要运行的命令。
轮
运行一个环节一次，就是一轮。这一轮检查环节的文件，并把结果存进这一集文件夹里的 loops.json。如果一轮发现问题，每个问题打印一行 FAIL，修法写在它下面。你的 Agent 做出修改，再运行这个环节。
一轮什么问题都没发现，就打印 PASSED。环节接着等你点头。你看过它做出的东西，你的 Agent 用 minicut loop approve 记下你的回答。
在剧本、分镜表和预览片环节里，缺少文件会让运行停下。它列出缺了什么，以退出码 3 结束，并且不占用一轮。
上限
一个环节在固定的轮数之后停下，所以修不好的问题不会无限重复。
| 环节 | 上限数的是 | 默认 |
|---|---|---|
| 剧本、分镜表、预览片、剪辑 | 轮 | 3 |
| 视频 | 一个镜头的视频版本 | 3 |
要改上限，在 series.json 里加 "loops"，例如 "loops": {"mock": 4, "takes": 5}。视频环节的键是 takes。minicut loop run 也接受 --max。见 minicut loop。
环节失败时
没到上限时，你的 Agent 修好那一轮打印的问题，再运行这个环节。如果在一轮失败之后你改了某个文件，minicut loop next 会让你的 Agent 再运行一次这个环节。
到了上限，环节打印 CAP REACHED，你的 Agent 停下，把还没通过的地方给你看。由你决定：
- 用
minicut loop approve原样通过。 - 用
minicut loop done结束这个环节，并写明原因。 - 提高上限，让你的 Agent 再试。
在视频环节里，只重做失败的那个镜头。到了一个镜头的上限，你的 Agent 选出最好的版本，并告诉你它还有什么问题。不会有任何东西替你保存那个版本。
有改动时
一个已通过的环节，在它所用的文件改变之后就过期了。minicut loop 这时显示 out of date, re-run suggested。你也可以用 minicut loop stop-at 让各环节只运行到某一个环节，或者用 minicut loop pause 让它们安静下来。
Claude Code 和 Codex 有一个由 minicut install-skill 加上的停止钩子。它运行 minicut loop guard。环节正在一轮中间，或者项目还有任务在运行时，它会让 Agent 回去继续工作。视频版本在等视频环节时，它也会拦住 Agent。