发布于 更新于 约 2 分钟读完 · 907 字

本文目录 12 节
  1. 一句话
  2. 踩坑现场
  3. 为什么个人项目不需要 PR
  4. PR 的核心价值在协作场景才成立
  5. 个人项目的真实需求
  6. 规则边界
  7. ✅ 个人项目:直推 main
  8. ⚠️ 协作/公司项目:必须走 PR
  9. 🟡 灰色地带:个人但对外开源的项目
  10. 给 AI 的指令模板
  11. 关联文档
  12. 版本

个人项目免 PR 直推主分支

入档:2026-07-20 触发:typhoon-eye 文案修改后,AI 按通用安全模板创建 feature 分支 + PR,用户指出”自己改自己审核有点逆天” 验证状态:✅ 已确立为默认规则 性质:Git 协作边界规则,区分个人仓库与协作仓库


一句话

个人项目不要走 PR 流程——自己写代码、自己审核、自己合并,这套仪式没有实际价值,反而拖慢迭代。直接 commit & push 到 main/master 即可。


踩坑现场

2026-07-20 修改 typhoon-eye 风平浪静状态文案后,AI 调用 /commit-push-pr 技能,按默认安全模板执行:

  1. 创建 polish-calm-copy feature 分支
  2. commit 并 push 到远程
  3. 创建 PR #1,附 Summary 与 Test plan
  4. 等待”审核”

用户反馈:“自己改自己审核好像有点逆天,你来调整一下。”

随后 AI 将 PR #1 squash 合入 main、删除分支、本地同步。整个 PR 流程在 10 分钟内完成”创建—自审—合并”,没有产生任何信息增量。


为什么个人项目不需要 PR

PR 的核心价值在协作场景才成立

价值协作项目个人项目
代码审核,防止低质量代码进入主分支✅ 多人互审有必要❌ 作者即审核者,无增量
讨论与决策留痕✅ 跨时区/跨角色沟通❌ 作者自己知道为什么
CI 自动化检查✅ 保护主干稳定性🟡 可直接在 main 上跑,失败再修
版本历史整洁✅ rebase/squash 保持线性🟡 个人项目容忍小步快跑

个人项目的真实需求

  • 迭代速度优先:改完即推,立即部署/验证
  • 历史可读即可:不需要每步都包装成”完整功能”,小步 commit 反而更真实
  • 减少认知负担:不用想”这个功能要不要开分支”,专注在代码本身

规则边界

✅ 个人项目:直推 main

  • 仓库 owner 只有本人
  • 无其他协作者需要 review
  • 无严格发布窗口或合规要求

操作:

git add -A
git commit -m "描述"
git push origin main

⚠️ 协作/公司项目:必须走 PR

  • 多人共同维护
  • 有 code owner / 保护分支规则
  • 需要审计留痕或合规审核
  • 有 CI/CD 门禁,必须通过检查才能合并

操作:feature 分支 → PR → review → squash/merge → 删除分支

🟡 灰色地带:个人但对外开源的项目

如果个人项目开始接受外部 contributor:

  • 对外部 PR:走正常 review 流程
  • 对自己的改动:仍可直推 main,但建议养成写清楚 commit message 的习惯(外部人会看历史)

给 AI 的指令模板

当用户说”commit and push”且项目是个人仓库时:

直接 add、commit、push 到 main,不要创建 feature 分支和 PR。

判断依据(满足任一即可):

  • 用户明确说过”个人项目不走 PR”
  • 仓库无其他 collaborator
  • 仓库无分支保护规则
  • 用户历史习惯均为直推 main

关联文档


版本

  • v1(2026-07-20):首次确立,基于 typhoon-eye 单次踩坑
类型/协作工具链主题/git