peter-commit-ops

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