Spec-First

git-commit-push-pr ​

从本地改动走到 commit、push 和 PR，或仅生成 / 更新 PR 描述。

基本信息 ​

字段内容
Skillgit-commit-push-pr
类型internal-only
研发链路位置Review
入口internal_only
Sourceskills/git-commit-push-pr/SKILL.md

描述 ​

Commit, push, and open a PR with an adaptive, value-first description. Use when the user says "commit and PR", "push and open a PR", "ship this", "create a PR", "open a pull request", "commit push PR", or wants to go from working changes to an open pull request in one step. Also use when the user says "update the PR description", "refresh the PR description", "freshen the PR", "rewrite the PR body", "write a PR description", "draft a PR description", or "describe this PR" — the skill will produce a description without committing or pushing if that is all the user wants. Produces PR descriptions that scale in depth with the complexity of the change, avoiding cookie-cutter templates.

何时使用 ​

  • 用户要求创建 PR。
  • 需要刷新 PR body 或描述当前 diff。
  • 准备把已验证变更交给 reviewer。

工作步骤 ​

  • 读取 diff、PR、文档、计划、task pack 或专项审查输入。
  • 按风险域选择 always-on 与 conditional reviewer personas。
  • 合并、去重和校准 findings，区分 safe_auto、gated_auto、manual 和 advisory。
  • 输出修复、残留风险或下一步处理建议。

输出 ​

  • review findings、safe_auto fixes、residual risks、audit report 或 release checklist。
  • 当 reviewer dispatch 不可用时，输出明确的 report-only fallback 覆盖说明。

Agent 调度 ​

  • 这是 persona agents 的主要使用层：correctness、testing、security、performance、scope、design 等按证据触发。
  • review workflow 自身负责任务边界、合成和最终判断。

边界 ​

  • 不替代代码 review。
  • 不应在未验证或 scope 不清时直接 push。