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