# 连接你的 Agent 应用

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

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

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

## 检查哪些应用已有技能

1. 运行这条命令：

```bash Terminal
minicut install-skill --status
```

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

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

## 给一个应用加技能

1. 从表里选应用。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` | 没有，它通过上传加载技能 |

2. 用这个 id 运行命令：

```bash Terminal
minicut install-skill --app claude-code
```

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

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

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

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

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

1. 运行这条命令：

```bash Terminal
minicut install-skill --all-found
```

```text 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.
```

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

## Claude Code 和 Codex 的钩子

对 Claude Code 和 Codex，安装会在技能旁边加两个钩子。它们让你的 Agent 留在[检查和环节](/zh-cn/docs/cli/checks-and-loops)里：

| 钩子 | 运行 | 作用 |
|---|---|---|
| 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 加规则

1. 运行这条命令：

```bash Terminal
minicut agent-rules
```

```text 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.
```

2. 如果 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`。

```text 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 应用的沙盒挡住了写入。这行字的意思就是“这一行需要你自己运行”。在你自己的终端里运行它后面的那条命令 |

## 下一步

[做预览片](/zh-cn/docs/cli/make-the-mock) [检查和环节](/zh-cn/docs/cli/checks-and-loops) [概览](/zh-cn/docs/cli/overview)