Peter Commit Ops
30 秒简介
用于“把可提交改动变成可收口 PR”。
它聚焦 4 件事：
- 检查是否满足提交前门禁
- 原子化暂存并创建规范 commit
- 推送分支并创建/更新 PR
- 输出可继续交给 CI/PR 收口的状态
适用场景
- 用户提到“帮我 commit”“帮我 push”“创建 PR”
- 已完成
peter-code-review，结论为“可提交”或“可提交（高风险）” - 需要把本地改动接入
peter-ci-gate和peter-pr-ops
执行步骤
- 前置确认：
git status -s
git rev-parse --abbrev-ref HEAD
- 若工作区为空：停止并提示“无可提交改动”。
- 若上一步审查结论是“需修复后提交”：停止并要求先修复问题。
- 若上一步审查结论是“可提交（高风险）”：允许继续，但必须在交接输出中显式标注风险并建议优先执行
peter-ci-gate。
- 分支策略：
git rev-parse --abbrev-ref HEAD
- 若在
main/master：创建并切换特性分支（例如feat/<topic>、fix/<topic>）。 - 若已在特性分支：继续使用当前分支。
- 原子暂存与提交：
git diff --name-only
git add <files>
- 默认只暂存当前任务相关文件，避免混入无关改动。
- 提交前执行（若存在）：
npm run workflow:check
# 若仓库未定义该命令，回退：
# tools/workflow-check.sh --staged 或 scripts/workflow-check --staged
- 提交：
git commit -m "feat: <summary>"
- 提交信息遵循仓库约定：
feat|fix|chore|docs: <简述>。
- 推送与 PR：
git push -u origin <branch>
gh pr create --fill
- 若已存在 PR：改为输出 PR 链接并提示进入 CI gate。
- 若
gh不可用：输出手工创建 PR 的比较链接。
- 交接输出：
- commit SHA
- branch 名称
- PR URL（或阻塞原因）
- 下一步建议：
peter-ci-gate或peter-pr-ops - 若审查为“可提交（高风险）”，必须附：
- 风险摘要（例如
GATE_DB_UNREACHABLE） - 强制建议先执行
peter-ci-gate再考虑合并
- 风险摘要（例如
输出格式（固定）
## 提交与 PR 报告### 前置检查（工作区/分支/门禁）### 执行动作（add/commit/push/pr）### 产出物（SHA、branch、PR）### 结论（已进入 CI 阶段/阻塞）
护栏
- 审查未通过时，不提交。
- 默认不使用
git add .，除非用户明确要求。 - 禁止直接推送到
main/master。 - 推送或建 PR 失败时，必须给出错误摘要与下一步修复建议。