文档 / 指南

连接你的 Agent 应用

把 MiniCut 技能和它的允许规则、先问规则加到你的编程 Agent 应用里，再检查应用是否已经有了它们。

MiniCut 支持 11 个编程 Agent 应用：10 个有技能文件夹，WorkBuddy 通过上传。你用的每一个都要做一遍。用 Agent 安装里的安装提示词已经加了技能并运行了 minicut agent-rules。想以后再加一个应用，或者修复一个，就用这一页。

这里的每条命令都要求已经安装 MiniCut。minicut install-skill 和 minicut agent-rules 在没有登录的电脑上也能用。

检查哪些应用已有技能

运行这条命令：

Terminal

minicut install-skill --status

它会列出主文件夹在这台电脑上的每一个 Agent 应用。每一行要么写 installed 和技能文件夹，要么写 not installed 和要运行的命令。

如果要给脚本用，加 --json。它会打印下表中的每个应用，带 found、installed 和 path。这台电脑上没有任何 Agent 应用时，--status --json 打印 JSON；不加 --json 则打印这一行：No agent app home folder found under 加上你的主文件夹。

给一个应用加技能

从表里选应用。id 就是 --app 的值。

应用	id	你的主文件夹里的技能文件夹
Claude Code	`claude-code`	`.claude/skills`
Codex	`codex`	`.agents/skills`
OpenCode	`opencode`	`.agents/skills`
CodeBuddy Code	`codebuddy`	`.codebuddy/skills`
TRAE	`trae`	`.trae-cn/skills`
Qoder 和 Qoder CN	`qoder`	`.qoder/skills`
Qwen Code	`qwen`	`.qwen/skills`
Kimi Code	`kimi`	`.agents/skills`
Cursor	`cursor`	`.agents/skills`
Cline	`cline`	`.cline/skills`
WorkBuddy	`workbuddy`	没有，它通过上传加载技能

用这个 id 运行命令：

Terminal

minicut install-skill --app claude-code

如果应用开着，重启它，让它加载技能。

命令会把技能复制到技能文件夹里一个叫 miniharness-short-drama 的文件夹。如果那个文件夹里是你自己早先的一份副本，加 --force 来替换它。如果里面是另一个技能，命令不会碰它。

有几个应用共用 .agents/skills，在那里放一份就够它们全部用。

对 WorkBuddy，minicut install-skill --app workbuddy 会打印生成 ZIP 文件的命令。把那个 ZIP 上传到 WorkBuddy 的技能 > 添加技能 > 上传技能。

给这台电脑上的每个应用加技能

运行这条命令：

Terminal

minicut install-skill --all-found

Output

Claude Code: skill written to ~/.claude/skills/miniharness-short-drama. Restart Claude Code if it is open, so it loads the skill.
Codex: skill written to ~/.agents/skills/miniharness-short-drama. Restart Codex if it is open, so it loads the skill.
Claude Code: added the loop hooks (Stop, PreToolUse) to ~/.claude/settings.json
Codex: added the loop hooks (Stop, PreToolUse) to ~/.codex/hooks.json
Codex: open Codex and type /hooks once to trust the two MiniCut hooks; until then Codex skips them.

重启每一个开着的应用。
在 Codex 里，打开 Codex，输入一次 /hooks，信任那两个 MiniCut 钩子。在你信任之前，Codex 会跳过它们。

Claude Code 和 Codex 的钩子

对 Claude Code 和 Codex，安装会在技能旁边加两个钩子。它们让你的 Agent 留在检查和环节里：

钩子	运行	作用
Stop	`minicut loop guard --hook`	环节做到一半，或项目里还有任务在运行，或真实的视频版本在等视频环节时，让你的 Agent 回去继续工作
写文件或运行命令之前	`minicut loop guard --pre-tool`	拒绝直接写这一集的时间线，并说出应该用哪条 `minicut timeline` 命令

Claude Code 把钩子放在 ~/.claude/settings.json，Codex 放在 ~/.codex/hooks.json。安装会把它们和你其他的钩子合并，运行第二次不会改变任何东西。OpenCode 没有 stop 钩子，所以它没有环节守卫。技能会告诉它的 Agent 改为运行 minicut loop next。

给 Claude Code 和 Codex 加规则

运行这条命令：

Terminal

minicut agent-rules

Output

Claude Code: added to ~/.claude/settings.json:
  permissions.allow: Bash(~/.minicut/bin/minicut *)
  permissions.ask: Bash(~/.minicut/bin/minicut uninstall*)
  permissions.ask: Bash(~/.minicut/bin/minicut * --yes*)
  sandbox.excludedCommands: ~/.minicut/bin/minicut *
Codex: added to ~/.codex/rules/default.rules:
  prefix_rule(pattern=["~/.minicut/bin/minicut"], decision="allow")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "uninstall"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "gen"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "board", "run"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "check", "8"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "write"], decision="prompt")
  Codex reads its rules when it starts: restart Codex to use them.

如果 Codex 开着，重启它。

命令为它找到的每个应用写一处修改，里面用这台电脑上 minicut 的完整路径。文件里已有的内容它都保留，同一条规则从不写两次。再运行一次，它会打印 already has every Minicut rule. Nothing changed.

应用	文件	不用问就运行	先问
Claude Code	`~/.claude/settings.json`	每一条 `minicut` 命令	`uninstall`，以及任何带 `--yes` 的命令
Codex	`~/.codex/rules/default.rules`	每一条 `minicut` 命令	`uninstall`、`gen`、`board run`、`check 8` 和 `write`

在 macOS 和 Linux 上，Claude Code 的规则还会把 minicut 列为在应用沙盒之外运行的命令。

想看规则但不写入，加 --dry-run。只给一个应用写，加 --app claude-code 或 --app codex。加 --json 得到一个 JSON 对象。

检查是否成功

再运行一次 minicut install-skill --status。

Output

Claude Code: installed, ~/.claude/skills/miniharness-short-drama
Codex: installed, ~/.agents/skills/miniharness-short-drama

错误

信息	怎么做
`unknown app "<app>". Apps:` 和一个列表	用上面表里的 id。退出码 2
`<folder> already exists. Add --force to copy the pack over it.`	加 `--force` 替换早先的副本
`<folder> exists and is not this skill ... Not touching it.`	把那个文件夹移走或改名，再运行命令
`No agent app home folder found under <folder>. Nothing written.`	先启动一次应用，让它建出自己的主文件夹，或者用 `--app`
`agent-rules writes rules for claude-code and codex only. Got: <app>`	用 `--app claude-code` 或 `--app codex`，或者不写 `--app`
`<file> is not valid JSON (...), so it was not changed. Add these by hand:`	修好这个文件，或者手动加上命令打印的那几行
以 `这一行需要你自己运行：` 开头的一行	你的 Agent 应用的沙盒挡住了写入。这行字的意思就是“这一行需要你自己运行”。在你自己的终端里运行它后面的那条命令

下一步

做预览片检查和环节概览