参数	说明
`--title "xxx"`	PR 标题。省略时从最新 commit message 第一行提取
`--body "xxx"`	PR 正文。省略时从 commit body 提取，或自动生成 diff --stat 摘要
`--base main`	目标分支，默认 `main`
`--draft`	创建为 Draft PR

用法示例

# 基本用法：从最新 commit 自动提取标题和正文
bash ~/.claude/skills/pr-worktree/pr-worktree.sh

# 指定标题和正文
bash ~/.claude/skills/pr-worktree/pr-worktree.sh --title "feat: add dark mode" --body "支持暗色主题切换"

# 创建 Draft PR
bash ~/.claude/skills/pr-worktree/pr-worktree.sh --draft

# 指定目标分支为 develop
bash ~/.claude/skills/pr-worktree/pr-worktree.sh --base develop

脚本行为

检查当前分支和 gh CLI 状态
检查是否有未提交变更（有则报错退出）
git push -u origin <branch>，失败时自动 git pull --no-ff 后重试
查找已有 PR：gh pr list --head <branch>
已有 PR → 更新标题和正文（gh pr edit）
无 PR → 创建新 PR（gh pr create）
输出 PR 编号和 URL

输出

创建新 PR：

当前分支: feat/new-feature

=== 推送到远程 ===

=== 检查已有 PR ===
未找到已有 PR，创建新 PR...

============================================
PR 已创建!
  PR: #42
  URL: https://github.com/xxx/pull/42
============================================

更新已有 PR：

当前分支: feat/new-feature

=== 推送到远程 ===

=== 检查已有 PR ===
已有 PR #42 (状态: OPEN)，更新中...

============================================
PR 已更新!
  PR: #42
  URL: https://github.com/xxx/pull/42
============================================

错误场景

输出	原因	解决
`Warning: 有未提交的变更`	git add 后未 commit	先提交变更
`Error: gh CLI 未安装`	未安装 GitHub CLI	`brew install gh`
`Error: gh CLI 未登录`	gh 未认证	`gh auth login`
`pull 失败`	push 被拒且 pull 有冲突	手动解决冲突后重试

GitHub 合并策略约定

本项目要求 GitHub PR 使用 Create a merge commit 合并：

PR 合并后，feature 分支的完整提交历史会保留在 main 中
确保 git branch --merged main、git cherry 等本地命令能正确追踪已合并分支
如仓库未配置，需前往 Settings → General → Pull Requests 开启 "Allow merge commits"，关闭 Squash 和 Rebase

AI 操作步骤（重要：先验证，再推送 PR）

评估工作量：查看变更文件数和行数
- 简单（<10 文件）：直接执行
- 中等（10-30 文件）：按功能分组 commit
- 复杂（>30 文件）：建议先用 code-review-worktree 审查
检查变更内容，排除敏感信息
让用户提供 commit message，或使用 zcommit skill 自动生成
git add -A && git commit -m "<message>"

本地验证（push 前必须执行）：

优先使用 merge-worktree 的 pre-merge-check.sh（自动检测 monorepo/workspace，覆盖所有子包的 tsc/lint/test/build）：

# 如果项目有 merge-worktree skill，直接用它的完整验证脚本
if [ -f ~/.pi/agent/skills/merge-worktree/pre-merge-check.sh ]; then
  bash ~/.pi/agent/skills/merge-worktree/pre-merge-check.sh
fi

如果 pre-merge-check.sh 不可用，手动运行以下检查，任何一项失败都必须修复后才能 push：

# Monorepo/workspace 项目：先构建被依赖的包（如 core）
npm run build -w core 2>&1  # 如果有 workspace 子包被其他包依赖

# 逐包 TypeScript 类型检查
for pkg in core router frontend pi-extension; do
  npx tsc --noEmit -w $pkg 2>&1
  # 如果失败 → 修复 → 重新检查直到通过
done

# Lint 检查
npx eslint . --max-warnings 0 2>&1 || npm run lint 2>&1
# 如果失败 → 修复 → 重新检查直到通过

# 单元测试
npm test 2>&1 || npx vitest run 2>&1
# 如果失败 → 修复 → 重新检查直到全部通过

# 构建检查
npm run build 2>&1 || true

规则：

所有 workspace 子包的 tsc 必须 0 error
lint 必须 0 error 0 warning
测试必须全部通过
修复后重新运行确认通过，再继续
包括非本次修改的子包（如 pi-extension）也必须通过

运行脚本创建 PR：

bash ~/.claude/skills/pr-worktree/pr-worktree.sh [--draft]

确认输出包含 "PR 已创建!" 或 "PR 已更新!"
（可选）检查 PR 的 CI 状态：创建 PR 后，确认 Actions 已触发并初始状态正常
```
gh pr view --json statusCheckRollup --jq '[.statusCheckRollup[] | .name + ": " + (.conclusion // "pending")] | .[]'
```
如果有 check 立即失败（非 pending/queued），应分析原因并修复

pr-worktree

PR Worktree

脚本

参数