Pebrel 文档

文档 / AI 工作流

隔离 AI 工作目录

为并行任务创建独立 Git worktree,核对目录后分配任务。

为并行任务使用不同目录

两个 AI 工具同时修改同一目录,可能覆盖对方的文件。Git worktree 可以让它们使用同一仓库的不同工作目录与分支。

开始前保存当前文件,在源项目中运行 git status。先提交或妥善保存未提交改动,再创建新的工作目录。

使用 Pebrel 创建命名 Agent

在本地 Pebrel 终端中运行:

pebrel pane list
pebrel ctl describe --pretty

确认源窗格的 ID、所属窗口及当前运行时支持的 Agent 能力。假设窗口为 1、源窗格为 17,且 Codex 已安装:

pebrel ctl agent-fork --window 1 --source-pane 17 --name docs-review --kind codex --pretty

把数字换成自己的列表结果。成功后,响应会给出创建的 worktree 和 Agent 信息,终端将在新目录中启动相应工具。

默认分支形如 pebrel/docs-review,工作目录位于主仓库旁的 <仓库名>-worktrees/docs-review。同名分支或目录已经存在时,改用新的任务名称,或先确认旧任务已不再使用。

核对目录再发任务

读取新 Agent:

pebrel ctl agent-get --agent docs-review --pretty

检查返回的目录与分支,再发送一项任务:

pebrel agent send docs-review "检查安装文档中的路径示例,列出需要修改的位置" --wait
pebrel agent read docs-review --lines 80

任务完成后,进入这个 worktree 查看 git diff并运行相关检查。再按项目的 Git 工作流程提交和合并。

只需要手动建立 worktree

也可以使用 Git 自带命令。在源仓库目录中运行下面的示例,再新建终端进入新目录:

git worktree add ../my-project-docs -b docs/review

该命令会创建一个新分支和目录。检查成功后,在新终端中进入 ../my-project-docs,启动已安装的 AI CLI。

SSH 上的项目

Pebrel 的本机 Agent worktree 创建入口不替远端 SSH 会话建立工作目录。需要在服务器上隔离任务时,在服务器终端中使用它的 Git 命令,并选择服务器可写路径。

完成后清理

确认所有修改已提交或保存,并退出使用该目录的工具。先运行 git worktree list核对目录,再用 git worktree remove 实际目录移除不再使用的工作副本。

不要直接删除仍有未提交改动的目录。对话分叉只复制会话上下文,需要文件隔离时仍按本页建立 worktree。

关于本页

内容来自用户指南 PR #291,原始基线 v2.1.1。部分功能和界面可能随版本变化,请同时参考发行说明。

Markdown 原文 ↓发行说明 ↗
核对来源

搜索文档

输入关键词,搜索使用指南。

本地全文搜索 PAGEFIND / 不上传搜索内容